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.


There are several options in Official Repositories:

includes CLI tools, daemon and web client.


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:

d /run/transmission - <user> <user> -

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

Navigate to 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.

  • 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