Skip to content
MoryelPublic

About

Uninstall Mac apps together with the files they leave behind.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

2 Commits

Folders and files

Repository files navigation

Leftover icon

Leftover

Uninstall Mac apps together with the files they leave behind.

Download the latest version
macOS 13+ · Apple Silicon and Intel · MIT

Installed apps

Dragging an app to the Trash leaves its caches, preferences, containers and login items behind. Leftover finds them, shows you why it thinks each one belongs to the app, and moves only what you pick to the Trash. Nothing is deleted for good and every action can be undone.

Early version (0.1). Dry run is on by default, so you can see what would happen before anything moves.

Uninstall an app

Pick an app from the list (search, or sort by name, size or last used), drag one onto the window, or right click an app in Finder and choose Uninstall with Leftover.

Scan results

Leftover reads the app's bundle id, name and code signing Team ID, then looks in the usual ~/Library folders, the per-user cache in /private/var/folders and the installer package receipts (pkgutil). Every match gets a confidence level:

Level When Selected by default
High Exact bundle id, or installed by the app's own package Yes
Medium Starts with the bundle id (helpers, other versions), same Team ID, or installed by a shared package No
Low Name only No

Files outside your home folder (for example under /Library) need admin rights and are only listed.

Background items

Background items

Lists third party programs that start on their own: which app they belong to, whether they run right now and how much memory they use. Ones whose app is gone are shown first as orphaned. Items in ~/Library/LaunchAgents can be stopped and moved to the Trash; system wide ones are shown for information. Apple's own services are hidden.

Storage

Shows what fills the "System Data" part of your disk: app caches, logs, Xcode leftovers and developer tool caches. Nothing is selected by default, caches of open apps are locked, and folders that may belong to macOS are only shown. iPhone backups, Xcode archives, simulators and Docker data are listed with a note on how to clean them with their own tools.

There is no "free up RAM" button on purpose. It doesn't help on macOS.

Safety rules

  • Apple apps (com.apple.*) and system paths (/System, /usr, ...) are refused.
  • Short shared prefixes like com.google are never matched loosely.
  • An app that is running has to be quit first.
  • Only items inside the scanned folders can move, never the folders themselves.
  • The same checks run again right before anything is moved.

Install

Download Leftover.zip and unzip it. The app isn't notarized (no paid Apple developer account), so macOS asks you to allow it once:

  1. Move Leftover.app to Applications and open it. macOS says it can't verify the developer; click Done.
  2. Open System Settings → Privacy & Security and click Open Anyway next to Leftover.

Give it Full Disk Access (System Settings → Privacy & Security → Full Disk Access) so it can see folders like ~/Library/Containers. It tells you when the permission is missing.

Build

Needs Xcode (Command Line Tools alone can't build the SwiftUI part).

./scripts/build-app.sh      # build/Leftover.app, universal
DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer swift test

Scan without changing anything:

swift run leftover-cli /Applications/Example.app
swift run leftover-cli --background

The icon is drawn in code: swift scripts/make-icon.swift regenerates Resources/AppIcon.icns and images/logo.png.

License

MIT

About

Uninstall Mac apps together with the files they leave behind.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages