Mouth Mesh Extractor (MediaPipe)

Extracts mouth contour from MediaPipe 478-point face mesh. Uses VIDEO mode for temporal tracking + interpolation for dropped frames. Outputs lip-only render (for VACE control) and filled mask (for inpainting).

By Jalen-Brunson·Created 4 months ago·Updated 3 months ago· 1

images

mouth_render
mouth_mask
centroid_x_list
centroid_y_list
fallback_active_list

◄render_modecontour_only►

◄line_colorgreen►

◄line_thickness2►

◄max_faces1►

◄min_confidence0.30►

◄mask_blur5►

◄mask_grow0►

◄person_index0►

◄include_innertrue►

◄include_outertrue►

◄auto_fallbacktrue►

◄fallback_area_threshold0.15►

◄fallback_pad_h1.20►

◄fallback_pad_v1.30►

Categorymask/pose

Inputs (15)

Name	Type	Default	Description
images	IMAGE		—
render_mode	COMBO	contour_only	3 options: contour_only, contour_and_fill, fill_only
line_color	COMBO	green	5 options: green, white, red, cyan, magenta
line_thickness	INT	21–10	Thickness of lip contour lines in pixels.
max_faces	INT	11–10	—
min_confidence	FLOAT	0.300.05–1	Lower = fewer dropped frames but more false positives.
mask_blur	INT	50–100	Gaussian blur for mask edges. 0 = hard edge.
mask_grow	INT	00–200	Dilate mask outward by this many pixels.
person_index	INT	0-1–9	Which face (0=first). -1=all faces merged.
include_inner	BOOLEAN	true	Include inner lip contour (mouth opening edge).
include_outer	BOOLEAN	true	Include outer lip contour (vermilion border).
auto_fallback	BOOLEAN	true	Fallback to elliptical mask when lips collapse (pucker/kiss).
fallback_area_threshold	FLOAT	0.150.01–1	Inner/outer area ratio below which fallback activates.
fallback_pad_h	FLOAT	1.200.5–3	Horizontal scale for fallback ellipse.
fallback_pad_v	FLOAT	1.300.5–3	Vertical scale for fallback ellipse.

Outputs (5)

Name	Type	Description
mouth_render	IMAGE	—
mouth_mask	MASK	—
centroid_x_list	FLOAT	—
centroid_y_list	FLOAT	—
fallback_active_list	BOOLEAN	—