qBittorrenTUI
Console UI for qBittorrent. Not feature-complete but is usable for low volume and everyday torrenting.
Key Map
Any Window
- q : exit
- n : open connection dialog
Torrent List Window
- a : open add torrent dialog
- enter : open context menu for selected torrent
- right arrow: open Torrent Window
Torrent Window
- left : return to Torrent List
- esc : return to Torrent List
- Content
- enter : bump priority
- space : bump priority
Installation
Install from pypi:
pip install qbittorrentuiIn most cases, this should allow you to run the application simply with the qbittorrentui command. Alternatively, you can specify a specific python binary with ./venv/bin/python -m qbittorrentui or similar.
Configuration
Connections can be pre-defined within a configuration file (modeled after default.ini). Specify the configuration file using --config_file. Each section in the file will be presented as a separate instance to connect to.
Sample configuration file section:
[localhost:8080]
HOST = localhost
PORT = 8080
USERNAME = admin
PASSWORD = adminadmin
CONNECT_AUTOMATICALLY = 1
TIME_AFTER_CONNECTION_FAILURE_THAT_CONNECTION_IS_CONSIDERED_LOST = 5
TORRENT_CONTENT_MAX_FILENAME_LENGTH = 75
TORRENT_LIST_MAX_TORRENT_NAME_LENGTH = 60
TORRENT_LIST_PROGRESS_BAR_LENGTH = 40
DO_NOT_VERIFY_WEBUI_CERTIFICATE = 1
Only HOST, USERNAME, AND PASSWORD are required. DO_NOT_VERIFY_WEBUI_CERTIFICATE is necessary if the certificate is untrusted (e.g. self-signed).
TODO/Wishlist
Application
- Figure out the theme(s)
- Configuration for connections
- Log/activity output (likely above status bar)
- Implement window for editing qBittorrent settings
Torrent List Window
- Torrent sorting
- Additional torrent filtering mechanisms
- Torrent searching
- Torrent status icon in torrent name
- Torrent name color coding
- Torrent list column configuration
Torrent Window
- Make focus more obvious when switching between tabs list and a display
- Scrollbar in the displays
- Speed graph display
Torrent Window Content Display
- Left key should return to tab list