Repository navigation
Settings BitTorrent
The BitTorrent tab controls all protocol-level behavior: swarm modes, engine identity, privacy settings, queueing, seeding limits, and default trackers.
| Setting | Description |
|---|---|
| Enable media mode | Enables the optical disc and ISO cinema streaming interface, DVD/Blu-ray interactive menu playback, and the top-bar Media navigation switch. Disabling hides the Media switch without deleting any media collection data. |
| Setting | Description |
|---|---|
| Enable racing mode | Activates an aggressive swarm and cache preset: 256 MiB disk cache, 150 peers per torrent (1 000 globally), 14 unchoke slots, 2-minute queue-stall detection, and high bandwidth priority for all downloading torrents. |
Important
Racing Mode is designed for maximising download speed. It is most useful when you have a fast connection and are downloading large files from large swarms. The settings on the Connection and Advanced tabs for peer limits and disk cache are overridden while Racing Mode is active.
| Setting | Description |
|---|---|
| Enable super seeding | Globally enables Initial Seeding mode. In this mode, each peer receives a unique piece that no other peer has yet, forcing them to re-upload it before receiving more. Maximises piece dispersion in the swarm with minimum bandwidth from the seeder. |
Tip
Super Seeding is most beneficial when you are the first or primary seeder — uploading a personal rip, a rare archive, or a release you are introducing to the swarm. It is counterproductive when many seeds already exist. You can also toggle it per-torrent in the Add Torrent dialog and from the context menu.
Controls the User-Agent and Peer-ID prefix that Nebulae's embedded engine presents to trackers and other peers. Changes take effect after the next engine restart.
Note
Runtime identity overrides require a patched Transmission build. If the stock bundled daemon is active, a warning banner appears and the profile choice is saved but cannot be applied until a patched engine is installed.
| Profile | Description |
|---|---|
| Transmission (Default) | Unchanged upstream identity: Transmission/4.1.3 with prefix -TR4130-. |
| Nebulae (Native) | Client-branded identity: Nebulae/x.y.z with prefix -NExyzu- (derived from app version). |
| Custom Override | User-specified User-Agent and exactly 8-byte Peer-ID prefix. |
When Custom Override is selected, two fields appear:
-
Custom User-Agent — free-text string (e.g.,
qBittorrent/5.0.5). A shortcut button pre-fills the current Nebulae values. -
Custom Peer ID Prefix — exactly 8 characters in the format
-XX1230-.
The Active Outgoing User-Agent and Active Outgoing Peer ID Prefix readout at the top of this card shows what the running engine is currently using.
| Setting | Description |
|---|---|
| Enable DHT | Distributed Hash Table — finds peers without a tracker. Always disabled for private torrents regardless of this setting. |
| Enable PeX | Peer Exchange — peers share their peer lists with each other to expand the swarm. Disabled for private torrents. |
| Enable Local Peer Discovery (LSD) | Multicast-based discovery of peers on the same LAN. Disabled for private torrents. |
| Enable Anonymous Mode | Strips user-identifying information from tracker announces. Disables PeX. Increases privacy at some cost to swarm health. |
| Encryption Mode |
Prefer Encryption (default) · Require Encryption (refuses unencrypted connections) · Disable Encryption (avoids all encryption overhead). |
Important
DHT, PeX, and LSD are hard-disabled at the session level for all torrents because Nebulae is designed for private tracker use. These checkboxes allow re-enabling them if you use public torrents. Private torrents always suppress peer discovery regardless of these settings.
Controls the active-torrent queue — how many torrents download and upload simultaneously.
| Setting | Description |
|---|---|
| Maximum active downloads | Maximum number of torrents downloading simultaneously. |
| Maximum active uploads | Maximum number of torrents seeding simultaneously. |
| Maximum active torrents | Combined active download + upload cap. |
| Do not count slow torrents in active limits | Torrents whose speed falls below the slow-torrent thresholds are excluded from the active count, allowing more torrents to be queued. |
| Slow DL threshold (KiB/s) | Download rate below which a torrent is considered "slow" (visible when the checkbox above is enabled). |
| Slow UL threshold (KiB/s) | Upload rate below which a torrent is considered "slow". |
| Setting | Description |
|---|---|
| When ratio reaches | Trigger an action when a torrent's share ratio (uploaded ÷ downloaded) exceeds this value. -1 = unlimited (never trigger). |
| Action when limit reached |
Pause torrent · Remove torrent · Remove torrent and files · Switch to Super-Seeding. |
| When seeding time (min) reaches | Trigger the same action when the torrent has been seeding for this many minutes. -1 = unlimited. |
Both ratio and time limits can be active simultaneously; the action fires on whichever condition is satisfied first.
A newline-separated list of tracker URLs automatically appended to every new public torrent added through Nebulae. Private torrents are never modified.
https://tracker.example.com/announce
udp://tracker.openbittorrent.com:80
Note
These trackers are injected at add time, not stored in the .torrent file. They appear under the Trackers tab in the detail panel alongside the torrent's original trackers.
Next: Settings — RSS · Previous: Settings — Speed