Description
This pull request introduces QBittorrentBot v3 updates, including significant code refactoring and a full documentation overhaul to reflect the new architecture, configuration format, and runtime behavior.
Highlights
Code changes
- Reworked large parts of the codebase for better structure and maintainability
- Migrated the Telegram layer to Aiogram (fully async)
- Removed deprecated Pyrogram dependency
- Replaced database usage with Redis for runtime state and caching
- Added support for automatic configuration reload
- Switched project and dependency management to UV
- Simplified Telegram authentication (bot token only)
Documentation updates
- Updated README to reflect v3 architecture
- Migrated docs from JSON to YAML configuration
- Added multiple configuration examples (with and without Redis)
- Updated Docker Compose instructions (example in
docker/folder) - Clarified config auto-reload behavior and restart requirements
- Updated FAQ, migration guide, and proxy configuration docs
- Removed outdated references (api_id/api_hash, Pyrogram)
Breaking changes
- Configuration file is now
config.ymlinstead ofconfig.json - Redis replaces the database layer (optional but recommended)
- Telegram authentication now requires only the bot token
- Old configuration files are automatically migrated
Motivation
This release modernizes QBittorrentBot by:
- Adopting a fully async Telegram stack
- Simplifying configuration and deployment
- Improving runtime reliability and scalability
- Aligning documentation with actual behavior
Notes
- This PR includes both code and documentation changes
- Some features (FSM, i18n improvements, async client manager) are planned and documented but not yet implemented
What's Changed
- Bump urllib3 from 2.1.0 to 2.2.2 by @dependabot[bot] in #57
- Bump requests from 2.31.0 to 2.32.0 by @dependabot[bot] in #56
- Bump tqdm from 4.66.1 to 4.66.3 by @dependabot[bot] in #55
- Bump idna from 3.6 to 3.7 by @dependabot[bot] in #54
- Bump certifi from 2023.11.17 to 2024.7.4 by @dependabot[bot] in #58
- Create es.json by @ch3p4ll3 in #59
- Bump requests from 2.32.0 to 2.32.4 by @dependabot[bot] in #60
- Bump urllib3 from 2.2.2 to 2.5.0 by @dependabot[bot] in #61
- Migrate to Aiogram library by @ch3p4ll3 in #71
Full Changelog: V2.1...V3.0.0