Controls reference | Tidy Docs

Main panel

Control	Action
Project or the folder name	Takes the scope from the Project panel selection. See folder scope.
X beside a folder scope	Returns to the whole project.
Scan or the health ring	Runs a read-only scan of the current scope. Click again to rescan.
Left icon on the first five rows	Toggles that category’s inclusion in Tidy all. The accent color means included.
Category name or count	Opens the category’s list.
Right action icon	Acts on that category, independently of whether it is included in Tidy all.
Tidy all	Runs the included cleanup categories that currently have findings.

Category actions

Row	Right action	Result
Unsorted	Wand, Sort into type folders	Moves items into their configured folders.
Empty folders	Wand, Delete empty folders	Removes empty folder trees.
Unused	Wand, Remove unused footage and solids · Alt also removes unused comps	Removes eligible unused project items.
Duplicates	Wand, Merge duplicate footage and solids	Replaces references with a surviving source and removes duplicates.
Missing	Folder search, Relink from a folder…	Opens a folder chooser and immediately relinks matches from the chosen folder.
Fonts	Target, Show the next layer with a missing font	Opens a comp and selects the next affected text layer.
Naming	Pencil, Select default-named comps for Renamer	Selects the reported comps in the Project panel.

The findings reference defines what qualifies for each row.

Lists

Control or state	Meaning
Back arrow	Closes the list. Escape also closes it.
Action at the top right	Runs the same category action as the main panel.
Item name	Replaces the Project panel selection with that item. In Fonts, it opens and selects the first stored layer for that font.
Remove unused comps in Unused	Changes the saved setting with the same name. Rescan after changing it.
Folder to search… in Missing	A search path. Subfolders are included, and `~` means your home folder.
Folder icon beside the search path	Chooses a folder and immediately relinks from it.
Link icon beside the search path	Relinks from the entered path. Enter in the field does the same.
Comp · kept, dimmed	An unused comp that the current report will keep.
Crossed-out item	Cleared by a cleanup. It stays visible until you close and reopen the list.
+N more	More findings exist than the list can display. See scan limits.

Selecting a list item does not restrict the cleanup to that item. Category actions process all eligible findings in the current scope.

Before scanning, an open list says Scan to see what is here. After scanning, a list with no entries shows its category’s empty message.

List	Empty message
Unsorted	No unsorted items
Empty folders	No empty folders
Unused	No unused items
Duplicates	No duplicates
Missing	No missing files
Fonts	No missing fonts
Naming	No default comp names

Modifiers

Gesture	Effect
Cmd-click or Ctrl-click a fixable category’s name or count	Toggles its inclusion in Tidy all, without opening the list.
Alt-click an active Unused wand	Includes unused comps for this action without changing the saved setting. For a disabled wand, use the comp-removal toggle.
Alt-click or right-click the scope control	Returns to the whole project.
Escape with a list open	Closes the list.

On macOS, use Option for Alt. Shift adds no special action.

Tidy all

Review a list, go back, then click its left icon to include or exclude that category. This choice is saved.

By default, Unsorted, Empty folders, Unused, Duplicates, and Missing are all included. Fonts and Naming are report-only categories.

Missing only runs as part of Tidy all when a search path has already been entered or chosen in this panel session. Tidy all does not open a folder chooser. It uses the saved Remove unused comps setting; holding Alt on Tidy all adds no comp-removal override.

The cleanup order is relink, merge duplicates, remove unused items, sort, then remove empty folders. Each category checks the project again when it runs. The combined action is one undo step.

Feedback and refresh

Before a scan, counts show dashes and cleanup actions are inactive. After scanning, a checkmark means that category has no counted findings. Its right action is inactive, but its list can still open. Counts above 999 display as 999+.

A cleanup rescans automatically and briefly shows how many items it handled. A toast reports sorted, removed, merged, or relinked totals and any locked layers skipped. The ring fills as the score improves and sparkles when it reaches 100.

The Fonts badge shows the current layer’s position in the reveal cycle. Naming shows how many comps were selected. If Tidy cannot find Renamer in the dock, its toast says Selected N comps · rename them in Renamer.

Rescan after an undo, a manual project edit, changing settings, or switching projects. Tidy does not continuously watch the project. Changing scope clears the old report and requires a new scan.

Resizing Tidy

A narrow, tall slot keeps the ring above the findings. The default added slot uses full width; Tidy also supports a half-width slot.

In Edit layout, drag the slot's resize handle to change its shape.

Tidy in a 260 by 380 pixel slot, with the ring above all seven labeled rows.

A wide slot puts the ring beside the findings. Shorter slots shrink the ring and may turn the rows into icon tiles. Labels disappear as space runs out; hover to identify a control.

A short row keeps all seven categories as compact tiles. Their order matches the labeled rows above.

At the smallest short-row sizes, tooltips are suppressed to keep them out of the way. Give Tidy more room when you need labels or help identifying an icon.