1. Run your first scan
File Stacker is sandboxed: it can only read folders you hand it, and it remembers them.
- Open File Stacker. On the welcome screen, click Scan Home Folder… to see everything, or Scan Downloads… for a quick start.
- In the folder picker that opens, keep the suggested folder selected and click Grant Access.
- The scan starts at once and shows its progress. Large home folders take a minute or two.
- To add another folder or an external disk later, click Grant Access to a Folder… at the top of the sidebar.
Tip: granting your Home folder covers Library, Downloads, Documents and everything inside them. Some places, such as Photos library internals and Mail, stay protected by macOS and are marked with a lock.
2. Read the treemap
Every rectangle is a file or folder. The bigger the rectangle, the more disk space it uses.
- Colors show the kind of file. The legend above the map names them; click a kind to highlight only that kind.
- Click a folder to open it. Use the arrow in the toolbar or ⌘↑ to go back up, and the house button to return to the top.
- Tiny items are combined into an Other block. Drag the Group below slider to show more or less detail.
- Sizes are what each item actually occupies on disk, which is what fills your drive.
3. Switch views
- Use the view buttons in the toolbar, or press ⌘1 Treemap, ⌘2 Sunburst, ⌘3 Table, ⌘4 Overview.
- Sunburst shows nested folders as rings. Table is a sortable outline you can expand. Overview breaks the scan down by category and lists the largest items.
4. Search and filter
- Press ⌘F or click the search field and type part of a name. Type an extension like
.dmg to find every disk image.
- Click Filter to show only items Larger than a size or Not opened in a few months or years.
- Click Clear Filters to see everything again.
5. Inspect a file
- Click any item. The inspector on the right shows its size on disk, item count, dates, kind and the largest things inside it.
- Press Space to preview it with Quick Look, or right-click for Open, Quick Look, Show in Finder and Copy Path.
- Show or hide the inspector with ⌥⌘I.
6. Free up space safely
- Right-click an item and choose Move to Trash.
- Check the confirmation, then confirm to move the item.
- When you're sure, empty the Trash in Finder. Until then, the space is still in use.
7. Remove several items at once
- Right-click items anywhere in File Stacker and choose Add to Collector, or press ⇧⌘C.
- The Collector bar at the bottom shows how many items and how much space you've gathered. Click Review… to check the list.
- Click Move All to Trash (⇧⌘⌫) and confirm once.
8. Put something back
- Open Recent Removals in the sidebar.
- Find the item and click Put Back. It returns to where it was, as long as it's still in the Trash.
9. Clean up caches and leftovers
Cleanup measures well-known places that grow over time and explains what each one is.
- Grant your Home folder first (guide 1), then open Cleanup in the sidebar.
- It measures categories such as Application Caches, Xcode DerivedData, Simulator Devices & Caches, Swift Package Caches, npm / Yarn / pnpm, pip / uv / Hugging Face and Homebrew caches, and more.
- Read each explanation, tick what you want to remove, and click Move Selected to Trash.
In-depth guide: clean up Xcode storage →
Good to know: caches are rebuilt when apps need them, so clearing them is safe but may make an app slower the first time it starts. Some categories carry a warning: removing Docker Disk Image removes all containers and images, so the app suggests docker system prune inside Docker Desktop instead.
10. Find duplicate files
- Scan a folder, then open Duplicates in the sidebar.
- Set Ignore files under to skip small files, then run the search.
- Each set lists identical copies with their size and dates. Choose the copy to keep and move the others to the Trash.
Good to know: the space shown is an upper bound. APFS clones, hard links and compression can mean less space is recovered.
In-depth guide: find duplicate files on a Mac →
11. Find large, old files
- Scan a folder, then open Large & Old Files.
- Set Larger than and Not opened in. The list updates instantly, biggest first.
- Preview with Quick Look, then move what you don't need to the Trash.
In-depth guide: find large files on a Mac →
12. Uninstall an app completely
- Quit the app, then open Uninstall Apps and pick it.
- File Stacker lists the app and leftover files it can find by the app's bundle identifier and name, such as caches and preferences.
- Matching is a heuristic, so review each item, then move what you want to remove to the Trash.
Good to know: leftovers live in your Library, so this works best with your Home folder granted.
13. Track what grew
- Every scan is saved as a summary. Open History & Trends to see a folder's size over time.
- Pick any two scans to compare; What changed lists the folders that grew or shrank the most.
- To keep history current automatically, turn on scheduled scans in Settings (⌘,). They run while File Stacker is open.
14. Skip or protect a folder
- Right-click a folder, choose Exclusions, then pick a rule. You can also manage the list in Settings → Exclusions.
- Skip in scans: the folder is listed but not measured, and tools ignore it. Good for huge folders you don't care about.
- Protect from removal: the folder is measured and shown, but tools never suggest it and Move to Trash is refused inside it. Good for anything precious.
16. Export a report
- Click Export in the toolbar.
- Choose the current folder or the whole scan, as CSV (for spreadsheets) or JSON.
- Pick where to save it. File Stacker tells you how many rows were written.
17. Free space from iCloud files
- Right-click a file in iCloud Drive and choose Remove Download.
- File Stacker asks macOS to remove only the downloaded local copy; the file stays in iCloud. Availability depends on your iCloud setup and the item you chose.
18. Install on another Mac
- On the other Mac, open the App Store and sign in with the Apple Account you bought File Stacker with.
- Click your name in the bottom-left corner, find File Stacker in your purchases, and click the Download button.
Good to know: App Store purchases are tied to your Apple Account, so you don't pay again on your other Macs.
19. Remove a folder's access
- Right-click the folder under Granted Folders in the sidebar and choose Remove Access.
- File Stacker forgets the folder. Nothing on disk changes.