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
• Use of Embeds for pretty output
• Uses reactions in lieu of text input where appropriate
• User whitelist and blacklist to control access
• Channel list to limit access to specified channel(s)
• 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
  • t/modify [OPTIONS] Modify (pause, resume, remove, or remove and delete) transfer(s) by transfer ID(s) or using list options
  • t/summary Print simple summary of all transfers
• In-channel documentation using t/help [COMMAND]

Example images

• Transfer summary

• Modifying existing transfers

Install

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

Configure

1. 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
2. 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
3. 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
4. Run with python3 /path/to/TransmissionBot/bot.py and enjoy!

To-do

• Command to print detailed information for transfer(s)
  • Complete connection information
  • Lists of transfer files, peers, trackers
• Add ability to verify transfer data
• 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

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