Advanced Settings

A broad set of browser behavior toggles. This card collects the advanced WebViewConfig options.

Where: the Advanced settings card in the Edit Common Config editor.

User agent & rendering

• User agent — the first block of this card. System default, a desktop flavor, or a custom string (userAgentMode, customUserAgent). Export writes this choice. The HTTP User-Agent and Sec-CH-UA* stay a pair, including architecture and model. Choosing Custom clears a leftover kernel flavor and turns kernel disguise off, so the typed string is the identity. A desktop flavor also turns desktop mode on.
• Desktop mode — request the desktop site (desktopMode). The switch sits on the same block.
• Zoom — enable pinch zoom (zoomEnabled).
• Page zoom — build-time per-app whole-page zoom as a percentage, chosen from Chrome-style presets (50%–150%) or entered freely (pageZoomPercent, default 100). Applied on every run, including cold starts, with CSS zoom on the document root — text, layout, images, and canvas scale together (unlike textZoom, which only scales glyphs). The script does not rewrite the viewport meta, so a page that restores its own meta does not reload. No runtime toolbar. A stored legacy value of 0 is treated as 100.
• Viewport mode — default or a custom viewport width (viewportMode, customViewportWidth).

Navigation & refresh

• Swipe refresh — pull-to-refresh (swipeRefreshEnabled).
• Edge overscroll — on by default (overscrollEffectEnabled). Off stops the Android 12+ stretch on the system WebView and GeckoView's own edge effect. Pull-to-refresh still works. A page's own scripted bounce is unchanged.
• Auto refresh — periodic reload with interval and countdown (autoRefreshEnabled, autoRefreshIntervalSec).
• New-window behavior — how popups/new windows open (newWindowBehavior: same window, external, popup, …). A script-opened window, and an OAuth host, stays a real child window so popup sign-in can reach window.opener. Block still blocks.
• Popup blocker — block popups (popupBlockerEnabled).

Downloads

• Downloads — enable downloads and choose a location (downloadEnabled, downloadLocationMode: system Downloads, app-private, a custom SAF folder, or Choose each time). Choose each time opens the system save dialog for every download, including blob, data, and media files. Cancelling the dialog writes nothing. The default stays system Downloads.

Networking & privacy

• Proxy — static HTTP/HTTPS/SOCKS5 or PAC, with auth and bypass rules (proxyMode, proxyHost, pacUrl, …).
• TLS fingerprint — impersonate a browser JA3 profile (tlsFingerprintEnabled, tlsFingerprintTemplate e.g. CHROME_131).
• CORS bypass — bypass CORS for cross-origin SPAs (enableCorsBypass).
• Mixed content — allow/compatibility mode (allowMixedContent, mixedContentMode).
• Private network bridge — bridge private-network requests (enablePrivateNetworkBridge, privateNetworkScope).
• Hosts mappings — host → IP overrides (hostsMappingEnabled, hostsMappings).
• Cookies — third-party cookies and persistence (acceptThirdPartyCookies, thirdPartyCookieMode).
• Geolocation — enable with accuracy and policy (geolocationEnabled, geolocationAccuracy, geolocationPolicy).

Kernel & status bar

• Kernel disguise — present a different browser kernel flavor (enableKernelDisguise, kernelFlavor, kernelDisguiseLevel).
• Cloudflare compatibility — compatibility mode for Cloudflare challenges (enableCloudflareCompat, cloudflareCompatMode). On the default WebView path the User-Agent and Sec-CH-UA describe the same Chrome identity. Challenge frames skip the other document-start scripts. Captcha hosts use the WebView's own connection instead of the local DNS proxy or the TLS bridge.
• Failover — mirror URLs with triggers and timeout (failoverEnabled, failoverUrls, failoverTimeoutSeconds).

The status bar color/appearance configuration (color mode THEME/PAGE_TOP/TRANSPARENT/CUSTOM, custom color, dark icons, background color/image, light and dark separately) lives in the expandable section of the Fullscreen Mode card.

Notes

• DNS is configured under Custom DNS.
• The most exotic toggles (polyfills, native bridge, print bridge, etc.) live under Special Settings.