Getting started
macOS permissions
What each prompt is asking, what Tusk does with the access, and how to fix it later if you said no.
macOS asks for explicit permission before any app can read files in common folders like Documents, Downloads, and Desktop. This is part of Apple's TCC (Transparency, Consent, and Control) framework. Without permission, Tusk literally cannot see the files in those folders, even if you point it at them in the project picker.
The first-launch welcome flow walks through this in plain language and triggers the prompts for you. If you skipped that, or if you want to know what each prompt grants access to, this page is for you.
What Tusk asks for and why
You'll see a separate permission prompt for each folder Tusk needs to read or write. Each prompt is its own decision; you can accept some and deny others.
- Documents: lets Tusk track project folders that live under
~/Documents. Most photo and video projects do. - Downloads: needed if you ever store project material in Downloads, even temporarily.
- Desktop: same idea. Most people don't actively store project files on the Desktop, but the access is needed if you ever drag a folder picker through it.
- Pictures: where Lightroom catalogs and most photo libraries live by default. Photographers should grant this.
- Movies: where Premiere, Final Cut, and DaVinci Resolve put project files by default. Videographers should grant this.
- Removable volumes: macOS prompts the first time Tusk tries to read from an external drive or SD card. Grant this for offload to work.
- Network volumes: grant this if you use mounted network volumes with Tusk.
- Full Disk Access(optional): grants Tusk read access to areas like protected system folders. Tusk doesn't need this for normal use, but it's the simplest single switch if you want to grant everything at once.
Don't grant Full Disk Access unless you understand it
If you said no by mistake
Permissions are remembered until you change them. Reopening the prompt isn't a thing macOS supports, but you can fix any permission from System Settings.
1
Open System Settings → Privacy & Security
2
Find the permission category you want to fix
3
Toggle Tusk on for the folders you want it to access
4
Restart Tusk for permission changes to apply
What “denied” looks like inside Tusk
If Tusk doesn't have access to a folder you point it at, the project picker either won't see the folder or will show it as empty. The folder is also a candidate for the “Folder missing” banner once a project is created against it. Granting the permission and restarting Tusk fixes both.
Removable drives and SD cards
The first time you plug in an external drive or SD card and ask Tusk to read from it, macOS prompts for removable-volume access. Grant it once and it applies to every removable drive going forward. If you originally said no, fix it under Privacy & Security → Files and Folders → Tusk → Removable Volumes the same way as the standard folders above.
Related