UMP (Unified Media Platform)

11.1 Adding a Torrent

 

The BitTorrent client functionality included in this device provides the possibility to download media transparently in the background, while you are free to perform other tasks in the OSD. It is in no way intended to be used to violate any copyright laws or other applicable legislations.

 

Note that merely the use or possession of a BitTorrent client is prohibited by law in some countries. It is strongly recommended that you check the applicable laws for your region before using the Torrent function and contact the UMP support if you need to have it removed.

 

 

 

To load a Torrent file in the Torrent client, you can simply place the file in the  Downloads/Torrents directory. It will be loaded automatically within a few seconds, after which you can view the upload and download progress and statistics by opening the Torrent Menu in the OSD. The Info Area at the bottom displays the statistics of the currently highlighted torrent.

 

You can also manually load a Torrent file from the Downloads directory or any one of its subdirectories by selecting Add a new torrent in the Torrent Menu. After the .torrent file itself has been selected, you can also follow its progress in the Torrents overview.

 

You can check whether the Torrent client is running by navigating to Status in the Main Menu and selecting Torrent Client Status. If the process is active, a PID will be listed.

11.2 Advanced Torrent Settings

 

There are two different types of parameters for the Torrent client function of the UMP, namely the ‘General’ settings and the ‘Application’ settings. A small number of parameters regarding the integration of the Torrent client to the OSD are listed in the Web Interface under Settings -> All -> Other and are explained below:

 

 

TORRENTDIR = ‘/mnt/data/Downloads/Torrents/

 

Here you can specify the default download directory for new Torrents.

 

AUDIO_ITEMS = […]

 

Here you can specify the items for the Music Menu. The Downloads directory is included by default.

 

GAMES_ITEMS = […]

 

Here you can specify the items for the Games Menu. The Downloads directory is not included by default.

 

IMAGES_ITEMS = […]

 

Here you can specify the items for the Images Menu. The Downloads directory is included by default.

 

VIDEO_ITEMS = […]

 

Here you can specify the items for the Video Menu. The Downloads directory is included by default.

 

After changing any of these settings, you will need to restart the OSD for the settings to take effect.

 

The Application settings are described in more detail on the following page.


 

11.2 Advanced Torrent Settings (continued)

 

The following is an overview of the Torrent client application specific parameters and their functions:

 

 

Minimum and maximum number of peers to connect to per torrent

Here you can specify the minimum and maximum number of peers to connect to per torrent. The defaults are ‘1’ and ‘100’

Same as above but for seeding completed torrents (-1 = same as downloading)

Same as above but for seeding completed torrents (-1 = same as downloading)

Maximum number of simultaneous uploads per torrent

Here you can specify the maximum number of simultaneous uploads to allow per torrent. The default is ‘5’

Global upload and download rate in KiB. "0" for unlimited

Here you can specify the global upload and download rate. The defaults are ‘50’ and ‘1024’

Default directory to save the downloaded torrents

Here you can specify the directory in which to save downloaded files. Default value: /mnt/data/Downloads/Torrents

IP to report to trackers

Here you can specify the IP address to report to trackers. The default value is ‘127.0.0.1’

Port or port range to use for listening

Here you can specify the TCP ports to be used for the Torrent download. The default value is ‘59867-59867’

Start opening ports at a random position within the port range

Here you can specify whether to start opening ports at a random position within the port range. The default value is ‘no’

Check hash for finished torrents

Here you can specify whether to check the hash for finished torrents. The default value is ‘no’

Set whether the client should try to connect to UDP trackers

Here you can specify whether the client should try to connect to UDP trackers. The default value is ‘no’

Encryption options, set to none (default) or any combination of the following:

Here you can specify the encryption options. The default value is ‘allow_incoming, enable_retry, prefer_plaintext’. Possible values include: ‘allow_incoming’, ‘try_outgoing’, ‘require’, ‘require_RC4’,‘enable_retry’,‘prefer_plaintext’.


 

11.2 Advanced Torrent Settings (continued)

 

Here is the continuation of the advanced torrent settings listed on the previous page:

 

 

Enable DHT support for trackerless torrents or when all trackers are down

Here you can specify whether the client should enable DHT support for trackerless torrents or when all trackers are down

May be set to "disable" (completely disable DHT), "off" (do not start DHT),"auto"

Here you can specify whether to use DHT for Torrent downloads. DHT enables downloading torrents from peers when no trackers are online, which is an advantage, however the additional amount of traffic caused can be phenomenal. Default setting: off

UDP port to use for DHT

Here you can specify a UDP port to use for the DHT traffic, if enabled. Default setting: 6881

Enable peer exchange (for torrents not marked private)

Here you can specify whether the torrent client should share peers with other clients. Default setting: off

 

 

 

After changing any of these settings, you will need to restart the Torrent client for the settings to take effect. To do so, select the Restart Torrent Client command in the Commands Menu or navigate to Plugins -> Helpers in the Web Interface and select ‘restart_torrents’.

 

Note that although you cannot monitor torrent downloads in the Desktop Mode, you can still start a new download by placing the .torrent file in the target download directory.

11.3 Torrent Plugin

 

The entire Torrent client functionality is provided by one single plugin, called ‘torrent’, which is listed under Plugins -> Global in the Web Interface.

 

If you disable the plugin, the client will still be active in the background, despite the fact that it cannot be managed.

 

The Torrent client cannot be managed from the Desktop Mode or from the Web Interface, though you monitor the files are that are (being) downloaded under Files. Note that you will need to select a different section, depending on the type of media you are downloading for them to be displayed.