DiscordTorrentManager 🎬

Connect your seedbox to your discord server.

This program enhances a Discord server by integrating torrent searching and downloading functionalities through the qBittorrent API. 🤯

🌟 Installation

1. Clone the repository:

   git clone https://github.com/JakeTurner616/DiscordTorrentManager
   cd DiscordTorrentManager

2. Create a virtual environment:

   python -m venv venv

3. Activate the virtual environment:

   • On Windows:

     venv\Scripts\activate

   • On MacOS and Linux:

     source venv/bin/activate

4. Install the required packages:

   pip install -r requirements.txt

5. Run the bot:

   python bot.py

   If you run into this error: ImportError: cannot import name 'Option' from 'discord', just run these commands:

   pip uninstall discord -y
   pip uninstall py-cord -y
   pip install discord
   pip install py-cord
   pip uninstall discord -y

⚙️ qBittorrent Setup

1. Open qBittorrent and go to Tools -> Options.

2. Navigate to the Web UI section under the Web UI tab.

3. Check the Enable the Web User Interface (Remote control) box.

4. Set a network interface to bind the webui in the IP Address text box.

5. Set a username and password for the Web UI.

6. Create torrent categories in qBittorrent to associate the downloaded content with the folders they should be saved to (for example: movies > Z://some/location/movies, tv > Z://some/location/tv). These are to be used with /magnet <magnet_link> <category> The category save paths could be set somwhere that has access to a media player like plex, jellyfin, or anything really.

⚙️ Discord Bot Setup

1. Go to the Discord Developer Portal and create a new bot application.

2. Create and copy the bot token.

3. Invite the bot to your server using the OAuth2 URL Generator under the OAuth2 tab. Make sure to give the bot the necessary permissions for slash commands, reactions, and text.

⚙️ Configuration

Edit the config.ini file to include your specific environment settings for connecting to your discord bot and qBittorrent instance:

[Bot]
# change to your bot token
token = YOUR_DISCORD_BOT_TOKEN
# change to your server id
guild_id = YOUR_DISCORD_GUILD_ID

[qbit]
# change to your qBittorrent host and port:  http://host_ip:port 
host = http://10.0.0.123:8080
# qBittorrent WebUI login credentials
user = YOUR_QBITTORRENT_USERNAME
pass = YOUR_QBITTORRENT_PASSWORD

The bot can then be started by running the bot.py script.

🤖 Command Usage

Here are the commands included with the DiscordTorrentManager bot:

• Add a Magnet Link:

  /magnet <magnet> <category>

  This command adds a new torrent to qBittorrent using the provided magnet link and associates it with the specified category.

• Search for Torrents:

  /search <title>

  This command searches for torrents based on the provided title. The bot will list the results, and the user can select a result to automatically download it to the 'movie' category. Assumes the 'movie' category exists.