# 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).
mp;follow=1'>se-Soderhamn</a> (<a href='/dtv-scan-tables.git/log/dvb-t/se-Soderhamn?id=dd23b0f32c29ef9dba7792bb21917559eaa2fb7a&amp;showmsg=1'>unfollow</a>)</div><div class='content'><table class='list nowrap'><tr class='nohover'><th class='left'>Age</th><th class='left'>Commit message (<a href='/dtv-scan-tables.git/log/dvb-t/se-Soderhamn?id=dd23b0f32c29ef9dba7792bb21917559eaa2fb7a&amp;follow=1'>Collapse</a>)</th><th class='left'>Author</th><th class='left'>Files</th><th class='left'>Lines</th></tr>
<tr class='logheader'><td><span title='2010-06-24 20:55:50 +0200'>2010-06-24</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-t/ch-All?id=a0b3314ed75a0525ff6bbbb993ebedab520ab1ba&amp;follow=1'>update scan file for ch-All</a></td><td>Christoph Pfister</td><td>1</td><td><span class='deletions'>-0</span>/<span class='insertions'>+1</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
submitted by tkernen deckpoint.ch


</td></tr>
<tr class='logheader'><td><span title='2010-06-24 20:53:34 +0200'>2010-06-24</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-t/au-Brisbane?id=043041948fd70cfb0fff7f0a22aab88e76d0f903&amp;follow=1'>update scan file for au-Brisbane</a></td><td>Christoph Pfister</td><td>1</td><td><span class='deletions'>-0</span>/<span class='insertions'>+2</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
submitted by jrnorris gmail.com


</td></tr>
<tr class='logheader'><td><span title='2010-06-05 13:08:07 +0200'>2010-06-05</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-t/fr-Boulogne?id=2b01120aca3350e9583db1d84701b4e1ee775147&amp;follow=1'>update scan file for fr-Boulogne</a></td><td>Christoph Pfister</td><td>1</td><td><span class='deletions'>-10</span>/<span class='insertions'>+7</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
submitted by jean-michel-62 orange.fr


</td></tr>
<tr class='logheader'><td><span title='2010-06-01 16:25:03 +0200'>2010-06-01</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-t/de-Sachsen?id=49d65c4dae5cb636700d229432acc7b4ad72f599&amp;follow=1'>update scan file for de-Sachsen</a></td><td>Christoph Pfister</td><td>1</td><td><span class='deletions'>-1</span>/<span class='insertions'>+1</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
</td></tr>
<tr class='logheader'><td><span title='2010-06-01 16:19:36 +0200'>2010-06-01</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-t/de-Schleswig-Holstein?id=26b9cce5bafcb20382c6f058f8b14908530b6962&amp;follow=1'>update scan files for de-*</a></td><td>Christoph Pfister</td><td>10</td><td><span class='deletions'>-32</span>/<span class='insertions'>+32</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
</td></tr>
<tr class='logheader'><td><span title='2010-05-24 09:48:31 +0200'>2010-05-24</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-t/fr-Chambery?id=904592bec8c55eb4ec8611dc0972b49136f72d8f&amp;follow=1'>update scan file for fr-Chambery</a></td><td>Christoph Pfister</td><td>1</td><td><span class='deletions'>-24</span>/<span class='insertions'>+18</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
submitted by n_estre yahoo.fr


</td></tr>
<tr class='logheader'><td><span title='2010-05-23 21:09:01 +0200'>2010-05-23</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-t/fr-Nantes?id=9186f2bd35f5b806417b225ec8635cfd70002ab7&amp;follow=1'>update scan file for fr-Nantes</a></td><td>Christoph Pfister</td><td>1</td><td><span class='deletions'>-6</span>/<span class='insertions'>+7</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
submitted by biribi free.fr


</td></tr>
<tr class='logheader'><td><span title='2010-05-23 20:57:15 +0200'>2010-05-23</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-t/fr-LilleT2?id=7eddeacf362f84e083456ea5283d214abbf753e4&amp;follow=1'>update scan file for fr-Lille-Bouvigny</a></td><td>Christoph Pfister</td><td>3</td><td><span class='deletions'>-43</span>/<span class='insertions'>+26</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
and remove obsoleted files
submitted by romain romain-bajeux.com


</td></tr>
<tr class='logheader'><td><span title='2010-05-19 15:12:16 +0200'>2010-05-19</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-t/fr-Laval?id=d37092e2e3ccf7d3e112ab6841fad6b6c1951d99&amp;follow=1'>update scan file for fr-Laval</a></td><td>Christoph Pfister</td><td>1</td><td><span class='deletions'>-6</span>/<span class='insertions'>+6</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
submitted by hftom free.fr


</td></tr>
<tr class='logheader'><td><span title='2010-05-19 15:11:21 +0200'>2010-05-19</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-t/fr-Nantes?id=37b4c23540fad6d9e13196c48e18a45221a83ca6&amp;follow=1'>update scan file for fr-Nantes</a></td><td>Christoph Pfister</td><td>1</td><td><span class='deletions'>-6</span>/<span class='insertions'>+6</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
submitted by matpic free.fr


</td></tr>
<tr class='logheader'><td><span title='2010-05-16 13:41:50 +0200'>2010-05-16</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-t/de-Hamburg?id=d3e09ad270b967ca7314ed9aac9a507a042a1db3&amp;follow=1'>update scan file for de-Hamburg</a></td><td>Christoph Pfister</td><td>1</td><td><span class='deletions'>-0</span>/<span class='insertions'>+1</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
submitted by toralf.foerster gmx.de


</td></tr>
<tr class='logheader'><td><span title='2010-05-09 08:03:42 +0200'>2010-05-09</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-c/de-Unitymedia?id=9301ff664beb97e52b1f9b8094243e58a25ce564&amp;follow=1'>update scan file for de-Unitymedia</a></td><td>Christoph Pfister</td><td>1</td><td><span class='deletions'>-8</span>/<span class='insertions'>+9</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
</td></tr>
<tr class='logheader'><td><span title='2010-05-02 10:31:40 +0200'>2010-05-02</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-t/hr-All?id=032ee79040d0735d77fc731fb581a6e23cd30795&amp;follow=1'>update scan file for hr-All</a></td><td>Christoph Pfister</td><td>1</td><td><span class='deletions'>-1</span>/<span class='insertions'>+1</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
submitted by samuel.rakitnican gmail.com


</td></tr>
<tr class='logheader'><td><span title='2010-04-29 20:08:19 +0200'>2010-04-29</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-c/de-Primacom?id=5c1672bd77b1e3bbe0c5f09feef834a3cc4ef9fe&amp;follow=1'>update scan file for de-Primacom</a></td><td>Christoph Pfister</td><td>1</td><td><span class='deletions'>-0</span>/<span class='insertions'>+5</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
submitted by robert.wohlrab gmx.de


</td></tr>
<tr class='logheader'><td><span title='2010-04-29 19:49:03 +0200'>2010-04-29</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-t/dk-All?id=58721baa6ca5d82266bdebbbc3d8844b43bacf95&amp;follow=1'>update scan file for dk-All</a></td><td>Christoph Pfister</td><td>1</td><td><span class='deletions'>-5</span>/<span class='insertions'>+11</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
submitted by rk.katana.steel gmail.com


</td></tr>
<tr class='logheader'><td><span title='2010-04-29 19:35:48 +0200'>2010-04-29</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-c/fi-Turku?id=160ec6c23d179386e93b9a2b9e47c70e82624e4d&amp;follow=1'>update scan file for fi-Turku</a></td><td>Christoph Pfister</td><td>1</td><td><span class='deletions'>-1</span>/<span class='insertions'>+7</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
submitted by miika vesti.fi


</td></tr>
<tr class='logheader'><td><span title='2010-04-29 19:33:41 +0200'>2010-04-29</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-t/uk-Aberdare?id=86afec38201da643508c408b63fbb986fa921c30&amp;follow=1'>update scan file for uk-Aberdare</a></td><td>Christoph Pfister</td><td>1</td><td><span class='deletions'>-10</span>/<span class='insertions'>+15</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
submitted by redtux1 googlemail.com


</td></tr>
<tr class='logheader'><td><span title='2010-04-29 19:30:40 +0200'>2010-04-29</span></td><td class='logsubject'><a href='/dtv-scan-tables.git/commit/dvb-t/fr-Nantes?id=6316f85cd1c5c79225453253bb87fef3e91bad0d&amp;follow=1'>update scan file for fr-Nantes</a></td><td>Christoph Pfister</td><td>1</td><td><span class='deletions'>-6</span>/<span class='insertions'>+6</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
submitted by debotux gmail.com


</td></tr>