About

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

• Python 3
• Textual
• transmission-rpc
• qbittorrent-api
• platformdirs
• shtab
• geoip2fast (optional, used for peer country lookup)
• pyperclip (optional, used for pasting links from clipboard when adding torrents)

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

Shell completion

The package ships a pre-generated bash completion script as an installer data file (share/bash-completion/completions/tewi).

If you install Tewi with pipx or pip into a prefix your shell already scans for completions (e.g. a system-wide install), it's picked up automatically.

For any other install method, or for zsh/tcsh, generate the script manually with --print-completion and install it into your user data directory (XDG $XDG_DATA_HOME, ~/.local/share by default). Tewi supports bash, zsh, and tcsh.

For bash (loaded automatically by bash-completion in new shells):

$ mkdir -p "${XDG_DATA_HOME:-$HOME/.local/share}/bash-completion/completions"
$ tewi --print-completion bash > \
    "${XDG_DATA_HOME:-$HOME/.local/share}/bash-completion/completions/tewi"

For zsh:

$ mkdir -p "${XDG_DATA_HOME:-$HOME/.local/share}/zsh/site-functions"
$ tewi --print-completion zsh > \
    "${XDG_DATA_HOME:-$HOME/.local/share}/zsh/site-functions/_tewi"

If that directory is not in your fpath yet, add it to ~/.zshrc before compinit is called:

fpath=("${XDG_DATA_HOME:-$HOME/.local/share}/zsh/site-functions" $fpath)

The generated script is static: re-generate it after upgrading Tewi to pick up new command line options.

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.