4 stable releases

new 2.7.10 Apr 12, 2025

#1042 in Network programming

Download history

54 downloads per month

Apache-2.0

155KB
4K SLoC

trctl

AUR version Crate

A transmission daemon torrent client

  • Fast way to command common torrent actions such as querying/filtering, adding, starting, stopping, erasing and removing (with data).

  • Fast way to work with torrents in batches.

  • Makes it possible to directly send torrents to the transmission daemon from your web browser (desktop files included).

  • The torrents are added in a stopped state if the disk space would not be enough to hold all the downloading torrents when they are finished (taking account the chosen files).

  • Download directory is prefixed with the torrent hash to avoid name collisions.

  • A completion script for transmission daemon is included that moves the files from the download directory. Compared to transmission's default behavior it does not stop the torrent, avoids overwriting files with the same name, avoids filling the destination disk space and uses nicer IO.

Installing

  • Copy aur/PKGBUILD to project root, modify it as need and run makepkg

Setup

  • Configuration file is created in ~/.config/trctl for the cli and in /etc/trctl/completed.toml for the torrent completion script.
  • Configure transmission to user the provided completion script /usr/lib/trctl/completed.sh
  • Transmission daemon and the client used should use the torrent group created.

Developing

Generate completion file with:

trctl gen-completions zsh > _trctl

Similar projects

  • Stig provides both a text user interface and a command line interface. Is much more featureful than mine :D. Maybe it's not as fast to start as a python client however 😤. Haven't tried it.

  • Tremc is a resourceful curses client. It does not provide a command line interface however. I use it when I need to do see more information about the torrent or apply some more esoteric actions.

Attributes

Dependencies

~49–83MB
~1.5M SLoC