Tewi

Text-based interface for BitTorrent clients (Transmission, qBittorrent, Deluge)

About

[!IMPORTANT] The PyPI package has been renamed from tewi-transmission to tewi-torrent to reflect multi-client support. If you have the old package installed, please uninstall it first. Future updates will be published only in tewi-torrent.

Tewi Screen Shot

Tewi is a TUI (text user interface) for BitTorrent clients, supporting Transmission, qBittorrent and Deluge daemons.

Features:

Connect to Transmission/qBittorrent/Deluge daemon by credentials
Browse torrents list
Different view modes: card, compact, oneline
Display torrent details: overview, files, trackers, peers
View and edit torrent categories and labels
Add new torrents
Torrent actions: start/pause, remove/trash, verify, reannounce, change priority
View and toggle alternative speed limits
View session statistics
View torrent client preferences
Dark and light color themes
Search torrents on popular trackers (built-in search providers, Jackett, Prowlarr and bitmagnet integrations)
Support for configuration files and different configuration profiles

Built With

Getting Started

Prerequisites

Tewi requires Python 3.10+.

Installation

Recommended way to install is to use pipx, pip, or uv:

$ pipx install tewi-torrent

$ pip install tewi-torrent

$ uv tool install tewi-torrent

Usage

Launch Tewi from command line:

$ tewi

By default it connects to Transmission daemon on http://localhost:9091. To change these settings you could specify your connection details:

$ tewi --host XXXX --port XXXX

To connect to qBittorrent instead of Transmission:

$ tewi --client-type qbittorrent --port 8080

Check other command line options using help command:

$ tewi --help

View available hot-keys in Tewi by pressing ? key.

Roadmap

See the open issues for a full list of proposed features (and known issues).

Contributing

Feel free to open bug reports and send pull requests.

License

Distributed under the GPL3+ license. See LICENSE.txt for more information.

Release files for tewi-transmission 2.3.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for tewi-transmission 2.3.1
File	Size	Uploaded
tewi_transmission-2.3.1.tar.gz	135.9 kB	Jan 8, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for tewi-transmission 2.3.1
File	Interpreter	ABI	Platform	Reset
tewi_transmission-2.3.1-py3-none-any.whl 152.1 kB Jan 8, 2026	Python 3	none	any	Details

Total release size:288.0 kB

Release files / tewi_transmission-2.3.1.tar.gz

Download URL	tewi_transmission-2.3.1.tar.gz
Size	135.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`4ee1881c377cc4a7fa0dfd5f916d8c2e7253ee870ba1c75462be48c60c81d305`
BLAKE2b-256 checksum How to use checksums	`e595de9ee76fe08a178655c7137669e6fab7af32b7796991bc80ac134c677aec`
Upload date	Jan 8, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.12.3`

Release files / tewi_transmission-2.3.1-py3-none-any.whl

Download URL	tewi_transmission-2.3.1-py3-none-any.whl
Size	152.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`b809d4eccd8ee353738d904562d543ac1d74929622b7d9007e259fbba6c1db4c`
BLAKE2b-256 checksum How to use checksums	`93874e2f68ccaaab86f9ad8596b71023e6b93df352d3cd256503b125bd8c8a92`
Upload date	Jan 8, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.12.3`