Transmission

From ArchWiki
Revision as of 14:07, 20 August 2012 by 65kid (Talk | contribs) (Run as a daemon: added explanation how to override user with systemd)

Jump to: navigation, search

Tango-view-fullscreen.pngThis article or section needs expansion.Tango-view-fullscreen.png

Reason: please use the first argument of the template to provide a brief explanation. (Discuss in Talk:Transmission#)

Transmission is a light-weighted and cross-platform BitTorrent client. It is the default BitTorrent client in many Linux distributions.

Installation

There are several options in Official Repositories:

transmission-cli
includes CLI tools, daemon and web client.
transmission-gtk
GTK+ GUI.
transmission-qt
Qt GUI.

Configuration

For transmission-gtk and transmission-qt, the default path of configuration files is ~/.config/transmission.

For transmission-cli, default configuration path is ~/.config/transmission-daemon.

Run as a daemon

To run transmission as a daemon, you need have transmission-cli installed. By default, the daemon will run as the user transmission, whose home directory is /var/lib/transmission/.

If you use initscripts, you can change the user in /etc/conf.d/transmissiond:

TRANS_USER="<your user name>"

If you use systemd, you have to override the user in both the service file (/usr/lib/systemd/system/transmission.service) and the tmpfile (/usr/lib/tmpfiles.d/transmission.conf). To do so, copy both files to the appropriate directory in /etc:

# cp /usr/lib/systemd/system/transmission.service /etc/systemd/system/
# cp /usr/lib/tmpfiles.d/transmission.conf /etc/tmpfiles.d/

Then change User= to your custom user in the service file and edit the tmpfile to the following:

/etc/tmpfiles.d/transmission.conf
d /run/transmission - <user> <user> -

Then run systemd-tmpfiles --create transmission.conf and restart the transmission service.

Navigate to http://127.0.0.1:9091 in web browser and you can see the Web client.

You would probably like to have complete file path displayed in the file list of each torrent. Open /usr/share/transmission/web/javascript/file-row.js and comment out the following line:

name = name.substring(name.lastIndexOf('/')+1);

You can also edit the main configuration file ~/.config/transmission-daemon/settings.json to fit your preference.

Note:
  • If you cannot find the ~/.config/transmission-daemon folder, run transmission-daemon once to create it.
  • You need to stop the daemon before editing configuration files, or your edits will not be saved.

See also