Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
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: 5 days 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 (5 months ago)
- Default Branch: main
- Last Pushed: 2024-06-30T00:20:27.000Z (5 months ago)
- Last Synced: 2024-06-30T10:16:30.825Z (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: 350 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
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. **Run the bot:**
```bash
python bot.py
```
If you run into this error: `ImportError: cannot import name 'Option' from 'discord'`, just run 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 webui 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, 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, 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 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://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:**
```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.