From ArchWiki
Revision as of 01:34, 1 January 2013 by Fengchao (talk | contribs) (Add expansion info.)
Jump to: navigation, search

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

Reason: Systemd configuration needed. (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

  • 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.

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/

Create a new group named for example, transmission:

# groupadd transmission

Add your custom user to the newly created [group] ie. transmission:

# gpasswd -a [user] [group]

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

d /run/transmission - [user] [group] -

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

Don't forget to change permissions to 777 on folder '/run/transmission'.

Navigate to in web browser and you can see the Web client.

You can also edit the main configuration file ~/.config/transmission-daemon/settings.json or /var/lib/transmission/.config/transmission-daemon/settings.json to fit your preference. Or place a symlink to your media drive in Downloads dir set in config, just make sure the transmission user has rw privileges to your media drive dirs:

ln -s /media/USB_Movies/Downloads /home/user/Downloads
chown user /media/USB_Movies/Downloads

See also