=====Transmission=====

Transmission is an open source, volunteer-based project. Unlike some BitTorrent clients, Transmission doesn't play games with its users to make money:

    Transmission doesn't bundle toolbars, pop-up ads, flash ads, twitter tools, or anything else.
    It doesn't hold some feaures back for a payware version.
    Its source code is available for anyone to review.
    We don't track our users, and our website and forums have no third-party ads or analytics. 

**Easy**.

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.

====Installation====
Add my repository, [[nethserver|see how to do it]]

then install the module

  yum install nethserver-transmission --enablerepo=stephdl

after that the transmission-daemon is started, go to https://IP/transmission 


====Usage====
  * Stop the service
if you want to stop it (enabled/disabled)

    config setprop transmission-daemon status disabled
    signal-event nethserver-transmission-save

  * Web application settings
Transmission is particular, it doesn't write its configuration on the fly to its settings.json, **it does at the shutdown and it reads at the boot time**, Therefore when you modify some specific settings **in the web application** of transmission like : 

  * the rpc-peer (peer port 51413 by default) 
  * the download folder (/dl-transmission by default)
  * the rpc-url (/transmission by default)
  * the daemon port (9091 by default)

<WRAP center round tip 60%>
you must launch after in a terminal the event : 

    signal-event nethserver-transmission-save
</WRAP>


This event will read the **/var/lib/transmission/settings.json** and accordingly to these parameters will set good values to Nethserver (eg firewall, download folder....)

  * Manual settings
You will find some settings in the web application, nevertheless [[https://trac.transmissionbt.com/wiki/ConfigurationParameters|if you miss some specific]] then you must edit manually the /var/lib/transmission/settings.json **but it is a mandatory**, you must stop first the daemon

    service transmission-daemon stop
    vim /var/lib/transmission/settings.json

save and launch the event nethserver-transmission-save (to reconfigure accordingly the nethserver)

    signal-event nethserver-transmission-save

====Retrieve Torrents====
Once your torrents are downloaded you have two ways to retrieve them

  * a samba share called transmission
  * a web folder restricted to the local network https://IP/dl-transmission

if you want to allow it to the WWW  (public/private)

    config setprop transmission Webaccess public    
    signal-event nethserver-transmission-save

if you want to stop all samba and web folder (enabled/disabled)

    config setprop transmission status enabled    
    signal-event nethserver-transmission-save

====Allowed Users====
at first only 'admin' is allowed to use them (think to set a password) but in the user panel you can allow more users

  * Can use the Transmission SMB Folder
  * Can use the Transmission WEB Folder
  * Can manage Transmission by the WebUI
====Reach Url====
You have in the DashBoard -> Applications two urls to reach the WebUI and the Web-Folder
else

https://IP/dl-transmission

https://IP/transmission

and think about the transmission samba share

====DB entries====

see the different db properties
  # config show transmission
  transmission=configuration
    DownloadDir=/var/lib/transmission/Downloads   #folder where save downloads
    TCPPort=51413               #port opened to public to allow peers to connect to transmission, set a value or set it randomly in transmission
    WebNameDir=dl-transmission  #Url to retrieve downloads : https://IP/dl-transmission
    Webaccess=private           #the web service to retrieve download is restricted to the local network (public/private)
    access=public               #peer port opened to public
    status=enabled

and the entries relative to the daemon

   # config show transmission-daemon 
   transmission-daemon=service
     Name=transmission     #Url to reach transmission web application https://IP/transmission
     TCPPort=9091          #transmission port restricted to the localhost
     access=none           #transmission port restricted to localhost (it exist a reverse proxy)
     status=enabled


==== Issues ====

Please raise Issues on [[https://github.com/stephdl/nethserver-transmission/issues|github]]

====RPM from geekery & EPEL====
  http://geekery.altervista.org/geekery/el6/x86_64/libevent2-2.0.10-1geekery.x86_64.rpm
  http://geekery.altervista.org/geekery/el6/x86_64/transmission-2.84-1geekery.x86_64.rpm
  http://geekery.altervista.org/geekery/el6/x86_64/transmission-cli-2.84-1geekery.x86_64.rpm
  http://geekery.altervista.org/geekery/el6/x86_64/repoview/transmission-common.html
  http://geekery.altervista.org/geekery/el6/x86_64/repoview/transmission-daemon.html
  https://dl.fedoraproject.org/pub/epel/6/x86_64/pwauth-2.3.10-5.el6.x86_64.rpm
  https://dl.fedoraproject.org/pub/epel/6/x86_64/mod_authnz_external-3.2.6-1.el6.x86_64.rpm
{{tag>module}}