Configuration

PicoTorrent is stores its configuration in a JSON file and depending on if PicoTorrent was installed or not the file will reside at different locations.

  • If installed, the file can be found at %APPDATA%/PicoTorrent/PicoTorrent.json.
  • If not installed, the file will be placed next to PicoTorrent.exe.

File filters

_images/file_filters.png

File filters are used in the Add torrent dialog and allows a user to store custom include/exclude filters.

Each filter contains a name and a pattern. The name is visible in the include/exclude context menus, and the pattern is a regular expression which is matched on each file name.

1
2
3
4
5
{
  "file_filters": [
    { "name": "Everything", "pattern": ".*" }
  ]
}

Advanced settings

The following is an annotated example file with all settings that are not available for configuration from the GUI (ie. you need to edit the JSON file directly).

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
{
  // If a user chooses to ignore an update, that version number is stored
  // in this field.
  "ignored_update": "",

  // The API URL where PicoTorrent will check for the latest release.
  "update_url": "https://api.github.com/repos/picotorrent/picotorrent/releases/latest",

  "session": {
     // The max number of simultaneous torrents to allow in 'checking'.
     "active_checking": 1,

     // The max number of torrents to announce to the DHT.
     "active_dht_limit": 88,

     // The max number of active downloads.
     "active_downloads": 3,

     // The max number of active torrents across states.
     "active_limit": 15,

     // The max number of torrents that are allowed to be *loaded* at
     // any given time. PicoTorrent will at times load and unload inactive
     // torrents from memory to conserve memory usage.
     "active_loaded_limit": 100,

     // The max number of torrents to announce to the local network over the
     // local service discovery protocol.
     "active_lsd_limit": 60,

     // The max number of active seeds.
     "active_seeds": 5,

     // Set to `true` to enable anonymous mode
     "anonymous_mode": false,

     // The max number of torrents to announce to their trackers.
     "active_tracker_limit": 1600,

     // Set to `true` to enable DHT.
     "enable_dht": true,

     // Set to `true` to enable LSD (Local Service Discovery).
     "enable_lsd": true,

     // Set to `true` to require encryption for incoming connections.
     "require_incoming_encryption": false,

     // Set to `true` to require encryption for outgoing connections.
     "require_outgoing_encryption": false
  },

  "ui": {
     // Set to `false` to skip the Add Torrent dialog
     "show_add_torrent_dialog": true
  }
}