Skip to content

rmartin16/qbittorrentui

Repository files navigation

qBittorrenTUI

PyPI PyPI - Python Version

Console UI for qBittorrent. Not feature-complete but is usable for low volume and everyday torrenting.

qbittorrentui screenshot 1

qbittorrentui screensho 2

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 qbittorrentui

In 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