Skip to content

Chapter Clustering

After Head Detection, every face found in a chapter starts as a separate thumbnail. Chapter Clustering sorts those faces into groups so that each character in a chapter has their own cluster.

Process one chapter at a time in the Chapters tab before moving to Characters which is project wide. A character’s appearance can change between chapters due to power-ups, injuries, time skips, or reincarnation. Sorting faces chapter by chapter helps keep these different appearances organized and makes character matching more accurate.

Chapter Clustering workspace with the page viewer on the left, clustered faces in the center, and unassigned faces on the right
The Chapter Clustering workspace: inspect pages, manage face clusters, and organize unassigned faces.
1. Left Panel
Workspace

Preview faces on their source page, switch chapters, and run AI or manual clustering tools.

2. Center Panel
Clustered Faces

View, lock, merge, and organize the character clusters detected in the active chapter.

3. Right Panel
Unassigned Faces

Holds faces that did not match any cluster yet so you can drag them into a group or delete them.


1. Navigate Chapters & Group Faces Automatically

Section titled “1. Navigate Chapters & Group Faces Automatically”

Use the Workspace controller in the left sidebar to move between chapters—click the < and > arrows to step forward or backward, or click the chapter name to pick any chapter from the list.

Workspace Controls sidebar showing chapter navigation arrows and clustering engine buttons
The Workspace controls: navigate chapters and run clustering tools.

From the Clustering Engine section in the workspace, you can perform three main actions:

Auto-Group Chapter

Groups all unlocked faces in the chapter you currently have open.

Group All Chapters

Runs chapter grouping on every chapter in your project, one after another. Each chapter still keeps its own separate clusters.

Create Manual Cluster

Adds an empty named cluster to the active chapter so you can drag faces into it by hand.

  • Where unsure faces go: Any face that does not clearly match a group is placed in Unassigned on the right so you can sort it yourself.
  • Stopping early: You can cancel a run at any time. If you stop while a chapter is still in progress, that chapter reverts cleanly so nothing is left half-sorted.


Because cropped thumbnails can look similar out of context, you can check any face on its original page before moving it.

Canvas preview showing face thumbnails with drag handles for grouping into clusters
The Canvas preview: drag faces to group them into clusters.
  • Inspect in context: Click any face thumbnail in a cluster or in Unassigned to open its source page in the Canvas Preview at the top left, with a box drawn around that face.
  • Move around the page: Scroll to zoom in or out, drag the image to pan, or use -, Reset, and + at the bottom right of the preview.
  • Adjust the highlight: Click the palette icon in the top-right corner of the preview to toggle Auto-Zoom Head (centers on the selected face automatically) or change the box color, thickness, and fill opacity.

Finally, use drag-and-drop, multi-select, and the cluster controls to make your final touches. AI can occasionally split one character into two clusters or leave a side-angle face in Unassigned.

Drag board showing character face thumbnails that can be dragged between Unassigned and cluster groups
The Drag Board: manually group faces by dragging between clusters and Unassigned.
  1. 1
    Drag one face or reorder inside a cluster

    Drag any face thumbnail into another cluster or over to Unassigned. Moving the last face out of a cluster removes the empty cluster automatically.

  2. 2
    Select and move several faces at once

    Hover over thumbnails and tick their corner checkboxes. Drag any checked face to move the entire selection together, or use Put Selected Here inside the destination cluster’s ⋮ menu.

  3. 3
    Group selected faces into a brand-new cluster

    Check faces anywhere (in clusters or Unassigned) and click Cluster Selected in the top toolbar—or New Cluster from Selected in any cluster’s ⋮ menu—to place them into a new standalone cluster.

When a cluster is complete and you do not want it changed again, lock it:

  • Lock one cluster: Open the cluster’s ⋮ menu and click Lock Cluster (click Unlock Cluster anytime to edit it again).
  • Lock or unlock the whole chapter: Use Lock All / Unlock All in the top bar of the center panel.

Each cluster card and the Unassigned panel have a ⋮ menu for quick bulk actions:

Cluster menu showing overflow menu with options to lock, unlock, merge, and delete clusters
The Cluster Menu: lock, unlock, merge, or delete clusters.
Cluster Menu (⋮)
  • Select All in Cluster / Deselect All: Check or uncheck every face in this cluster.
  • Put Selected Here: Move all currently checked faces into this cluster.
  • New Cluster from Selected: Create a new cluster from all checked faces.
  • Remove Selected: Delete only the checked faces inside this cluster.
  • Remove Cluster: Delete this cluster and all faces inside it.
  • Lock / Unlock Cluster: Freeze this cluster against manual edits and future AI runs.
Top Bar & Unassigned Menu (⋮)
  • Lock All / Unlock All (Top Bar): Lock or unlock every cluster in the chapter at once.
  • Cluster Selected (Top Bar): Group all checked faces into a new cluster.
  • Delete Selected (Top Bar): Permanently delete all checked faces currently inside clusters.
  • Unassigned ⋮ → Select All / Deselect All: Check or uncheck every unassigned face.
  • Unassigned ⋮ → Remove Selected: Permanently delete checked unassigned faces.

If AI is merging different characters together or splitting one character into too many small groups, click Advanced under Clustering Engine in the sidebar:

  • Algorithm: Keep OPTICS Best (or OPTICS / HDBSCAN) for automatic grouping. Switch to DBSCAN only if you want to adjust the matching distance manually.
  • Distance (eps) (shown for DBSCAN only): Controls how closely two faces must match (0.05 to 0.50). Lower numbers make matching stricter; higher numbers group more varied angles and expressions together.
  • Min Faces (2 to 10): Sets the minimum number of faces needed to create a cluster. Leave it at 2 to catch minor characters, or raise it so brief background characters stay in Unassigned.