# 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).
c5c7ecd9800e86882af4476e2dc6098b78cfb&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='/lcd4linux.git/log/widget_text.h?h=master&amp;id=a97c5c7ecd9800e86882af4476e2dc6098b78cfb&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='2008-09-03 03:28:52 +0000'>2008-09-03</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/smoketest.sh?h=master&amp;id=e6f31f6b7949440cd735d0184c846aa2a3330f23&amp;follow=1'>ULA200 driver by Bernhard Walle</a></td><td>michael</td><td>7</td><td><span class='deletions'>-2</span>/<span class='insertions'>+825</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@892 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2008-09-03 03:26:29 +0000'>2008-09-03</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/drv_D4D.c?h=master&amp;id=1285008c5f75c28d6304ba984c432992c450ba3a&amp;follow=1'>indent</a></td><td>michael</td><td>1</td><td><span class='deletions'>-4</span>/<span class='insertions'>+4</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@891 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2008-08-31 18:27:53 +0000'>2008-08-31</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/drv_generic_serial.c?h=master&amp;id=02b0138a4213eff843990f96531cf31918d6dfe2&amp;follow=1'>Increased the maximum bps to 230400, if defined in &lt;termios.h&gt;.</a></td><td>sonic74</td><td>1</td><td><span class='deletions'>-2</span>/<span class='insertions'>+7</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@890 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2008-08-27 22:32:47 +0000'>2008-08-27</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/drv_D4D.c?h=master&amp;id=9e0932674b6e85098e3902f4c3083e80c9590be5&amp;follow=1'>git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@889 ↵</a></td><td>sonic74</td><td>1</td><td><span class='deletions'>-18</span>/<span class='insertions'>+11</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2008-08-27 03:30:06 +0000'>2008-08-27</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/drv_D4D.c?h=master&amp;id=b645e0908429a1ed5c61f2708931bfa026254d52&amp;follow=1'>D4D updates by Sven</a></td><td>michael</td><td>1</td><td><span class='deletions'>-38</span>/<span class='insertions'>+60</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@888 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2008-08-03 03:10:49 +0000'>2008-08-03</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/smoketest.sh?h=master&amp;id=38367abf672c32015cacd8b469c390a048f2c97f&amp;follow=1'>driver for 4D Systems serial displays by Sven Killig</a></td><td>michael</td><td>9</td><td><span class='deletions'>-45</span>/<span class='insertions'>+846</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@887 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2008-08-03 02:44:22 +0000'>2008-08-03</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/drv_IRLCD.c?h=master&amp;id=e91cbd072ab678b68095a5e81fc37df6ae44c975&amp;follow=1'>signed/unsigned mismatch</a></td><td>michael</td><td>1</td><td><span class='deletions'>-3</span>/<span class='insertions'>+3</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@886 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2008-07-26 14:41:51 +0000'>2008-07-26</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/plugin_mpd.c?h=master&amp;id=58d42c80d71e628ddf8fc32cae477f17cb3a3f25&amp;follow=1'>added command functions</a></td><td>michux</td><td>1</td><td><span class='deletions'>-2</span>/<span class='insertions'>+130</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@885 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2008-07-15 10:22:19 +0000'>2008-07-15</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/svn_version.h?h=master&amp;id=b243fddf0754e8d193febc0598941fd1638ff33b&amp;follow=1'>added IRLCD driver by Jean-Philippe Civade</a></td><td>michael</td><td>10</td><td><span class='deletions'>-5</span>/<span class='insertions'>+467</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@884 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2008-07-15 09:55:18 +0000'>2008-07-15</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/mkinstalldirs?h=master&amp;id=38a69aee81b48e2df7714310c39b5cdf171b9123&amp;follow=1'>'autoreconf -f -i' run &amp; config.rpath added</a></td><td>michael</td><td>8</td><td><span class='deletions'>-370</span>/<span class='insertions'>+1617</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@883 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>