macOS-snapcleaner/README.md
2025-09-24 17:18:02 +02:00

1.2 KiB

auto-snapclean-listener

A small macOS utility script that automatically deletes all local Time Machine snapshots once they are created.
It is useful for users who do not want macOS to keep local snapshots and prefer to rely only on external Time Machine backups.

⚠️ Tested on macOS Tahoe. Other versions may work, but are not guaranteed.


Features

  • Listens for local Time Machine snapshot creation events.
  • Waits until the backup process is finished (avoids conflicts).
  • Automatically deletes all local snapshots afterwards.
  • Lightweight: no constant polling, event-driven.

Installation

Clone the repository:

git clone https://github.com/YOURUSERNAME/auto-snapclean-listener.git
cd auto-snapclean-listener

Make the script executable:

chmod +x auto-snapclean-listener.sh

Install the LaunchDaemon:

sudo cp auto-snapclean-listener.plist /Library/LaunchDaemons/
sudo launchctl load /Library/LaunchDaemons/auto-snapclean-listener.plist

Uninstall (if needed):

sudo launchctl unload /Library/LaunchDaemons/auto-snapclean-listener.plist
sudo rm /Library/LaunchDaemons/auto-snapclean-listener.plist