Accueil > Logiciel, Tutoriel > TransmissionHowTo


02/05/2021 Categories: Logiciel, Tutoriel Tags:

Transmission Command Line

The BitTorrent protocol can be used to reduce the server and network impact of distributing large files. Rather than downloading a file from a single source server, the BitTorrent protocol allows users to join a “swarm” of hosts to download and upload from each other simultaneously.

Transmission is designed for easy, powerful use. We’ve set the defaults to Just Work and it only takes a few clicks to configure advanced features like watch directories, bad peer blocklists, and the web interface. When Ubuntu chose Transmission as its default BitTorrent client, one of the most-cited reasons was its easy learning curve.

This How-to focuses on CLI (Command Line Interface) and the Web interface

Transmission has been configured to work out of the box on a desktop. Because this how-to is designed for Ubuntu server we need to manually allow remote access.


Add Transmission PPA Repository

Transmission is available in Ubuntu repository. However if you want the latest then add the PPA repository

sudo add-apt-repository ppa:transmissionbt/ppa

Update repositories

sudo apt-get update

Install transmission

sudo apt-get install transmission-cli transmission-common transmission-daemon


There are many settings which can be configured. This how-to focus on tweaking the default configuration file for use with Ubuntu server.

transmission-daemon will start automatically each time you start your server, with the settings defined in /var/lib/transmission-daemon/info/settings.json

Make sure the Transmission daemon is not running when changing the config file otherwise your changes will be over written.

sudo service transmission-daemon stop

edit /var/lib/transmission-daemon/info/settings.json

sudo nano /var/lib/transmission-daemon/info/settings.json

Username and Password

The default rpc-username and password is “transmission”

Lire aussi:  An lsof Primer

Change if increased security is required

Change it to whatever you want (any password will work). After next restart the password will be rewritten in SHA1 encrypted format for security reasons.

"rpc-password": "{62b16db87b89a91dd49a5110a7cafc06d20eb4f2wtK6kqPj",
"rpc-username": "transmission",


This must be changed for remote access

rpc-whitelist defines access to transmission. Localhost ( is defined by default. I added ,192.268.*.* to allow any machine on my LAN access.

"rpc-whitelist": ",192.168.*.*",

Transmission Restart

After configuration change, restart transmission

sudo service transmission-daemon start

Watch Directory

Place a torrent file in this directory for automatic file download

mkdir ~/p2p
transmission-daemon -c ~/p2p

Transmission Daemon

Starting and Stopping Transmission Daemon

After install Transmission, the daemon will be started automatically (but not accessible yet). You can start and stop Transmission daemon using the following commands

sudo service transmission-daemon start
sudo service transmission-daemon stop
sudo service transmission-daemon reload

Note:Restarting (or reloading) Transmission daemon can be tricky. Restarting the the daemon (while it is already running) would rewrite the Transmission settings files to its original state. In other words, restarting the Transmission daemon would reset all the custom settings you saved.

Bash Aliases

Create shortcuts add the following bash aliases to /home/user/.bash_aliases

sudo nano /home/user/.bash_aliases
alias t-start='sudo service transmission-daemon stop'
alias t-stop='sudo service transmission-daemon start'
alias t-reload='sudo service transmission-daemon reload'
alias t-list='transmission-remote -n 'transmission:transmission' -l'
alias t-basicstats='transmission-remote -n 'transmission:transmission' -st'
alias t-fullstats='transmission-remote -n 'transmission:transmission' -si'
source /home/user/.bash_aliases


user@SVR:~$ t-list

will run

transmission-remote -n 'transmission:transmission' -l 

Web Interface

With your browser you can now add torrents, download and seed. You can also configure many transmission settings.


Port Forward

There are many options but one of the more important one’s is port forwarding

Lire aussi:  Postfix + fail2ban = win

Check your ports are open


2015-02-08 10_49_13-.png

Port Forward


If you port says “closed” you will need to configure your internet router to forward the correct port to your Transmission server/client. Google “How to port forward”

If you don’t use “Port Forward” another option is “UPnP”. Once again this depends on you internet router setup.

Command Line Interface

With a headless server full control of Transmission requires CLI

Transmission Create

Create a torrent file with transmission CLI. Torrent files can be generated from either a single file or directories. The example below is a directory example

transmission-create -o ~/torrent/bittorrent/files.torrent -c "My comments" -t udp:// ~/torrent/complete/

-o ~/torrent/bittorrent/files.torrent

New torrent name and where to store the torrent

-c “My comments”

Any comments to be attached to the file

-t udp://

Tracker for the torrent see for more detail about there service


Directory to be made into a torrent. If a single file is required use this format “~/torrent/complete/MyFile.txt”

For more information about “transmission-create”

transmission-create -h

Add a Torrent

To add a torrent to the daemon, use this command:

transmission-remote -a [path to file].torrent

transmission-remote -n 'transmission:transmission' -a ~/p2p/files.torrent

Torrent Information

Display information about torrent’s being downloaded

Help information
transmission-remote -h
List all torrents

Note Authentication is required

transmission-remote -n ‘username:password’ -l

transmission-remote -n 'transmission:transmission' -l
Basic Stats All Torrents
transmission-remote -n 'transmission:transmission' -st
Full Stats All Torrents
transmission-remote -n 'transmission:transmission' -si
Torrent #3 Full Stats
transmission-remote -n 'transmission:transmission' -t 3 -f
Torrent #3 Summary Stats
transmission-remote -n 'transmission:transmission' -t 3 -i

Transmission Control

Start all torrents
transmission-remote -n 'transmission:transmission' -s
Stop all torrents
transmission-remote -n 'transmission:transmission' -S
Start a specific torrent

transmission-remote -s [hash]

transmission-remote -n 'transmission:transmission' -s -t 3
Stop a specific torrent

transmission-remote -S [hash]

transmission-remote -n 'transmission:transmission' -S -t 3
Remove all torrents
transmission-remote -n 'transmission:transmission' -r
Remove a specific torrent

transmission-remote -r [hash]

transmission-remote -n 'transmission:transmission' -r -t 3
Get hashes for all torrents
transmission-remote -n 'transmission:transmission' -i
Quit the daemon
transmission-remote -n 'transmission:transmission' -q
Categories: Logiciel, Tutoriel Tags:
Les commentaires sont fermés.