Back to petezhang.com
Final Cut Pro media repair macOS MVP · v0.1 build

Final Cut ReLinker

A local Mac utility for repairing moved Final Cut Pro Original Media links. Scan a library, match broken symlinks against current media folders, review risky items, and relink the safe matches with a backup.

.fcpbundle scan Original Media symlinks Backup before apply
Final Cut ReLinker macOS interface
Workflow

Move media folders without manually rebuilding every link.

The MVP focuses on one painful Final Cut Pro situation: a library still points to old external media paths after footage folders move.

Product preview

A real relink plan before writing anything.

The interface separates selection, status, broken-link rows, and the final apply area, so risky matches do not get mixed with safe ones.

Final Cut ReLinker full window
Current macOS build Scan, status cards, broken media list, and apply confirmation in one window.
Broken media list with old and new paths
Broken media list Each row shows file name, old path, new path, and status.
Apply confirmation panel
Apply confirmation Only found matches are written. Review and missing items stay blocked.
User guide

How to use Final Cut ReLinker

The guide follows the current MVP: choose a Final Cut library, add current media folders, scan missing symlinks, inspect the plan, and apply only when the plan is clean.

    Feature coverage

    The MVP covers the core relink job.

    This is not a general file manager. It is a focused utility for Final Cut Pro libraries that use external media links.

    Advantages

    Why editors need a small tool for this

    Safety notes

    Local repair, conservative writing.

    The current product is designed for careful recovery. It works locally, writes a backup, and does not edit Final Cut Pro's internal databases.

    Who it fits

    Useful after drives, folders, or project archives move.

    FAQ

    Questions before relinking a library

    Beta access

    Have a Final Cut library with missing media?

    I am testing the v0.1 workflow with real moved-folder cases before packaging it as a cleaner Mac release.