Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Curses interface for the daemon of the BitTorrent client Transmission
Python Other
Fetching latest commit...
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

A console client for the BitTorrent client Transmission.

Download the latest version for Transmission 1.90-2.50.


For Python 2.5 or older, you need simplejson which should be packaged in any Linux distribution. The Debian/Ubuntu package is called python-simplejson.

Optional Modules (you don't need them but they add features):

  • GeoIP: Guess which country peers come from.
  • adns: Resolve IPs to host names.

Debian/Ubuntu package names are python-adns and python-geoip.

Connection information

Authentication and host/port can be set via command line with one of these patterns:
$ -c homeserver
$ -c homeserver:1234
$ -c johndoe:secretbirthday@homeserver
$ -c johndoe:secretbirthday@homeserver:1234

You can write this (and other) stuff into a configuration file:
$ -c johndoe:secretbirthday@homeserver:1234 --create-config

No configuration file is created automatically, you have to do this somehow. However, if the file exists, it is re-written when trcli exits to remember some settings. This means you shouldn't have trcli running when editing your configuration file.

If you don't like the default configuration file path ~/.config/transmission-remote-cli/settings.cfg, change it:
$ -f ~/.trclirc --create-config

Calling transmission-remote

transmission-remote-cli forwards all arguments after '--' to transmission-remote. This is useful if your daemon requires authentication and/or doesn't listen on the default localhost:9091 for instructions. transmission-remote-cli reads HOST:PORT and authentication from the config file and forwards them on to transmission-remote, along with your arguments.

Some examples:
$ -- -l
$ -- -t 2 -i
$ -- -as

Add torrents

If you provide only one command line argument and it doesn't start with '-', it's treated like a torrent file/URL and submitted to the daemon via transmission-remote. This is useful because you can instruct Firefox to open torrent files with

$ http://link/to/file.torrent
$ path/to/some/torrent-file


Feel free to request new features or provide bug reports.
You can find my email address here.

Something went wrong with that request. Please try again.