Skip to content
← All apps

An app by Flavio

Broken Alias Repair Desk

Find every broken Finder alias in a folder tree, see the file each one most likely meant and why, and relink only the ones you confirm, with a backup of every old alias and an undo.

Buy Broken Alias Repair Desk · $19

One-time purchase. Plus tax where it applies.

macOS 14 or later · Apple silicon and Intel

Latest version 1.0.1, released November 22, 2026

You keep a Desk folder with aliases to the files you use every day: the brief, the invoices, the logo, the contract. Then the client folders get archived, or restored from a backup into Archive/2021, and you double-click an alias. Finder says the original item can’t be found.

Finder has a Fix Alias… button for that. It opens a file picker, you find the file yourself, and that’s one alias. A desk with 30 aliases is 30 rounds, and Finder doesn’t tell you which ones are broken until you open them.

Broken Alias Repair Desk scans the folders with your aliases, reads what each broken alias still remembers about its file, and looks for that file where you tell it to. It shows the most likely match with the reasons, and relinks only the aliases you confirm. Every old alias is backed up first, and Undo Repair puts them all back.

Broken Alias Repair Desk reviewing the matches: the sidebar has Desk under Folders with aliases, Archive under Where to look for the files and Studio Backups under Backups and report. The top of the main area reads 10 aliases found, 9 to repair, 1 working, 2 symbolic links not changed and 16 items searched, above the tabs To repair (9), Ready (5), Need a choice (2), No match (2), Working (1) and Symbolic links (2). The checked alias Brief is marked Broken and Ready, says The item it pointed to is gone from its old place, and remembers ~/Studio/Clients/Acme Rebrand/Brief.pdf on Macintosh HD, created Mar 8, 2021 at 9:30 AM, size not saved in this alias. Its possible match is Brief.pdf in ~/Studio/Archive/2021/Acme Rebrand with green pills Same name, Same creation date and In a folder named Acme Rebrand. The bottom bar says Relinks 5 aliases in place, next to Save Report… and Relink 5 Aliases

Who it’s for

  • Designers and agencies. You restored a client archive from a Time Machine backup into a new Archive/2021 folder. The aliases on your project desk still point to the old place and open nothing. Point the app at the desk and the archive, and relink them all in one go.
  • Anyone who moved to a new external disk. You copied years of project folders to a new SSD. The aliases still point to the old disk and the app marks them Disk not connected. Tell it where the copies are and point the aliases at them.
  • Researchers and writers. Your Current folder is full of aliases into a library of references that went through Dropbox or iCloud. The sync re-created the files, and the aliases broke. The app finds the re-created files by name and creation date.
  • Office managers handing over a shared archive. Before you pass it on, you want a list of every alias and symbolic link that doesn’t work, as a CSV, and fixes only where you’re sure. Save Report… writes that list, and nothing is relinked until you click.
  • Anyone who cleaned up and found aliases pointing into the Trash. The app marks them Points to the Trash and, if the kept copy is in a folder you add, offers it as the match.

From a desk of dead aliases to aliases that open

Say your Desk folder has aliases into client folders that were restored into Archive/2021.

  1. Add the folders with aliases. Click Add Folders with Aliases…, or Add… next to Folders with aliases, or drop folders there. Include subfolders is on, so aliases in folders inside are found too.
  2. Add where to look. Click Add Where to Look…, or Add… next to Where to look for the files, and add the archive, the new project folder or the backup disk where the files went. Every folder inside is searched. With Also look in the folders above on, the folders with aliases are searched too.
  3. Choose the backup folder. Under Backups and report, click Choose…. Each repair makes a new “Alias Repair ” folder there.
  4. Click Scan for Broken Aliases (Command-R). The app reads every alias and searches the places you added.
  5. Review the matches. Each broken alias shows what it remembers and the items that could be its file, best first, with the reasons. Only Ready ones are checked to start with. Look at Need a choice, pick the right item where there’s more than one, and check the rows you agree with.
  6. Click Relink N Aliases (Command-Return). The old aliases are backed up first. Each new alias is opened by the app after writing, to check it leads to the item you picked.

When two files match equally well, like the same Contract.pdf in two folders, the row says so in purple and nothing is picked until you click one:

The Need a choice tab: the Moodboard alias with its possible match Moodboard v2.key in ~/Studio/Archive/2021/Acme Rebrand, with green pills Same creation date, In a folder named Acme Rebrand and Same kind of file (.key). Below it the alias Contract, marked Broken and Ambiguous, remembers ~/Studio/Clients/Northwind Website/Contract.pdf, created Jun 2, 2021 at 8:45 AM. Its possible matches, best first, are Contract.pdf in ~/Studio/Archive/2021/Northwind Website with Same name, Same creation date and In a folder named Northwind Website, picked, and Contract.pdf in ~/Studio/Archive/2021/Northwind Website copy with Same name and Same creation date. The button reads Relink 7 Aliases

After the repair, every row says which item the alias now opens:

Relinked 7 aliases: each one was checked after writing. Brief opens ~/Studio/Archive/2021/Acme Rebrand/Brief.pdf, Invoices opens the Invoices folder, then Logo final, Moodboard, Contract, Meeting notes and Sitemap, each with Show in Finder. Below, the Alias Repair 2026-11-20 12.24.54 folder, and the buttons Repair Other Folders, Undo Repair, Show Report in Finder and Scan Again

What you get

Reasons you can check

A broken alias still remembers its original path, the disk it was on and the file’s creation date. Aliases made by this app also remember the size and dates. Each possible match gets green pills for what agrees (Same name, same size, Same creation date, same last-modified date, In a folder named “Acme Rebrand”, Same kind of file) and red ones for what doesn’t, like a different size or creation date. A magnifier button shows the item in Finder.

The app never picks a file on its name alone. A name-only match is Check this, two equal matches are Ambiguous, and both wait for you.

Your own pick, scored the same way

Choose Another Item… points an alias at any file you pick by hand, or any folder for an alias to a folder. The app scores it like the others, with the same reasons, and marks it Chosen by you.

A backup and an undo

Before relinking, the app copies every old alias into Old aliases inside the “Alias Repair ” folder. Undo Repair puts them back. It only puts back aliases that are still exactly what the repair wrote, so an alias you changed afterwards is left alone.

A report

Alias repair report.csv has a row per alias and per symbolic link: its state, the original path, disk, creation date, what was decided, the new target, the match, why it matched and the other candidates. Save Report… saves the same list before you relink anything.

Your files aren’t touched

The app writes new alias files in place of the old ones, with the same name in the same folder. The files and folders the aliases open are only read. If a new alias doesn’t open the item you picked, the old one is put back.

Why not use Finder’s Fix Alias…

Open a broken alias and Finder says the original item can’t be found, with a Fix Alias… button. For one alias, that’s the right tool: click it and pick the file. But you browse to each file yourself, one alias at a time. Finder doesn’t tell you what the alias remembered beyond its name, it doesn’t look for the file, and it can’t list every broken alias in a folder. There’s no backup and no undo.

Spotlight finds files by name, but it doesn’t compare creation dates. Two files called Contract.pdf look the same, and you still fix each alias by hand. Tools that find broken links handle symbolic links, a different kind of link, and can’t read Finder aliases.

Note that an alias to a file you only moved or renamed on the same disk usually keeps working on its own, because macOS follows the file. The app lists those under Working and leaves them alone. Aliases break when files come back from a backup, are copied to another disk, are re-created by a sync service, or are deleted and replaced.

Finder’s Fix Alias…Broken Alias Repair Desk
Finding broken aliasesOpen each one to seeScans whole folder trees
What the alias rememberedThe namePath, disk, creation date, and size when saved
Finding the fileYou browse to itSearches where you tell it, best match first
Two files with the same nameYou guessMarked Ambiguous, nothing picked
30 aliases30 roundsOne review, one click
Backup and undoNoneEvery old alias kept, Undo Repair
A list of what’s brokenNoneCSV report

What it doesn’t do

  • It doesn’t change symbolic links. They’re listed in their own tab and in the report, and never changed.
  • It doesn’t fix links inside documents. Only Finder alias files.
  • It doesn’t keep a custom icon. The new alias shows the icon of the item it opens. A custom icon pasted on the old alias is kept in the backup.
  • It can’t tell an edited copy from the original when the alias saved no size. Aliases made by Finder save the name, path, disk and creation date, not the size. A file edited after the restore, with the same name and creation date, comes out Ready. The reasons show exactly what matched.
  • It has no cancel button for a scan. Every folder in the places you add is searched, so a big backup disk takes a while. Add the narrowest folder you can.

Questions

Are my files changed?

The files and folders your aliases point to are only read. The app replaces the broken alias files themselves, after copying each one to the backup folder.

What about aliases that still work?

They’re listed under Working and left alone.

What does “Disk not connected” mean?

The alias points to a disk that isn’t plugged in. If the files are now on another disk, add that disk under Where to look for the files. If the old disk is in a drawer, connecting it may be all you need.

Can I undo a repair?

Yes. Click Undo Repair on the done screen, and every old alias that wasn’t changed since is put back.

Does anything get uploaded?

No. Everything happens on your Mac. The app goes online only to check for updates.

What it needs

Broken Alias Repair Desk runs on macOS 14 Sonoma or later, on Apple silicon and Intel Macs.

The Broken Alias Repair Desk docs walk through each step.

Buy Broken Alias Repair Desk

$19 plus tax where it applies, paid once.

Download the app from the order page or your Creem receipt, unzip it and move it to Applications. I sign the app with my Apple Developer ID, and Apple notarizes the download.

The app checks for updates once a day. When a new version is ready, click Install and Relaunch. To check anytime, choose Broken Alias Repair Desk → Check for Updates….

Broken Alias Repair Desk screenshot at full size