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).



  • [ ] Figure out the theme(s)
  • [x] Configuration for connections
  • [ ] Log/activity output (likely above status bar)

Torrent List Window

  • [ ] Torrent sorting
  • [ ] Additional torrent filtering mechanisms
  • [ ] Torrent searching
  • [ ] Torrent status icon in torrent name
  • [ ] Torrent name color coding

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

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.1.2
Filename, size File type Python version Upload date Hashes
Filename, size qbittorrentui-0.1.2-py3-none-any.whl (51.2 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size qbittorrentui-0.1.2.tar.gz (35.4 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page