Difference between revisions of "Transmission"
Kynikos.bot (talk | contribs) (remove language suffix from Category:Internet Applications (English), see Talk:Table of Contents#English Category Names: Capitalization and Conflict with i18n) |
XiongLiding (talk | contribs) |
||
(25 intermediate revisions by 17 users not shown) | |||
Line 1: | Line 1: | ||
[[Category:Internet Applications]] | [[Category:Internet Applications]] | ||
− | + | [[de:Transmission]] | |
− | + | [[it:Transmission]] | |
− | [http://www.transmissionbt.com/ Transmission] is a light- | + | [[zh-CN:Transmission]] |
+ | [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== | ||
Line 19: | Line 20: | ||
===Run as a daemon=== | ===Run as a daemon=== | ||
− | + | First install {{pkg|transmission-cli}}. Then 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 {{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 rw 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}}: |
− | + | # 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, {{ic|transmission}}: | ||
+ | # groupadd transmission | ||
+ | |||
+ | Add your custom user to the newly created {{ic|1=[group]}} ie. {{ic|transmission}}: | ||
+ | # gpasswd -a [user] [group] | ||
+ | |||
+ | Then change {{ic|1=User=}} to your custom user in the service file and edit the tmpfile to the following: | ||
+ | {{hc|/etc/tmpfiles.d/transmission.conf| | ||
+ | d /run/transmission - [user] [group] -}} | ||
+ | Then run {{ic|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 folder '/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== | ||
+ | *[https://trac.transmissionbt.com/wiki Transmission wiki] | ||
+ | *[https://trac.transmissionbt.com/wiki/HeadlessUsage/General HeadlessUsage] |
Revision as of 09:13, 15 March 2013
zh-CN:Transmission 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:
- 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
First install transmission-cli. Then 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
.
~/.config/transmission-daemon
folder, run transmission-daemon
once to create it.If you change your download location, make sure the transmission user has rw 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 folder '/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