transmission-unlinked 0.1.2

Helps you remove your transmission torrents which have no hardlinks

Transmission Cleaner

A CLI tool to help you clean up Transmission torrents that don't have hardlinks to other files on your system.

This is particularly useful if you're using Transmission with media management tools like Sonarr, Radarr, or similar applications that create hardlinks to your torrent files. This tool helps you identify and remove torrents whose files are no longer hardlinked anywhere else.

Installation

Quick Install (Recommended)

If you haven't yet, install uv (curl -LsSf https://astral.sh/uv/install.sh | sh). It's a massive painkiller for the python management headache.

# Using uv (recommended for CLI tools)
uv tool install transmission-cleaner

# Or from source
git clone https://github.com/flying_sausages/transmission-cleaner.git
cd transmission-cleaner
uv tool install .

See INSTALL.md for detailed installation instructions including uv setup, virtual environments, and troubleshooting.

Usage

After installation, you can run the tool using the transmission-cleaner command:

transmission-unlinked --password YOUR_PASSWORD

Arrs setup suggestion:

• Have something (Plex/maintainerr/etc.) automatically delete things
• Make sure your arr has Unmonitor Deleted Episodes set to True
• In the arr's download client settings, set a value for Category (this moves downloaded torrents into the following )
• use that for the directory argument (transmission-unlinked --directory Sonarr)
• After playing around with the tool, add something like this to your crontab to run daily at 3am: 0 3 * * * /path/to/transmission-unlinked --settings-file ~/.config/transmission-daemon/settings.json --password YOUR_PASSWORD --directory /path/to/sonarr --action delete >> /var/log/transmission-cleaner.log 2>&1

Development

# Set the project up
uv sync

# Run linting
ruff check .

# Run type checking
basedpyright

Safety Notes

• Always test with --action list first to see what would be affected
• Use interactive mode when unsure about automatic removal
• Backup your data before performing bulk deletions
• The tool requires direct filesystem access to check hardlinks

License

MIT License - See LICENSE file for details

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.