A Discord bot that interfaces with qBittorrent to monitor and manage your torrents.
- Monitor torrent progress and status
- Filter torrents by category (movies/TV shows)
- View download speeds and estimated completion times
- Clean, formatted Discord messages with embeds
- Automatic message cleanup to avoid channel clutter
- Install Python 3.8 or higher
- Install dependencies:
pip install -r requirements.txt
2.1 Create Discord bot
Login to the discord developer website, create a new bot. (not going in detail)
- Configure the
.envfile with your settings:BOT_CHANNEL=your_discord_channel_id TV_CATEGORY=your_tv_category MOVIE_CATEGORY=your_movie_category QBIT_HOST=your_qbittorrent_host QBIT_PORT=your_qbittorrent_port QBIT_USERNAME=your_qbittorrent_username QBIT_PASSWORD=your_qbittorrent_password DISCORD_TOKEN=your_discord_bot_token - Run the bot:
python qbit_bot.py
$status- Show all torrents$status movies- Show movie torrents$status tv- Show TV show torrents$status completed- Show completed torrents$status downloading- Show downloading torrents$help- Show all available commands
You can combine filters, for example:
$status movies completed- Show completed movie torrents$status tv downloading- Show downloading TV show torrents
- Improved Error Handling: Comprehensive error handling and logging
- Security: Sensitive information stored in environment variables
- Clean Code: Object-oriented design with clear separation of concerns
- Better Formatting: Rich Discord embeds for better readability
- Performance: Efficient filtering and sorting of torrent lists
- Maintainability: Well-documented code with clear structure
Get a glimpse of how the bot operates with these screenshots:
When the help command is triggered, users see a structured list of available commands:
Real-time execution logs displayed directly in the server terminal:
How the bot interacts within a Discord channel:
