transmission_cleanup Code
Clean up of torrent files using the RPC protocal
Brought to you by:
vampiro2004
Menu
▾
▴
Tree [fefd83] main / History
| File | Date | Author | Commit |
|---|---|---|---|
| dist | 2025-05-31 |
vampiro2004
|
[086946] Added maOS build files |
| LICENSE | 2025-05-26 |
vampiro2004
|
[85e7d8] Initial commit |
| LICENSE.md | 2025-06-02 |
vampiro2004
|
[70488d] add License file |
| README.md | 2025-06-06 |
vampiro2004
|
[fefd83] Update README.md |
| TransmissionCleanup.ps1 | 2025-06-02 |
vampiro2004
|
[1f35d6] Update TransmissionCleanup.ps1 |
| app_icon.icns | 2025-06-01 |
vampiro2004
|
[86bf6a] add icns file |
| app_icon.png | 2025-05-31 |
vampiro2004
|
[086946] Added maOS build files |
| setup.py | 2025-05-31 |
vampiro2004
|
[086946] Added maOS build files |
| transmission_cleanup_app.py | 2025-05-31 |
vampiro2004
|
[086946] Added maOS build files |
Read Me
Transmission RPC Cleanup Utilites For windows and macOS
Automatically organize completed Transmission downloads on both macOS and Windows platforms.
Windows
macOS
Features
Cross-Platform Core Features
- ✅ Smart File Organization - Automatically sorts files into categories (Apps, Media, Music, Archives, Other)
- 🔒 Secure Credential Storage - Encrypted storage of Transmission RPC credentials
- ⏰ Flexible Scheduling - Set daily or weekly cleanup schedules
- 📝 Detailed Logging - Comprehensive logging for troubleshooting
- ♻️ Torrent Management - Optional removal of completed torrents from Transmission
macOS Exclusive Features (v1.5.1)
- 🖥️ Native GUI application
- 🚀 LaunchAgent scheduling integration
- 🔍 Built-in log viewer
- 🎨 Dark/Light mode support
- 🔄 Automatic update checking
Windows Exclusive Features (v10.2.0)
- ⚡ Self-installing PowerShell script
- 🏁 Start Menu shortcuts
- 🔄 Automatic retry logic
- 🗑️ Complete self-uninstallation
- 🛡️ Self-elevating admin privileges
Installation
macOS Installation
- Download the latest
.dmgfrom Releases - Open the disk image and drag the app to your Applications folder
- Launch the application and:
- Enter your Transmission RPC credentials
- Configure your download folders
- Set up your preferred schedule
Windows Installation
- Download the TransmissionCleanup.ps1 script
- Right-click the file and select "Run with PowerShell"
- Follow the installation prompts to:
- Set your Transmission RPC URL
- Configure download folders
- Set up scheduling preferences
Configuration
| Setting | macOS | Windows |
|---|---|---|
| Credentials | GUI Configuration | During first run |
| Folders | Customizable in Settings | Set during installation |
| Schedule | Daily/Weekly In Preferences | Daily/Weekly during setup |
| Log Location | ~/Library/Application Support | %APPDATA%\Transmission\Logs |
Requirements
| Componments | macOS | Windows |
|---|---|---|
| OS Version | macOS 10.15+ | Windows 7+ |
| Transmission | 2.94+ | 2.94+ |
| RPC Access | Enabled | Enabled |
| Runtime | - | PowerShell 5.1+ |
Usage
After installation:
On macOS:
Use the menu bar icon for quick access
Run cleanup manually from the main window
View logs directly in the application
Scheduled tasks run automatically
On Windows:
Use Start Menu shortcuts:
"Run Cleanup Now"
"Reset Credentials"
"View Log File"
Scheduled tasks run automatically
Troubleshooting
Common issues for both platforms:
1. Connection Errors:
Verify Transmission RPC is enabled
Check your firewall settings
Confirm correct credentials
2. File Permission Issues:
macOS: Grant Full Disk Access in System Preferences
Windows: Run as Administrator
3. Scheduling Problems:
macOS: Check launchctl list | grep transmission
Windows: Verify task in Task Scheduler
Uninstalling
macOS:
Delete the application from your Applications folder Remove config files:
rm -rf ~/Library/Application\ Support/Transmission\ Cleanup
Windows:
1. Use the Start Menu "Uninstall" shortcut
2. Or run:
Powershell: .\TransmissionCleanup.ps1 -Uninstall
License
MIT License - See LICENSE for details.
