Skip to main content

Console UI for qBittorrent v4.1+

Project description


Console UI for qBittorrent. Functional...but a little rough around the edges...

qbittorrentui screenshot 1

qbittorrentui screensho 2t

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

Recommended Installation

$ pipx install qbittorrentui
$ pipx upgrade qbittorrentui  # to upgrade later on
$ qbittorrentui  # to launch the app
$ qbittorrentui --config_file qbtui_connections.ini

If running qbittorrentui doesn't start the application, run pipx ensurepath and open a new terminal window (or source your terminal's rc).


Install from pypi:

$ python3 -m venv ~/venv-qbittorrentui
$ source ~/venv-qbittorrentui/bin/activate && pip install qbittorrentui; deactivate

Once installed, this will run it:

$ source ~/venv-qbittorrentui/bin/activate && qbittorrentui; deactivate

Or install direct from master:

$ pip install -e git+
$ qbittorrentui

Although, I definitely recommend doing this within a virtual environment:

$ python3 -m venv ~/venv-qbittorrentui
$ source ~/venv-qbittorrentui/bin/activate && pip install -e git+; deactivate

Once installed, this will run it:

$ source ~/venv-qbittorrentui/bin/activate && qbittorrentui; deactivate

Installation Issues

  • Issues stemming from "#include <Python.h>":
    • sudo apt-get install python3-dev


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:

HOST = localhost
PORT = 8080
USERNAME = admin
PASSWORD = adminadmin

Only HOST, USERNAME, AND PASSWORD are required. DO_NOT_VERIFY_WEBUI_CERTIFICATE is necessary if the certificate is untrusted (e.g. self-signed).



  • <input type="checkbox" disabled="" /> Figure out the theme(s)
  • <input type="checkbox" checked="" disabled="" /> Configuration for connections
  • <input type="checkbox" disabled="" /> Log/activity output (likely above status bar)

Torrent List Window

  • <input type="checkbox" disabled="" /> Torrent sorting
  • <input type="checkbox" disabled="" /> Additional torrent filtering mechanisms
  • <input type="checkbox" disabled="" /> Torrent searching
  • <input type="checkbox" disabled="" /> Torrent status icon in torrent name
  • <input type="checkbox" disabled="" /> Torrent name color coding

Torrent Window

  • <input type="checkbox" disabled="" /> Make focus more obvious when switching between tabs list and a display
  • <input type="checkbox" disabled="" /> Scrollbar in the displays
  • <input type="checkbox" disabled="" /> Speed graph display

Torrent Window Content Display

  • <input type="checkbox" disabled="" /> Left key should return to tab list

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for qbittorrentui, version 0.2.3
Filename, size File type Python version Upload date Hashes
Filename, size qbittorrentui-0.2.3-py3-none-any.whl (93.8 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size qbittorrentui-0.2.3.tar.gz (81.5 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page