https://github.com/jaketurner616/discordtorrentmanager
Connect your seedbox to your discord server.
https://github.com/jaketurner616/discordtorrentmanager
discord-bot qbittorrent qbittorrent-api qbittorrent-webui seedbox seedbox-from-scratch seedbox-install-script
Last synced: 3 months ago
JSON representation
Connect your seedbox to your discord server.
- Host: GitHub
- URL: https://github.com/jaketurner616/discordtorrentmanager
- Owner: JakeTurner616
- License: gpl-3.0
- Created: 2024-06-13T02:28:16.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2024-12-30T03:32:00.000Z (5 months ago)
- Last Synced: 2025-01-07T17:46:42.723Z (5 months ago)
- Topics: discord-bot, qbittorrent, qbittorrent-api, qbittorrent-webui, seedbox, seedbox-from-scratch, seedbox-install-script
- Language: Python
- Homepage: https://serverboi.org/posts/DiscordTorrentManager/
- Size: 366 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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
## Docker Installation ***(Recommended)***
1. **Clone the repository:**
```bash
git clone https://github.com/JakeTurner616/DiscordTorrentManager
cd DiscordTorrentManager
```
2. **Build the Docker image:**
```bash
docker build -t discordtorrentmanager .
```
3. **Run the Docker container:**
### Linux/macOS (Bash or Zsh)
```bash
docker run -d --name discordtorrentmanager -v $(pwd)/config.ini:/app/config.ini discordtorrentmanager
```
### Windows (PowerShell)
```powershell
docker run -d --name discordtorrentmanager -v ${PWD}/config.ini:/app/config.ini discordtorrentmanager
```
---
## Bare-Metal Installation (Not Recommended)
1. **Clone the repository:**
```bash
git clone https://github.com/JakeTurner616/DiscordTorrentManager
cd DiscordTorrentManager
```
2. **Create a virtual environment:**
```bash
python -m venv venv
```
3. **Activate the virtual environment:**
- On Windows:
```bash
venv\Scripts\activate
```
- On MacOS and Linux:
```bash
source venv/bin/activate
```
4. **Install the required packages:**
```bash
pip install -r requirements.txt
```
5. **Running the bot:**
The Bot can be started by running the start script, Make sure to setup qBittorrent and the values in `config.ini`.
```bash
bash ./start.sh
```
If you encounter the following error: `ImportError: cannot import name 'Option' from 'discord'`, resolve it by running these commands:
```bash
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.
5. Set a network interface to bind the Web UI in the `IP Address` text box.
6. Set a username and password for the Web UI.
7. 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, and tv --> Z://some/location/tv). These are to be used with `/magnet ` The category save paths could be set somwhere that has access to a media player like plex, jellyfin, a game folder, or anything really.
## ⚙️ Discord Bot Setup
1. Go to the [Discord Developer Portal](https://discord.com/developers/applications) and create a new bot application.
2. Create and copy the bot token.
3. Invite the bot to your Discord 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:
```ini
[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://host_ip:port
# qBittorrent WebUI login credentials
user = YOUR_QBITTORRENT_USERNAME
pass = YOUR_QBITTORRENT_PASSWORD
```
The bot can then be started by running the `./start.sh` script.
## 🤖 Command Usage
Here are the commands included with the DiscordTorrentManager bot:
- **Add a Magnet Link:**
```bash
/magnet
```
This command adds a new torrent to qBittorrent using the provided magnet link and associates it with the specified category.
- **Search for Torrents:**
```bash
/search
```
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.