48 lines
1.5 KiB
Markdown
48 lines
1.5 KiB
Markdown
# ComfyUI-FaceKeypointsFilter
|
|
|
|
A ComfyUI custom node for selectively filtering face keypoints from DWPose/OpenPose output.
|
|
|
|
## Description
|
|
|
|
This node allows you to disable specific facial parts (jaw, eyebrows, eyes, nose, outer mouth, inner mouth) from OpenPose 68-point face keypoints. This is useful when you want to preserve certain facial features while ignoring others in your ControlNet workflow.
|
|
|
|
## Installation
|
|
|
|
### Using ComfyUI Manager (Recommended)
|
|
|
|
Search for "FaceKeypointsFilter" in ComfyUI Manager and install.
|
|
|
|
### Manual Installation
|
|
|
|
1. Navigate to your ComfyUI's `custom_nodes` folder
|
|
2. Clone this repository:
|
|
```bash
|
|
git clone https://github.com/YOUR_USERNAME/ComfyUI-FaceKeypointsFilter.git
|
|
```
|
|
3. Restart ComfyUI
|
|
|
|
## Usage
|
|
|
|
1. Connect the output of DWPose Preprocessor (or any node that outputs `POSE_KEYPOINT`) to this node
|
|
2. Enable the facial parts you want to **remove** (disable):
|
|
- `remove_jaw`: Jaw contour (points 0-16)
|
|
- `remove_eyebrows`: Eyebrows (points 17-26)
|
|
- `remove_eyes`: Eyes (points 36-47)
|
|
- `remove_nose`: Nose (points 27-35)
|
|
- `remove_mouth_outer`: Outer lip contour (points 48-59)
|
|
- `remove_mouth_inner`: Inner mouth (points 60-67)
|
|
3. Connect the output to your ControlNet Apply node
|
|
|
|
## Node Location
|
|
|
|
`Pose/Face Utils` > `Face Keypoints Filter (OpenPose)`
|
|
|
|
## Compatibility
|
|
|
|
- Works with DWPose Preprocessor from `comfyui_controlnet_aux`
|
|
- Compatible with OpenPose JSON format (version 1.3)
|
|
|
|
## License
|
|
|
|
MIT License
|