Skip to content

About

Reclaim disk space from Final Cut Pro libraries by browsing, cleaning, and exporting projects!

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

2 Commits

Folders and files

Repository files navigation

FCP Storage Manager

A small native Mac app for reclaiming disk space from Final Cut Pro libraries. Open a .fcpbundle, see exactly what's using space in a size-sorted tree, and move old projects, render files, proxies, and unused footage to the Trash — or export a project into a self-contained library before deleting it.

FCP Storage Manager

Features

  • Size-sorted file tree of the whole library: events, projects, source media, render files, proxy/optimized media, and analysis files, each labeled with what it is and whether it's safe to delete.
  • "Select Regenerable" — one click selects every render, proxy, and analysis folder. Final Cut Pro recreates all of it on demand, so this is free space with zero risk.
  • Trash, never delete. Everything goes to the macOS Trash, so any mistake can be undone. Library-critical database files can't be selected at all, and a banner warns when Final Cut Pro is running.
  • Project export, two ways (right-click any project):
    • Self-contained library — builds a double-clickable .fcpbundle containing the project and only the media its timeline uses, at their original internal paths. Open it in Final Cut Pro and the project is exactly as you left it. Archive a project this way, verify it opens, then delete the original from the big library.
    • Media folder — a flat folder of the footage the project uses, plus a manifest, for handoffs and non-FCP archives.
  • Finder-style search — type in the toolbar to search every file and folder in the library by name, results flat-listed largest first with their location, deletable right from the results.
  • Empty-project detection — every project row shows how many clips its timeline references; stub projects with no clips get an "Empty" badge so you know which duplicates are safe to clear out.
  • Built for huge libraries — tested against a 1.5 TB library with 145,000+ files. Determinate progress bar while scanning; large folders reveal their contents in batches (biggest first) so the UI never chokes.
  • External-media aware — libraries imported with "leave files in place" hold symlinks; the app tags them, follows them when exporting, and tells you exactly which original file is gone when a clip is offline.
  • Incremental zoom — ⌘= / ⌘− / ⌘0 (or the toolbar buttons) scale the whole tree, Finder-style, to fit more or less on screen. Persists across launches.

Feature tour

Welcome screen Open, drop, or pick a discovered library Scanning Determinate progress while scanning huge libraries
Search Finder-style search with clip counts and Empty badges Export Project exported as a self-contained library
Zoomed out Incremental zoom for denser or larger views

Install

Grab FCP-Storage-Manager.dmg from Releases, open it, and drag the app to Applications. Universal binary (Apple Silicon + Intel), macOS 13 Ventura or later.

The app is not notarized (no paid developer account), so the first launch needs a one-time approval: open the app, then go to System Settings → Privacy & Security → "Open Anyway".

Build from source

Requires Xcode Command Line Tools (Swift 5.9+). No dependencies.

./build.sh   # builds "FCP Storage Manager.app" next to the script
./dist.sh    # universal binary, packaged as DMG + zip in dist/

How it works

Final Cut Pro's CurrentVersion.fcpevent files (one per event and one per project) are Core Data SQLite stores. The project export feature queries them directly:

  1. The project's store holds FFAssetRef rows — keyed-archive blobs containing a 32-hex mediaIdentifier for every asset the timeline uses.
  2. Each event's store holds FFMediaRep rows mapping those identifiers to paths like Original Media/clip.mov, relative to the event folder.
  3. Join the two, resolve symlinks, and you know precisely which files a project needs — no guessing, no filename matching.

The self-contained library export copies the library metadata (CurrentVersion.flexolibrary, Settings.plist), the event database, the project folder, and the resolved media at their original relative paths, so every database reference works when Final Cut Pro opens the bundle.

Safety notes

  • Quit Final Cut Pro before trashing anything from a library it has open.
  • Green-badged items (Renders, Proxy/Optimized, Analysis) are always safe — Final Cut Pro regenerates them.
  • "Source Media" is your footage. The app will trash it if you ask, but only the Trash stands between you and losing it permanently.
  • Media used exclusively inside compound or multicam clips stored in other events may not be captured by project export — verify an export opens before deleting originals.

License

MIT

About

Reclaim disk space from Final Cut Pro libraries by browsing, cleaning, and exporting projects!

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages