https://github.com/anlar/tewi
Text-based interface for BitTorrent clients (Transmission, qBittorrent, Deluge)
https://github.com/anlar/tewi
deluge python qbittorent textual torrent transmission tui
Last synced: 6 months ago
JSON representation
Text-based interface for BitTorrent clients (Transmission, qBittorrent, Deluge)
- Host: GitHub
- URL: https://github.com/anlar/tewi
- Owner: anlar
- License: gpl-3.0
- Created: 2024-10-04T14:55:14.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2025-12-19T21:37:26.000Z (6 months ago)
- Last Synced: 2025-12-20T04:11:31.529Z (6 months ago)
- Topics: deluge, python, qbittorent, textual, torrent, transmission, tui
- Language: Python
- Homepage:
- Size: 4.73 MB
- Stars: 127
- Watchers: 1
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt
Awesome Lists containing this project
README
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 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](https://github.com/Jackett/Jackett),
[Prowlarr](https://github.com/Prowlarr/Prowlarr) and
[bitmagnet](https://github.com/bitmagnet-io/bitmagnet)
integrations)
- Support for configuration files and different configuration profiles
### Built With
* [Python 3](https://www.python.org/)
* [Textual](https://textual.textualize.io/)
* [transmission-rpc](https://github.com/Trim21/transmission-rpc)
* [qbittorrent-api](https://github.com/rmartin16/qbittorrent-api)
* [pyperclip](https://github.com/asweigart/pyperclip)
## 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](https://github.com/anlar/tewi/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.