Difference between revisions of "Transmission"

From ArchWiki
Jump to: navigation, search
(Add expansion info.)
m (Changing daemon user: ic directory reference)
(10 intermediate revisions by 6 users not shown)
Line 2: Line 2:
 
[[de:Transmission]]
 
[[de:Transmission]]
 
[[it:Transmission]]
 
[[it:Transmission]]
{{expansion|Systemd configuration needed.}}
+
[[zh-CN:Transmission]]
[http://www.transmissionbt.com/ Transmission] is a light-weighted and cross-platform BitTorrent client. It is the default BitTorrent client in many Linux distributions.
+
[http://www.transmissionbt.com/ Transmission] is a light-weight and cross-platform BitTorrent client. It is the default BitTorrent client in many Linux distributions.
  
==Installation==
+
== Installation ==
There are several options in [[Official Repositories]]:
+
  
;{{pkg|transmission-cli}}: includes CLI tools, daemon and web client.
+
There are several options in [[official repositories]]:
  
;{{pkg|transmission-gtk}}: GTK+ GUI.
+
* {{Pkg|transmission-cli}} - includes CLI tools, daemon and web client
  
;{{pkg|transmission-qt}}: Qt GUI.
+
* {{Pkg|transmission-gtk}} - GTK+ GUI
  
==Configuration==
+
* {{Pkg|transmission-qt}} - Qt GUI
For {{pkg|transmission-gtk}} and {{pkg|transmission-qt}}, the default path of configuration files is {{ic|~/.config/transmission}}.
+
  
For {{pkg|transmission-cli}}, default configuration path is {{ic|~/.config/transmission-daemon}}.
+
== Configuration ==
  
===Run as a daemon===
+
For transmission-gtk and transmission-qt, the default path of configuration files is {{ic|~/.config/transmission}}.
  
{{Note|
+
For transmission-cli, default configuration path is {{ic|~/.config/transmission-daemon}}.
*If you cannot find the {{ic|~/.config/transmission-daemon}} folder, run {{ic|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 {{pkg|transmission-cli}} installed. By default, the daemon will run as the user {{ic|transmission}}, whose home directory is {{ic|/var/lib/transmission/}}.
+
=== Run as a daemon ===
  
If you use initscripts, you can change the user in {{ic|/etc/conf.d/transmissiond}}:
+
Start the ''transmission'' [[daemon]].
  
TRANS_USER="<your user name>"
+
Navigate to http://127.0.0.1:9091 in your web browser to see the web client.
 +
 
 +
You can edit the main configuration file {{ic|~/.config/transmission-daemon/settings.json}} to fit your preference. '''You need to stop the daemon''' before editing configuration files, or your edits '''will not be saved'''.
 +
By default, the daemon will run as the user ''transmission'', whose home directory is {{ic|/var/lib/transmission/}}. This means the default location for the configuration file is {{ic|/var/lib/transmission/.config/transmission-daemon/settings.json}}.
 +
 
 +
{{Note|If you cannot find the {{ic|~/.config/transmission-daemon}} folder, run {{ic|transmission-daemon}} once to create it.}}
 +
 
 +
If you change your download location, make sure the ''transmission'' user has read/write privileges to your download directory.
 +
 
 +
==== Changing daemon user ====
  
 
If you use systemd, you have to override the user in both the service file ({{ic|/usr/lib/systemd/system/transmission.service}}) and the tmpfile ({{ic|/usr/lib/tmpfiles.d/transmission.conf}}). To do so, copy both files to the appropriate directory in {{ic|/etc}}:
 
If you use systemd, you have to override the user in both the service file ({{ic|/usr/lib/systemd/system/transmission.service}}) and the tmpfile ({{ic|/usr/lib/tmpfiles.d/transmission.conf}}). To do so, copy both files to the appropriate directory in {{ic|/etc}}:
Line 46: Line 51:
 
Then run {{ic|systemd-tmpfiles --create transmission.conf}} and restart the transmission service.
 
Then run {{ic|systemd-tmpfiles --create transmission.conf}} and restart the transmission service.
  
Don't forget to change permissions to '''777''' on folder '/run/transmission'.
+
You may need to reload service files after editing:
 +
# systemctl daemon-reload
  
Navigate to {{ic|http://127.0.0.1:9091}} in web browser and you can see the Web client.
+
Don't forget to change permissions to '''777''' on directory {{ic|/run/transmission/}}.
  
You can also edit the main configuration file {{ic|~/.config/transmission-daemon/settings.json}} or {{ic|/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:
+
If you would use Transmission daemon with its own group, you have to give the writing permission to transmission group in your download's directory. For this you need to run:
 +
# chgrp transmission /path/to/download
 +
# chmod g+w /path/to/download
  
ln -s /media/USB_Movies/Downloads /home/user/Downloads
+
== See also ==
chown user /media/USB_Movies/Downloads
+
  
==See also==
 
 
*[https://trac.transmissionbt.com/wiki Transmission wiki]
 
*[https://trac.transmissionbt.com/wiki Transmission wiki]
 
*[https://trac.transmissionbt.com/wiki/HeadlessUsage/General HeadlessUsage]
 
*[https://trac.transmissionbt.com/wiki/HeadlessUsage/General HeadlessUsage]

Revision as of 16:55, 25 May 2013

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

Installation

There are several options in official repositories:

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

Start the transmission daemon.

Navigate to http://127.0.0.1:9091 in your web browser to see the web client.

You can edit the main configuration file ~/.config/transmission-daemon/settings.json to fit your preference. You need to stop the daemon before editing configuration files, or your edits will not be saved. By default, the daemon will run as the user transmission, whose home directory is /var/lib/transmission/. This means the default location for the configuration file is /var/lib/transmission/.config/transmission-daemon/settings.json.

Note: If you cannot find the ~/.config/transmission-daemon folder, run transmission-daemon once to create it.

If you change your download location, make sure the transmission user has read/write privileges to your download directory.

Changing daemon user

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:

/etc/tmpfiles.d/transmission.conf
d /run/transmission - [user] [group] -

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

You may need to reload service files after editing:

# systemctl daemon-reload

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

If you would use Transmission daemon with its own group, you have to give the writing permission to transmission group in your download's directory. For this you need to run:

# chgrp transmission /path/to/download
# chmod g+w /path/to/download

See also