Before you start
Connect the drive and finish copying footage into a stable folder. B-Roll Archives needs permission to read the location. Keep your independent backups; adding a source does not back it up.
Add a source
- Choose Choose Folder or Drive during onboarding, or Add Folder in the Archive. The keyboard shortcut is ⌘O.
- Select the footage folder or drive in the macOS folder chooser.
- Confirm the selection. The source appears in the sidebar.
- Prepare the library to create browsable previews.
The app discovers clips recursively, including footage inside nested folders. Current discovery includes MP4, MOV, and M4V files. Actual readability depends on macOS media support; a file extension alone does not guarantee decoding. Check the file-format compatibility guide for confirmed combinations, unverified formats and files v0 does not scan.
Expected result
Your originals remain in their existing locations. The source becomes part of the local catalog, and readable clips appear as preparation completes.
Remove a source connection
In B-Roll Archives 0.3.1 or later, right-click the source in the sidebar, choose Remove source…, then confirm the source name. Choose Cancel to keep the connection.
This removes that source from the sidebar, library, search and MCP access. Playback and preparation stop using the connection. Your original footage, prepared previews, contact sheets, visual index and saved organization stay in place; this action does not free disk space.
Saved shotlist entries explain that the source was removed. To restore access, choose Add Folder and select the same footage folder. The app restores the connection and reuses valid prepared work. Removed connections stay removed after relaunch or remount, and the fixed preview selection and seven-day clock remain unchanged.
An unplugged drive keeps its connection and permitted cached browsing. See disconnected drives for reconnecting an offline source.
If the folder is missing or unreadable
Confirm the drive is mounted, the folder still exists, and macOS allows access. Try a small readable source before investigating a large folder. See troubleshooting for media failures and disconnected drives for a previously prepared source.
