## About

A console client for the BitTorrent client [Transmission](http://www.transmissionbt.com/ "Transmission Homepage").


## Distributions

- [Arch Linux](https://aur.archlinux.org/packages.php?K=transmission-remote-cli)
- [Debian](http://packages.debian.org/search?keywords=transmission-remote-cli)
- [Fedora](https://admin.fedoraproject.org/pkgdb/acls/list/?searchwords=transmission-remote-cli)
- [OpenSUSE](http://software.opensuse.org/package/transmission-remote-cli?search_term=transmission-remote-cli)
- [Ubuntu](http://packages.ubuntu.com/search?keywords=transmission-remote-cli)


## Requirements

For Python 2.5 or older, you need [simplejson](http://pypi.python.org/pypi/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`.


## Usage

### Connection information

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

You can write this (and other) stuff into a configuration file:  
`$ transmission-remote-cli -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:  
`$ transmission-remote-cli -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:  
`$ transmission-remote-cli -- -l`  
`$ transmission-remote-cli -- -t 2 -i`  
`$ transmission-remote-cli -- -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 transmission-remote-cli.

`$ transmission-remote-cli http://link/to/file.torrent`  
`$ transmission-remote-cli path/to/some/torrent-file`


## Screenshots

![Main window - full, v1.3](https://github.com/fagga/transmission-remote-cli/raw/master/screenshots/screenshot-mainfull-v1.3.png)

![Main window - compact, v1.3](https://github.com/fagga/transmission-remote-cli/raw/master/screenshots/screenshot-maincompact-v1.3.png)

![Info window, v1.3](https://github.com/fagga/transmission-remote-cli/raw/master/screenshots/screenshot-details-v1.3.png)


## Copyright

Released under the GPLv3 license, see [COPYING](transmission-remote-cli/blob/master/COPYING) for details.


## Contact

Feel free to request new features or provide bug reports.  
You can find my email address [here](http://github.com/fagga).
</span></td></tr>
<tr><td><span title='2024-01-30 17:06:37 +0100'>2024-01-30</span></td><td><a href='/dtv-scan-tables.git/commit/dvb-t/uk-WinterHill?id=fca403cc92717328bccb3b2a4c747a474632c0da&amp;follow=1'>dtv-scan-tables: full uk transmitter update</a></td><td>Simon Liddicott</td><td>81</td><td><span class='deletions'>-500</span>/<span class='insertions'>+163</span></td></tr>
<tr><td><span title='2022-11-25 11:46:20 +0000'>2022-11-25</span></td><td><a href='/dtv-scan-tables.git/commit/dvb-c/hu-Digikabel?id=833d4cc1dddb3560e93ef7dc6951ab5c204b5c13&amp;follow=1'>dtv-scan-tables: hu-Digikabel changes</a></td><td>Hrotkó Gábor</td><td>1</td><td><span class='deletions'>-1</span>/<span class='insertions'>+26</span></td></tr>
<tr><td><span title='2022-04-30 16:02:58 +0100'>2022-04-30</span></td><td><a href='/dtv-scan-tables.git/commit/dvb-t/pt-All?id=57ed2982275045ea5e92ef2a40b9fa58255852e5&amp;follow=1'>pt-All: fix modulation</a></td><td>Mauro Carvalho Chehab</td><td>1</td><td><span class='deletions'>-10</span>/<span class='insertions'>+10</span></td></tr>
<tr><td><span title='2022-04-30 15:50:08 +0100'>2022-04-30</span></td><td><a href='/dtv-scan-tables.git/commit/dvb-t/pt-All?id=5f7b549da3c7ed1e9dfe4fcbbda742a9d7ee5aec&amp;follow=1'>pt-All: Update Portugal channels</a></td><td>Mauro Carvalho Chehab</td><td>1</td><td><span class='deletions'>-34</span>/<span class='insertions'>+70</span></td></tr>
<tr><td><span title='2022-03-07 17:34:29 +0100'>2022-03-07</span></td><td><a href='/dtv-scan-tables.git/commit/isdb-t/br-to-Palmas?id=e403f83644167e240668c0668a8de04532060683&amp;follow=1'>Update Brazilian ISDB-T tables</a></td><td>Mauro Carvalho Chehab</td><td>549</td><td><span class='deletions'>-2923</span>/<span class='insertions'>+13860</span></td></tr>
<tr><td><span title='2022-03-07 17:05:00 +0100'>2022-03-07</span></td><td><a href='/dtv-scan-tables.git/commit/dvb-s/Intelsat-38-45.1E?id=0eb034356d9699799ed8633ac3fe01622d39e6ff&amp;follow=1'>Update satellite channel lists from Lyngsat</a></td><td>Mauro Carvalho Chehab</td><td>54</td><td><span class='deletions'>-1882</span>/<span class='insertions'>+2326</span></td></tr>
<tr><td><span title='2021-12-14 12:36:28 +0100'>2021-12-14</span></td><td><a href='/dtv-scan-tables.git/commit/dvb-t/uk-WinterHill?id=5acecf65ccd5633c50b8c199cce50fb734635097&amp;follow=1'>dtv-scan-tables: latest UK changes</a></td><td>Simon Liddicott</td><td>4</td><td><span class='deletions'>-24</span>/<span class='insertions'>+24</span></td></tr>
<tr><td><span title='2021-04-30 21:33:05 +0200'>2021-04-30</span></td><td><a href='/dtv-scan-tables.git/commit/isdb-t/br-to-Tupirama?id=25ee9e0ce4bbacdb278d4cff306ceb6528c4f548&amp;follow=1'>update Brazilian scan files</a></td><td>Mauro Carvalho Chehab</td><td>2476</td><td><span class='deletions'>-12805</span>/<span class='insertions'>+69312</span></td></tr>
<tr><td><span title='2021-04-30 13:29:02 +0200'>2021-04-30</span></td><td><a href='/dtv-scan-tables.git/commit/dvb-s/Yamal201-90.0E?id=66ec1eabbf6a596b42f6d4802b6aead3e8ba1ad5&amp;follow=1'>Remove legacy entries</a></td><td>Mauro Carvalho Chehab</td><td>129</td><td><span class='deletions'>-24898</span>/<span class='insertions'>+0</span></td></tr>
<tr><td><span title='2021-04-30 13:28:58 +0200'>2021-04-30</span></td><td><a href='/dtv-scan-tables.git/commit/dvb-s/Yamal-601-49.0E?id=f46e7874dd45f03f47b31e8cd56108f3f10711f8&amp;follow=1'>Add new satellites from Lyngsat</a></td><td>Mauro Carvalho Chehab</td><td>75</td><td><span class='deletions'>-21</span>/<span class='insertions'>+29721</span></td></tr>
<tr><td><span title='2021-04-30 10:31:15 +0200'>2021-04-30</span></td><td><a href='/dtv-scan-tables.git/commit/dvb-s/Intelsat-38-45.1E?id=137a4b9176f8fb074c955a49ae97865d2fb85095&amp;follow=1'>Rename a few satellites with two names and update frequencies</a></td><td>Mauro Carvalho Chehab</td><td>2</td><td><span class='deletions'>-283</span>/<span class='insertions'>+182</span></td></tr>
<tr><td><span title='2021-04-30 10:29:42 +0200'>2021-04-30</span></td><td><a href='/dtv-scan-tables.git/commit/dvb-s/Yamal-402-54.9E?id=cf6e4b502139112c82f092001eb6b9ac3912182a&amp;follow=1'>Update frequencies from Lyngsat</a></td><td>Mauro Carvalho Chehab</td><td>188</td><td><span class='deletions'>-12304</span>/<span class='insertions'>+12666</span></td></tr>