[[Vorlage(Getestet, focal, jammy)]]

{{{#!vorlage Wissen
[:Pakete installieren: Installation von Programmen]
[:Terminal: Ein Terminal öffnen]
[:Editor: Einen Editor öffnen]
[:sudo: Root-Rechte]
}}}
[[Inhaltsverzeichnis()]]

Der '''transmission-daemon''' ist ein [:BitTorrent:BitTorrent]-Client für Torrent- und Magnet-Links wie das bekanntere und in jeder Ubuntu-Installation enthaltene grafische Programm [:Transmission:Transmission]. Allerdings läuft transmission-daemon nach der Installation als eigenständiger [:Dienste:Dienst] mit einem eigenen Benutzerkonto und besitzt keine eigene Oberfläche. Der Zugriff erfolgt über eine integrierte Weboberfläche, die Fernsteuerung '''transgui''' oder auf der Kommandozeile. Transmission-daemon eignet sich also vor allem für den Einsatz auf Servern.

= Installation =
Die Installation[1] erfolgt mit folgendem Paket:

{{{#!vorlage Paketinstallation
transmission-daemon, universe
}}}

= Einrichtung =
Bevor man den Dienst konfigurieren kann, muss er angehalten werden, da er sonst die Konfigurationsdatei beim Beenden überschreibt[2]:

{{{#!vorlage Befehl
sudo service transmission-daemon stop
}}}

Nun kann man mit einem Editor[3] mit Root-Rechten[4] die Konfigurationsdatei '''/etc/transmission-daemon/settings.json''' bearbeiten. Um den Dienst komfortabel über das Netzwerk fernzusteuern, stellt man folgende Zeilen mit diesen Werten ein:

{{{
{
...
    "rpc-authentication-required": false, # Hier kann auch "true" eingegeben werden, wenn man das optionale Passwort nutzen möchte.
...
    "rpc-enabled": true, 
    "rpc-password": "optionales Passwort", 
    "rpc-port": 9091, # Hier kann auch ein anderer Port eingestellt werden, entsprechend ändert sich der Port in den Arbeitsschritten weiter unten.
    "rpc-username": "benutzername", # Hier bitte den Benutzernamen eingeben, mit dem man sich in die transmission-daemon-Sitzung einloggen möchte.
    "rpc-whitelist": "127.0.0.1,weitere-ip-Adresse,weitere-ip-Adresse", # an dieser Stelle durch Kommata getrennt alle IP-Adressen für den Zugriff eintragen.
    "rpc-whitelist-enabled": true, 
...
}
}}}
Dort können ggf. weitere Einstellungen angepasst werden.

Im Anschluss den Dienst wieder neu starten:

{{{#!vorlage Befehl
sudo service transmission-daemon start
}}}

= transmission-daemon steuern =
== Weboberfläche ==
[[Vorlage(Bildunterschrift, ./webinterface.png, 200, ,"Weboberfläche im Browser", right)]]
Der im Dienst integrierte rpc-Zugriff erfolgt von jedem Rechner mit einer in der Konfiguration eingetragenen IP-Adresse über den Browser. Dazu wird in der Adresszeile des Browsers folgende URL eingetragen: `http://ip-Adresse-des-Servers:9091/transmission/web/` . Wäre der transmission-daemon auf dem lokalen Rechner installiert, kann man auch `http://127.0.0.1:9091/transmission/web/` nutzen.

== Transmission Remote GUI ==
[[Vorlage(Bildunterschrift, ./transgui.png, 200, ,"transgui", right)]]
Ebenfalls sehr bequem lässt sich transmission-daemon auch über das Programm [sourceforge:transgui:Transmission Remote GUI] {en} fernsteuern. Dieses wird mit dem gleichnamigen Paket auf dem Rechner, von dem aus man transmission-daemon fernsteuert, installiert[1].

{{{#!vorlage Paketinstallation
transgui, universe
}}}
Unter Ubuntu 22.04 ist dieses Tool derzeit leider nicht nutzbar, [bug:1964453:]

= Links =
 * [https://www.transmissionbt.com/ Webseite] {en} von Transmission und transmission-daemon
 * [sourceforge:transgui:Transmission Remote GUI] {en}
 * [github:fagga/transmission-remote-cli:transmission-remote-cli] {en} (mittlerweile eingestellt)

#tag: Netzwerk, Internet, Shell, Server