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

**Download the latest version for [Transmission 1.90-2.50](http://github.com/fagga/transmission-remote-cli/raw/master/transmission-remote-cli.py).**


## Modules

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`.


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

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

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


## Contact
Feel free to request new features or provide bug reports.  
You can find my email address [here](http://github.com/fagga).
lass='left'>Author</th><th class='left'>Files</th><th class='left'>Lines</th></tr>
<tr><td><span title='2005-04-01 05:16:04 +0000'>2005-04-01</span></td><td><a href='/lcd4linux.git/commit/plugin_pop3.c?id=db07da0b72602a70c23ed10e4bface19ed029bc8&amp;follow=1'>[lcd4linux @ 2005-04-01 05:16:04 by reinelt]</a></td><td>reinelt</td><td>5</td><td><span class='deletions'>-584</span>/<span class='insertions'>+694</span></td></tr>
<tr><td><span title='2005-03-30 04:57:50 +0000'>2005-03-30</span></td><td><a href='/lcd4linux.git/commit/plugin_cfg.c?id=f650bc134e5e1db71498bd4504a98331a99993d2&amp;follow=1'>[lcd4linux @ 2005-03-30 04:57:50 by reinelt]</a></td><td>reinelt</td><td>3</td><td><span class='deletions'>-23</span>/<span class='insertions'>+67</span></td></tr>
<tr><td><span title='2005-03-28 22:29:23 +0000'>2005-03-28</span></td><td><a href='/lcd4linux.git/commit/drv_HD44780.c?id=5985c204a32bd6b9f69646dbe6110ffa0c55651b&amp;follow=1'>[lcd4linux @ 2005-03-28 22:29:23 by reinelt]</a></td><td>reinelt</td><td>1</td><td><span class='deletions'>-250</span>/<span class='insertions'>+346</span></td></tr>
<tr><td><span title='2005-03-28 19:39:23 +0000'>2005-03-28</span></td><td><a href='/lcd4linux.git/commit/drv_generic_i2c.h?id=36b9cd6acd0607f0b9ae8b58ef74a12786faf938&amp;follow=1'>[lcd4linux @ 2005-03-28 19:39:14 by reinelt]</a></td><td>reinelt</td><td>9</td><td><span class='deletions'>-256</span>/<span class='insertions'>+1147</span></td></tr>
<tr><td><span title='2005-03-25 15:44:43 +0000'>2005-03-25</span></td><td><a href='/lcd4linux.git/commit/drv_HD44780.c?id=b6dd247d8ae45694367c16be7fae65f084a18961&amp;follow=1'>[lcd4linux @ 2005-03-25 15:44:43 by reinelt]</a></td><td>reinelt</td><td>1</td><td><span class='deletions'>-2</span>/<span class='insertions'>+5</span></td></tr>
<tr><td><span title='2005-03-23 12:23:35 +0000'>2005-03-23</span></td><td><a href='/lcd4linux.git/commit/drv_Crystalfontz.c?id=93f4190b076c528589fe1f32a10b4ce346e999fe&amp;follow=1'>[lcd4linux @ 2005-03-23 12:23:35 by reinelt]</a></td><td>reinelt</td><td>1</td><td><span class='deletions'>-27</span>/<span class='insertions'>+32</span></td></tr>
<tr><td><span title='2005-02-24 07:07:55 +0000'>2005-02-24</span></td><td><a href='/lcd4linux.git/commit/ChangeLog?id=ff0c5aa7ccb600afb68af5f4c865ab2a3c91630a&amp;follow=1'>[lcd4linux @ 2005-02-24 07:07:55 by reinelt]</a></td><td>reinelt</td><td>1</td><td><span class='deletions'>-0</span>/<span class='insertions'>+53</span></td></tr>
<tr><td><span title='2005-02-24 07:06:48 +0000'>2005-02-24</span></td><td><a href='/lcd4linux.git/commit/lcd4linux.conf.sample?id=b8d041d37641f40b4a093fb0e712f6dbd12f662b&amp;follow=1'>[lcd4linux @ 2005-02-24 07:06:45 by reinelt]</a></td><td>reinelt</td><td>11</td><td><span class='deletions'>-28</span>/<span class='insertions'>+347</span></td></tr>
<tr><td><span title='2005-02-24 06:51:40 +0000'>2005-02-24</span></td><td><a href='/lcd4linux.git/commit/drv_LCDLinux.c?id=865a7df05b49209d0551a4df87fceba434d3cb2c&amp;follow=1'>[lcd4linux @ 2005-02-24 06:51:40 by reinelt]</a></td><td>reinelt</td><td>1</td><td><span class='deletions'>-4</span>/<span class='insertions'>+5</span></td></tr>
<tr><td><span title='2005-01-30 06:43:22 +0000'>2005-01-30</span></td><td><a href='/lcd4linux.git/commit/lcd4linux.conf.sample?id=a086667aad27e4a615bf5f521a516ef533dd9618&amp;follow=1'>[lcd4linux @ 2005-01-30 06:43:22 by reinelt]</a></td><td>reinelt</td><td>4</td><td><span class='deletions'>-69</span>/<span class='insertions'>+95</span></td></tr>
<tr><td><span title='2005-01-29 09:30:56 +0000'>2005-01-29</span></td><td><a href='/lcd4linux.git/commit/drv_HD44780.c?id=575f363d88d793449679641941bd42f5b50d3503&amp;follow=1'>[lcd4linux @ 2005-01-29 09:30:56 by reinelt]</a></td><td>reinelt</td><td>1</td><td><span class='deletions'>-8</span>/<span class='insertions'>+11</span></td></tr>
<tr><td><span title='2005-01-22 22:57:57 +0000'>2005-01-22</span></td><td><a href='/lcd4linux.git/commit/lcd4linux.conf.sample?id=620568e08f7e1e7be5d3be85643f821cdcca897b&amp;follow=1'>[lcd4linux @ 2005-01-22 22:57:57 by reinelt]</a></td><td>reinelt</td><td>9</td><td><span class='deletions'>-47</span>/<span class='insertions'>+382</span></td></tr>
<tr><td><span title='2005-01-22 12:44:41 +0000'>2005-01-22</span></td><td><a href='/lcd4linux.git/commit/drv_MatrixOrbital.c?id=4b6f7fb1f11af97b369feb39aa4c4ac16252045a&amp;follow=1'>[lcd4linux @ 2005-01-22 12:44:41 by reinelt]</a></td><td>reinelt</td><td>1</td><td><span class='deletions'>-3</span>/<span class='insertions'>+6</span></td></tr>
<tr><td><span title='2005-01-18 06:30:24 +0000'>2005-01-18</span></td><td><a href='/lcd4linux.git/commit/widget_text.h?id=ae6d2a0a265f41e9c9773d61dcf16da3653b674e&amp;follow=1'>[lcd4linux @ 2005-01-18 06:30:21 by reinelt]</a></td><td>reinelt</td><td>89</td><td><span class='deletions'>-261</span>/<span class='insertions'>+603</span></td></tr>
<tr><td><span title='2005-01-17 06:38:48 +0000'>2005-01-17</span></td><td><a href='/lcd4linux.git/commit/drv_HD44780.c?id=1f29316bdf4df65aed92770d0c440e0984ef1086&amp;follow=1'>[lcd4linux @ 2005-01-17 06:38:48 by reinelt]</a></td><td>reinelt</td><td>1</td><td><span class='deletions'>-1</span>/<span class='insertions'>+6</span></td></tr>
<tr><td><span title='2005-01-17 06:29:25 +0000'>2005-01-17</span></td><td><a href='/lcd4linux.git/commit/lcd4linux.conf.sample?id=f25e145be4d7ebe0c3b6803acf8521d5b2d8b1a1&amp;follow=1'>[lcd4linux @ 2005-01-17 06:29:24 by reinelt]</a></td><td>reinelt</td><td>3</td><td><span class='deletions'>-33</span>/<span class='insertions'>+85</span></td></tr>