Transmission Discord Bot

A python Discord bot for controlling an instance of Transmission, the torrent client, using the transmissionrpc python library. This bot is built on kkrypt0nn's bot template and adapted from leighmacdonald's transmission scripts.

Features

Completely self-contained: Get the python dependencies, configure a single python file, and run
Complete management of transfers:
- t/add URL Add new torrent transfers via URL to torrent file or magnet link
- t/list [OPTIONS] List existing transfers with filtering, sorting, and searching transfer names with regular expressions or transfer ID(s)
- t/modify [OPTIONS] Modify (pause, resume, remove, remove and delete, or verify data) transfer(s) specified using list's options
- t/summary Print simple summary of all transfers
User-friendly and attractive interface
- In-channel documentation using t/help [COMMAND]
- Use of embeds where appropriate
- Uses reactions in lieu of text input where appropriate
- Output automatically formatted to look good on desktop/mobile clients
  - Can toggle override using t/compact
- Auto-update output for summary and list commands
  - Simultaneous auto-update output messages supported
  - An auto-update output message can be reprinted to the bottom of the channel by clicking its "🖨" reaction
User whitelist and blacklist to control access
Channel list to limit access to specified channel(s)

Example images

Transfer summary (and symbol legend)

Modifying existing transfers

Install

Get Transmission and setup its web interface
Install python 3, transmissionrpc, and discord.py
Clone this repository using git clone https://github.com/twilsonco/TransmissionBot

Configure

Setup your new bot on Discord:
1. Sign up for a Discord developer account
2. Go to the developer portal, click New Application, pick a name and click Create
  - Note the CLIENT ID
3. Click on Bot under SETTINGS and then click Add Bot
4. Fill out information for the bot and uncheck the PUBLIC BOT toggle
  - Note the bot TOKEN
Invite the bot to your server
1. Go to https://discordapp.com/api/oauth2/authorize?client_id=<client_id>&scope=bot&permissions=<permissions>
  - replace <client_id> with the CLIENT ID from above
  - replace <permissions> with the minimum permissions 92224(for send messages, manage messages, embed links, read message history, and add rections) or administrator permissions 9 to keep things simple
2. Invite the bot to your server
Configure bot.py
1. Set discord options
  - TOKEN to your bot secret token
  - Lists of OWNERS, BLACKLIST and/or WHITELIST users, and CHANNEL_IDS on which the bot should listen for commands
    - get these ids by enabling developer mode in your Discord client and right-clicking on a user/channel
  - Pick a BOT_PREFIX (default is t/)
2. Set Transmission client information
  - TSCLIENT_CONFIG points to the Transmission web interface you already setup
  - Set DRYRUN to True to enable the discord bot to actually make changes to existing transfers
  - Pick a location for the logfile on line 45
  - Optionally disable logging by setting the log level to logger.CRITICAL which isn't used anywhere
Run with python3 /path/to/TransmissionBot/bot.py and enjoy!

To-do (implemented)

Command to print detailed information for transfer(s)
- Complete connection information
- Lists of transfer files, peers, trackers
~~Add ability to verify transfer data~~
When searching by name, update regex to include potential accented characters, eg pokemon would also match pokémon
Specify number of transfers to show when using list or modify
Combine the list and modify commands in the code, with a simple parameter to specify whether or not modification is allowed
Currently, searching by name is done with case-insensitive regex. Update to that if a user includes upper case characters, case-sensitive search is performed
~~Add recurring list option. Ie every five seconds replace list output with fresh output. This would be done by reacting to a "repeat" emoji to initiate repetition of the current search~~ (also did this for summary)
~~Add additional filtering options: stalled, error, non-zero up/down rate.~~
Add shorthand for filtering options (downloading/seeding/stalled/paused become d/s/i/p etc., that's i for "idle" since s is for seeding)
Add a top command that'sessentially a combination of the up/down rate filter and the repeating output features
Ability to refine list output with filter or sort using reactions; ie click a filter or sort reaction which triggers another message with additional reactions to click to apply the extra filters or sort
Ability to specify which files to include in download (we'll see about that; sounds clunky but maybe using file ID specifiers e.g. 1,3-5,8)
Notifications for when a transfer finishes/stalls/errors
- via DM to the user that added the transfer
- or by posting to the channel from which a transfer was added
- Let other users opt to receive notifications for transfers they didn't add
Post-download file management (never going to happen...)
- Compress files (encrypted) and make available for direct download from server via download link posted to channel or DM'd to user
Use JSON config file so that updating is non-destructive
Add set command so owners can edit configuration through Discord
Add a toggle for minimalised output for better display on mobile devices. Toggle using t/compact as standalone command or by clicking a 📱 reaction. Store as global variable so all commands output can be affected.

Author(s)

Tim Wilson

Thanks to:

kkrypt0nn
leighmacdonald

License

This project is licensed under the Apache License 2.0 - see the LICENSE.md file for details

6.5 KiB Raw Blame History