Replica

The [Replica] section decides which connections Chute captures — that is, keeps the request and response bodies for. It hides nothing: every connection still appears, with its rule and policy, in Chute Dashboard, the Web Console, the apps and the HAR export; a connection filtered out here simply has no body to show anywhere.

Traffic recording itself is enabled by the replica key in [General] (replica = true); the [Replica] section only narrows what that recording keeps. On iOS, tvOS and Android an active licence is required as well: without it nothing is captured, whatever replica says. The captured bodies last only as long as the run: Chute deletes them when it stops, so export what you need first.

[Replica]
hide-apple-request = true
hide-udp = true
hide-crashlytics-request = true
use-keyword-filter = false
keyword-filter = keyword1,keyword2

The capture holds the bodies it has not yet written out in a memory backlog: 8 MB on macOS, 2 MB on iOS, tvOS and Android. When it is full, the oldest queued blocks are dropped until the arriving one fits, on Apple platforms and on Android alike, so the capture loses the oldest bodies rather than the newest; a single block larger than the whole backlog is still refused outright. The eviction is logged as one coalesced summary rather than a line per block.

Parameters

hide-apple-request (Default: false)

hide-apple-request = true

Do not capture bodies for requests to apple.com and its subdomains. The name is compared label by label, so an unrelated host that merely ends in the same letters, such as pineapple.com, is captured as usual.

hide-udp (Default: false)

hide-udp = true

Do not capture UDP traffic.

Notice: Accepted for Surge compatibility and written back when the configuration is saved. Chute never captures UDP payloads in the first place — a UDP session appears in the lists with its rule and policy, but has no body anywhere — so there is nothing for this key to hide.

hide-crashlytics-request (Default: false)

hide-crashlytics-request = true

Do not capture bodies for requests to Crashlytics hosts (*.crashlytics.com, *.crashlytics.googleapis.com, crashlyticsreports-pa.*). hide-crash-reporter-request (Surge's current spelling) is read as this key.

use-keyword-filter (Default: false)

use-keyword-filter = true

Enable keyword-based capture filtering.

keyword-filter

keyword-filter = google,facebook,analytics

Comma-separated list of keywords. When use-keyword-filter is enabled, bodies are captured only for requests whose host contains one of these keywords.

keyword-filter-type (Default: whitelist)

keyword-filter-type = blacklist

whitelist captures bodies only for hosts that contain one of the keywords, as described above; blacklist inverts that — hosts that contain a keyword are not captured, and every other host is.