Prepare an existing source
- Connect a footage folder or drive.
- Use Prepare / Rescan when preparation is needed. ⌘R starts preparation or a rescan.
- Let the app discover readable clips and create previews. Completed clips become available while the queue continues.
- Use Pause or ⌘P to stop preparation temporarily. Choose Resume after a pause or interrupted session.
The first pass creates twelve timestamped overview frames per clip. The persistent catalog records preparation progress so valid completed work can be reused.
Understand the Archive
The Archive is the core browsing surface. Use the source sidebar to focus a folder, the search toolbar to find footage, and clip covers to open a contact sheet. A filtered view can show fewer clips than the whole-library sidebar count.
Sources start collapsed. Use a source or folder chevron to reveal its children, or Expand all / Collapse all beside SOURCES. Clicking a name selects its footage; collapsing does not change that selection. A dot marks a collapsed branch containing the selected folder. Expansion choices remain during navigation and rescans; relaunch starts collapsed.
The fixed-height status strip shows scans, preview preparation, visual indexing, full-sheet preparation and PDF export. Known totals show a percentage, with a rounded remaining-time estimate after steady progress. Details lists overlapping work and pause/resume controls. Memory/thermal waits resume automatically; a pause you request needs an explicit resume.
The sidebar also shows Discover, Shotlists, Collections, and Favorites. Shotlists hold ordered clip ranges with shot notes, which you or a connected agent can save. Discover is still in development.
Rescan after changes
Rescan a connected source after adding, changing or removing files. Preparation is incremental and reuses valid completed work. A complete, readable scan revokes access to confirmed removed files, including their cached images and MCP links. A disconnected drive or an incomplete scan is not proof of deletion; see disconnected drives. Continuous live folder watching is not included.
Expected result and limits
Ready clips have cached previews you can browse. A failed file does not establish that the entire source failed; inspect its status and try another readable clip. Requires Apple Silicon (M1 or later); Intel Macs are not supported. Large-library performance and earlier macOS runtime compatibility still need broader verification.
Preparing overview frames and preparing visual search are separate steps. Metadata search works without the visual model.
