Transmission configuration
There are several implementations of the BitTorrent peer-to-peer file sharing protocol. Transmission is only one of them. After installation (opkg install transmission-daemon) there should be a config file in the uci directory.
A few more details about configuration file (/etc/config/transmission) can be found here.
Install
opkg updateDaemon is a program that runs in the background and is designed to not have any form of visual interface
opkg install transmission-daemonCLI (Command Line interface) is a "normal" torrent client designed to be run from a text based console
opkg install transmission-cliTransmission has a web interface which can be used to monitor and manage your transfers over the internet
opkg install transmission-webtransmission-remote to control Transmission through RPC (remote procedure calls) with a GUI on the host machine.
opkg install transmission-remote
Basic setup
To enable Transmission at all, put option enable 1 into /etc/config/transmission.
If you want to start Transmission on boot, run
/etc/init.d/transmission enable
To start Transmission, run
/etc/init.d/transmission start
If you wish to use the web server, besides installing the package (see above), you might need to whitelist your IP address (if it is not in 192.168.1.0/24) via option rpc_whitelist '127.0.0.1,192.168.1.*,your_ip_address'. By default, the server listens on port 9091.
To controll transmission remotely via RPC, install Transmission Remote GUI and set it up just like the webserver above.
Sections
There is only one section: /etc/config/transmission.
config transmission
option enable 1
option config_dir '/etc/transmission'
option alt_speed_down 50
option alt_speed_enabled false
option alt_speed_time_begin 540
option alt_speed_time_day 127
option alt_speed_time_enabled false
option alt_speed_time_end 1020
option alt_speed_up 50
option bind_address_ipv4 '0.0.0.0'
option bind_address_ipv6 '::'
option blocklist_enabled false
option dht_enabled true
option download_dir '/mnt/sda4/'
option encryption 1
option incomplete_dir '/mnt/sda4/incomplete'
option incomplete_dir_enabled false
option lazy_bitfield_enabled true
option lpd_enabled false
option message_level 2
option open_file_limit 32
option peer_limit_global 240
option peer_limit_per_torrent 60
option peer_port 51413
option peer_port_random_high 65535
option peer_port_random_low 49152
option peer_port_random_on_start false
option peer_socket_tos 0
option pex_enabled true
option port_forwarding_enabled false
option preallocation 1
option proxy ""
option proxy_auth_enabled false
option proxy_auth_password ''
option proxy_auth_username ''
option proxy_enabled false
option proxy_port 80
option proxy_type 0
option ratio_limit 2.0000
option ratio_limit_enabled false
option rename_partial_files true
option rpc_authentication_required false
option rpc_bind_address '0.0.0.0'
option rpc_enabled true
option rpc_password ''
option rpc_port 9091
option rpc_username ''
option rpc_whitelist '127.0.0.1,192.168.1.*'
option rpc_whitelist_enabled true
option script_torrent_done_enabled false
option script_torrent_done_filename ''
option speed_limit_down 100
option speed_limit_down_enabled false
option speed_limit_up 40
option speed_limit_up_enabled true
option start_added_torrents false
option trash_original_torrent_files false
option umask 18
option upload_slots_per_torrent 14
option watch_dir_enabled false
option watch_dir ''
| Name | Type | Required | Default | Option | Description |
|---|---|---|---|---|---|
config_dir |
path | Where the configuration files are | |||
bind_address_ipv4 |
IP Address | ||||
bind_address_ipv6 |
IPv6 Address | ||||
download_dir |
path | Where to store you downloaded files | |||
incomplete_dir_enabled |
boolean | Whether to store incomplete files somewhere else | |||
incomplete_dir |
path | Where to store files untill they are finished | |||
dht_enabled |
boolean | Whether to enable dht (distributed hash tables) | |||
blocklist_enabled |
boolean | Whether to make use of the blocklist defined in config_dir | |||
encryption |
integer | Whether to use encrypted connections only (allow encryption: 0, prefer encryption: 1, require encryption: 2) | |||
pex_enabled |
boolean | ||||
speed_limit_down_enabled |
boolean | Whether transmission should limit its download speed | |||
speed_limit_down |
integer | in KByte/s | |||
speed_limit_up_enabled |
boolean | Whether transmission should limit its download speed | |||
speed_limit_up |
integer | in KByte/s | |||
alt_speed_enabled |
boolean | Whether transmission should use two speed limit settings | |||
alt_speed_down |
integer | in KByte/s | |||
alt_speed_up |
integer | in KByte/s | |||
alt_speed_time_enabled |
boolean | Whether to switch between the two speed-setting on a time table | |||
alt_speed_time_day |
|||||
alt_speed_time_begin |
|||||
alt_speed_time_end |
|||||
upload_slots_per_torrent |
how many peers can download a torrent at a time | ||||
open_file_limit |
integer | remember the low system memory | |||
peer_limit_global |
integer | the max number of peers globaly | |||
peer_limit_per_torrent |
integer | the max number of peers with connection per torrent | |||
peer_port |
integer | the fixed port transmission listens to incomming connections | |||
peer_port_random_high |
integer | highest port of the port range | |||
peer_port_random_low |
integer | lowest port of the port range | |||
peer_port_random_on_start |
boolean | whether to use random ports instead of a fixed one from the beginning | |||
peer_socket_tos |
boolean | whether type of service is enabled |
|||
port_forwarding_enabled |
boolean | ||||
preallocation |
boolean | whether to fill the space for chunks not yet downloaded with "0" (helps avoiding fragmentation) | |||
ratio_limit_enabled |
boolean | whether to use a limit ratio | |||
ratio_limit |
integer | automaticaly stop seeding a torrent when it reaches this ratio (with a GUI you can enable this for every torrent separately) | |||
rename_partial_files |
boolean | ||||
rpc_enabled |
boolean | Whether transmission-daemon should be remote controlled by a GUI on a host machine | |||
rpc_bind_address |
IP Address | the address on which transmission-daemon listens to rpcs | |||
rpc_port |
IP Port | the port on which transmission-daemon listens to rpcs | |||
rpc_authentication_required |
boolean | whether rpc needs authentication | |||
rpc_username |
string | password | |||
rpc_password |
string | user name | |||
rpc_whitelist_enabled |
boolean | whether to make use of the whitelist | |||
rpc_whitelist |
IP Addresses | the IPs of the hosts allowed | |||
watch_dir_enabled |
boolean | Whether to check a directory for new torrents put there. Leave this disabled It requres inotify enabled in kernel to works, which is not enabled by default in openwrt. | |||
watch_dir |
path | Path to the directory | |||
script_torrent_done_enabled |
boolean | ||||
script_torrent_done_filename |
|||||
start_added_torrents |
boolean | ||||
trash_original_torrent_files |
|||||
umask |
ciphers | ||||
lazy_bitfield_enabled |
boolean | ||||
lpd_enabled |
boolean | ||||
message_level |
integer | ||||
proxy_enabled |
boolean | whether to use a proxy | |||
proxy |
IP address | IP adress of the proxy | |||
proxy_port |
integer | IP port of the proxy | |||
proxy_type |
integer | Type of the proxy (http: 0, socks4: 1, socks5: 2) | |||
proxy_auth_enabled |
boolean | Whether proxy needs authentication | |||
proxy_auth_username |
string | username for the proxy | |||
proxy_auth_password |
string | password for the proxy |
Notes
- Transmission performs much better when swap is mounted.
- Besides CLI and WEB UI see also Transmission Remote GUI.
doc/uci/transmission.txt · Last modified: 2013/02/04 12:29 by 70d7a4f46
