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

55 lines
No EOL
1.3 KiB
Markdown

# macOS-SnapCleaner
SnapCleaner is a lightweight macOS tool that automatically deletes local Time Machine snapshots as soon as they are created.
It is designed for users who want to avoid local disk space being taken up by snapshots while still using Time Machine for external backups.
⚠️ **Note**: SnapCleaner has been tested on **macOS Tahoe**. Other versions may work, but are untested.
---
## Features
- Monitors for new Time Machine local snapshots
- Deletes snapshots automatically once they appear
- Waits until Time Machine finishes the backup process before deleting
- Runs silently in the background as a LaunchDaemon
---
## Installation
Clone the repository:
```bash
git clone https://git.lahmico.de/Pipo/macOS-snapcleaner.git
cd macOS-snapcleaner/scripts
```
Run the installer:
```bash
chmod +x install.sh
sudo ./install.sh
```
This will:
- Copy the script `auto-snapclean-listener.sh` to `/usr/local/bin/`
- Install the LaunchDaemon `auto-snapclean-listener.plist` to `/Library/LaunchDaemons/`
- Load the service so it runs automatically whenever a local snapshot is created
---
## Uninstallation
To uninstall SnapCleaner:
```bash
chmod +x uninstall.sh
sudo ./uninstall.sh
```
This will remove the LaunchDaemon and the installed script.
---
## License
SnapCleaner is released under the MIT License. See [LICENSE](LICENSE) for details.