Repository navigation
Settings Advanced
The Advanced tab exposes low-level engine tuning knobs and diagnostic tools. Default values work well for most users; only adjust these if you understand the tradeoffs.
Restricts outgoing and incoming connections to a specific network adapter.
| Setting | Description |
|---|---|
| Network Interface | Bind the torrent engine to a specific adapter: Any interface (Default), utun3 (WireGuard VPN), en0 (Primary Wi-Fi / Ethernet), lo0 (Loopback). |
| Optional IP Address Binding | Further restrict to a specific address family: All IPv4 and IPv6 addresses (default), All IPv4 addresses, All IPv6 addresses. |
Note
Binding to a VPN adapter (e.g., utun3) ensures all torrent traffic routes through that VPN. If the VPN disconnects, the engine loses connectivity — which functions as a software kill switch. For Tailscale mesh routing, the binding is managed automatically; do not set a manual interface binding unless you know what you are doing.
These settings directly affect the embedded Transmission daemon. Racing Mode (BitTorrent tab) overrides the disk cache to 256 MiB when enabled.
| Setting | Description |
|---|---|
| Disk Cache Size (MiB, -1 = Auto) | In-memory disk cache for read/write coalescing. Larger cache → better sequential throughput and fewer I/O operations. -1 lets the engine decide (defaults to 4 MiB if unset — very conservative). |
| Disk Cache TTL (seconds) | How long data stays in the cache before being flushed to disk. |
| Async I/O Threads | Number of background threads used for disk I/O. Increase on machines with fast NVMe storage and many concurrent torrents. |
| File Pool Size | Maximum number of simultaneously open file descriptors. Increase for large multi-file torrents; decrease on systems with a low ulimit -n. |
| Stop Tracker Timeout (s) | How long the engine waits for a tracker response when stopping a torrent. Lower values make pausing/stopping faster at the risk of missing the final announce. |
| Outgoing Ports Min / Max | Restricts the source port range used for outgoing connections (0 = any). Use a specific range only if required by a firewall policy. |
| Coalesce reads and writes (optimize sequential I/O) | Groups small read and write operations into larger sequential chunks before committing to disk. Beneficial on spinning disks; minimal impact on SSDs. |
| Enable embedded tracker | Starts a minimal tracker embedded in the engine. Useful for seeding on private LANs without an external tracker. |
| Embedded tracker port | The port the embedded tracker listens on. Visible only when the embedded tracker is enabled. |
Tip
The most impactful performance setting for large downloads is Disk Cache Size. Setting it to 64–256 MiB significantly reduces random I/O on spinning hard drives.
| Setting | Description |
|---|---|
| Save logs to disk | Writes application and engine log output to a rotating log file. |
| Max log size (MiB) | Maximum size of the on-disk log before it is rotated. Disabled (greyed out) when Save logs to disk is off. |
| Button | Description |
|---|---|
| Open Internal Logs | Opens the application log directory in Finder (macOS) / Explorer (Windows). |
| Copy Diagnostics JSON | Copies a JSON diagnostic summary to the clipboard — useful when reporting bugs on Discord. |
| Copy Recent Logs | Copies the most recent log lines to the clipboard. |
| Clear Cache | Deletes the application's temporary cache data (not your torrents or settings). |
| Reset All Settings | Resets all preferences to their factory defaults and restarts the engine configuration. Also available as Restore Defaults in the modal footer. |
Caution
Reset All Settings is irreversible. Your torrent list and downloaded files are preserved, but all settings (speed limits, directory preferences, proxy config, etc.) return to defaults.
Previous: Settings — Media · Back to Home