Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Fetching contributors…

Cannot retrieve contributors at this time

105 lines (93 sloc) 3.749 kB
.Dd Oct 25, 2011
.Nm transmission-remote-cli
.Nd a console client for the Transmission BitTorrent client
.Op Ar filename-or-URL
is a console client for the Transmission BitTorrent client
.Bl -tag -with Ds
.It Fl -version
Show version number and exit
.It Fl h Fl -help
Show this help message and exit
.It Fl "c \fICONNECTION\fR" Fl -connect=\fICONNECTION\fR
Point to the server using pattern: [username:password@]host[:port]/[path]
.It Fl s Fl -ssl
Connect to Transmission via SSL
.It Fl "f \fICONFIGFILE\fR" Fl -config=\fICONFIGFILE\fR
Path to configuration file
.It Fl -create-config
Create configuration file \fICONFIGFILE\fR
.It Fl n Fl -netrc
Get authentication info from your ~/.netrc file
.It Fl -
Forward options after '--' and auth info to transmission-remote
Settings can be saved in ~/.config/transmission-remote-cli/settings.cfg, authentication settings in ~/.netrc
Connection information
Authentication and host/port can be set via command line with one of these patterns:
.Bd -literal -offset indent
$ 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
Configuration file
You can write this (and other settings) to a configuration file:
.Bd -literal -offset indent
$ \-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:
.Bd -literal -offset indent
$ -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:
.Bd -literal -offset indent
$ -- -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
.Bd -literal -offset indent
$ http://link/to/file.torrent
$ path/to/some/torrent-file
.An -nosplit
.An Benjamin (fagga),
.An contributors .
.Xr transmission-create 1 ,
.Xr transmission-daemon 1 ,
.Xr transmission-edit 1 ,
.Xr transmission-gtk 1 ,
.Xr transmission-qt 1 ,
.Xr transmission-remote 1 ,
.Xr transmission-show 1
Copyright (C) 2011 Ben Thompson.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3
or any later version published by the Free Software Foundation;
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
A copy of the license is included in the section entitled "GNU
Free Documentation License" <\fB\fR>.
Jump to Line
Something went wrong with that request. Please try again.