Prepare visual search
- Prepare contact-sheet previews for your source.
- Visual indexing follows preview preparation automatically. The status strip shows its progress.
- Use Library → Prepare Visual Search if the index needs updating.
- Let the app process search samples locally. Details provides pause/resume controls. Memory or thermal waits resume automatically; reduced-speed work continues.
If visual search was previously prepared, new or changed clips are analyzed after later preview preparation. Metadata search remains usable without the visual index.
Search for a remembered shot
- Enter a short scene or subject description in the Archive’s unified search field.
- Inspect the strongest results rather than accepting the rank alone.
- Open a Visual or Both result. Playback starts at the clip’s matching sampled moment when the original is available. Metadata results open the overview.
- Use filters to narrow to a source or technical constraint when needed.
The demonstration query a cat returns 15307802_1080_1920_30fps.mp4 with a sampled match at 0:04.56. Your results depend on your footage and its sampled frames.
Limits that affect a search
The index includes twelve overview frames plus additional search samples approximately every five seconds. Brief events between samples may be missed. Closer range-inspection frames are not currently included in the index.
The result’s tooltip exposes raw visual similarity to three decimals. Similarity is a ranking signal, not a confidence percentage. Metadata and visual ranks are combined; results can still appear when no frame strongly matches the description. View the images and watch the relevant original footage before selecting it.
If visual search is unavailable
Check that previews and the visual index are prepared. Missing model resources produce an availability notice. Core image and text encoding run locally; no model API upload is required. Requires Apple Silicon (M1 or later). Intel Macs are not supported. Earlier macOS runtime compatibility remains unverified.
See troubleshooting and searching filenames for an alternative retrieval route.
Long-recording indexing
B-Roll Archives keeps the twelve-frame overview and prepares additional search samples approximately every five seconds. A two-hour clip has about 1,440 sample positions. Work is saved frame by frame and uses one background worker. Memory warnings reduce speed; critical memory pressure temporarily waits and resumes automatically after recovery. Longer recordings primarily require more processing time and local cache storage.
Release testing passed full dense indexing, native pause/relaunch/resume and late-moment retrieval/playback on a supplied 2 h 6 min 1080p H.264 clip. See the long-recording case study for measured memory, timing and hardware. Other long-form codecs, resolutions and lower-memory Macs remain unverified. Sampling can still miss events between frames; it is not exhaustive analysis or scene detection.
Optional Enhanced Search
Version 0.5.0 adds experimental Enhanced Search using EmbeddingGemma 2. It is off by default. Open Enhanced Search in the sidebar or app menu, download the approximately 865 MB model, then use Run comparison to test this Mac on up to 96 cached overview frames. Downloading or testing does not start indexing.
Review the hardware warning before choosing Enable Enhanced Search. The measured reference is an M4 Mac with 24 GB RAM; a computer below that memory configuration or otherwise untested may have a different encoding experience. Enhanced Search requires Apple Silicon and macOS 13.3 or later. Standard Search remains available when Enhanced Search is disabled, unavailable or fails.
Enabling starts a resumable index for the current catalogue. The settings show coverage, recent throughput, estimated active-work time remaining and separate app/helper memory readings. Use Pause indexing or Resume indexing to control work. Use Standard Search disables Enhanced Search while retaining its data. Remove Enhanced index clears only the enhanced index.
Standard and Enhanced results have separate groups and pagination. Search ranking is not a confidence score. Enhanced image encoding is considerably slower than CLIP; large libraries require more indexing time and cache space. Whole-app resource/UI coverage, lower-memory/older-OS computers and complete cold long-video coverage remain unverified. Very large catalogues may also retrieve slowly. This feature does not add audio, PDF, code or sequence search.
