Skip to main content

Console UI for qBittorrent v4.1+

Project description

qBittorrenTUI

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

Installation

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+https://github.com/rmartin16/qbittorrentui.git#egg=qbittorrentui
$ 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+https://github.com/rmartin16/qbittorrentui.git#egg=qbittorrentui; 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

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)

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.

Source Distribution

qbittorrentui-0.1.2.tar.gz (35.4 kB view hashes)

Uploaded Source

Built Distribution

qbittorrentui-0.1.2-py3-none-any.whl (51.2 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page