Difference between revisions of "Transmission"

From ArchWiki
Jump to: navigation, search
m (Installation: Added note about requiring transmission-cli for web-client)
(begin cleanup and fixup, first of several edits)
Line 8: Line 8:
  
 
There are several options in [[official repositories]]:
 
There are several options in [[official repositories]]:
 +
* {{Pkg|transmission-cli}} - CLI tools, daemon, and web client.
 +
* {{Pkg|transmission-gtk}} - GTK+ GUI. {{Note|The gtk client cannot connect to the daemon, so user wishing to use the daemon will need to consider using the qt package for a gui or the remote-cli package for a curses gui.}}
 +
* {{Pkg|transmission-qt}} - Qt GUI.
 +
* {Pkg|transmission-remote-cli}} - Curses interface for the daemon.
  
* {{Pkg|transmission-cli}} - includes CLI tools, daemon and web client
+
At a minimum, the -cli package is required.  See note above when choosing between the -gtk and -qt packages.
 
+
* {{Pkg|transmission-gtk}} - GTK+ GUI
+
 
+
* {{Pkg|transmission-qt}} - Qt GUI
+
 
+
If you install {{Pkg|transmission-gtk}} or {{Pkg|transmission-qt}} and you want to use the remote web client then you must also install {{Pkg|transmission-cli}} as that is where the {{ic|/usr/share/transmission/web/}} files are packaged.
+
  
 
== Configuration ==
 
== Configuration ==

Revision as of 12:22, 13 December 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:

  • transmission-cli - CLI tools, daemon, and web client.
  • transmission-gtk - GTK+ GUI.
    Note: The gtk client cannot connect to the daemon, so user wishing to use the daemon will need to consider using the qt package for a gui or the remote-cli package for a curses gui.
  • transmission-qt - Qt GUI.
  • {Pkg|transmission-remote-cli}} - Curses interface for the daemon.

At a minimum, the -cli package is required. See note above when choosing between the -gtk and -qt packages.

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 using systemd.

Navigate to http://localhost: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

To change the user the daemon is running as, simply override User= in the service file with a drop-in config (see systemd#Editing provided unit files):

/etc/systemd/system/transmission.service.d/user.conf
[Service]
User=<custom user>

Then run the following to reload the service file:

# systemctl daemon-reload

When the daemon is started, it will create its settings in ~/.config/transmission-daemon/.

See also