# Face Selector

## CLI Arguments

### Face Selector Mode

Use reference based tracking or simple matching.

Argument: `--face-selector-mode`

Default: `reference`

Choices: 

* `many`
* `one`
* `reference`

Example: `--face-selector-mode one`

### Face Selector Order

Specify the order of the detected faces.

Argument: `--face-selector-order`

Default: `large-small`

Choices: 

* `left-right`
* `right-left`
* `top-bottom`
* `bottom-top`
* `small-large`
* `large-small`
* `best-worst`
* `worst-best`

Example: `--face-selector-order left-right`

### Face Selector Age Start

Filter the detected faces based the starting age.

Argument: `--face-selector-age-start`

Default: `None`

Range: `0` to `100` at `1`

Example: `--trim-frame-start 20`

### Face Selector Age End

Filter the detected faces based the ending age.

Argument: `--face-selector-age-end`

Default: `None`

Range: `0` to `100` at `1`

Example: `--trim-frame-end 40`

### Face Selector Gender

Filter the detected faces based on their gender.

Argument: `--face-selector-gender`

Default: `None`

Choices: 

* `male`
* `female`

Example: `--face-selector-gender male`

### Face Selector Race

Filter the detected faces based on their race.

Argument: `--face-selector-race`

Default: `None`

Choices:

* `white`
* `black`
* `latino`
* `asian`
* `indian`
* `arabic`

Example: `--face-selector-gender white`

### Reference Face Position

Specify the position used to create the reference face.

Argument: `--reference-face-position`

Default: `0`

Example: `--reference-face-position 1`

### Reference Face Distance

Specify the similarity between the reference face and target face.

Argument: `--reference-face-distance`

Default: `0.3`

Range: `0` to `1` at `0.05`

Example: `--reference-face-distance 0.6`

### Reference Frame Number

Specify the frame used to create the reference face.

Argument: `--reference-frame-number`

Default: `0`

Example: `--reference-frame-number 100`

## Default Overrides

Modify the `facefusion.ini` file to override the defaults.

```ini
[face_selector]
face_selector_mode = one
face_selector_order = left-right
face_selector_age_start = 20
face_selector_age_end = 40
face_selector_gender = male
face_selector_race = white
reference_face_position = 1
reference_face_distance = 0.6
reference_frame_number = 100
```