Settings Reference

Settings Reference

Open with ⌘, or Settings… in the menu bar panel. Changing the port, LAN access, credentials, routing mode, log level, fragment, noise or DNS while connected restarts the connection.

General

Setting	Default
Language: Same as the system, English, فارسی, 简体中文, Русский (needs a restart)	Same as the system
Launch at login	Off
Reconnect on launch	On
Restart core after sleep or network change	On
Count traffic usage	On
Check for app updates	On
Privileged helper: status, Enable Helper…, Open Login Items, Remove Helper	Not registered
Store secrets in Apple Keychain	Off (encrypted local file)
Backup: Export Backup…, Restore Backup…	—

Proxy

Setting	Default
Port (SOCKS5 and HTTP)	10808
Set as system proxy	Off
Username / Password (optional)	Empty
Allow connections from LAN (shows your LAN address; warns without a password)	Off

Routing

Setting	Default
Mode: Global, Bypass regions, Direct, Rules Only	Global
Traffic that matches no rule: Follow mode, Proxy, Direct, Block	Follow mode
Region packs: enable, Update Now, auto-update interval	None enabled
Open Rule Editor… (custom rules, Block QUIC, Rule Builder, Proxifier import)	—

See Routing.

Subscriptions

Setting	Default
Auto-update subscriptions	On
Auto-update route: Without proxy / Via proxy	Without proxy
Interval when the provider sends none	12 h
User-Agent	v2mac/<version>

Latency

Setting	Default
Test URL	https://www.gstatic.com/generate_204
Timeout	8 s
Concurrency	8

Connection

Setting	Default
Switch servers without restarting	On
Automatically select a working server	Off
Switch conditions: delay over / download under for	Off; 1000 ms; 100 KB/s for 2 min
If TUN fails: Keep local proxy running / Stop connection	Keep local proxy running
Kill switch	Off
Allow insecure servers	Off
Show where traffic comes out	On
Country badge on the menu bar icon	On
Speed in the menu bar	Off
TLS fragment: split, piece size, pause	Off; 100-200 bytes, 10-20 ms
Noise packets: size, pause	Off; 10-20 bytes, 10-16 ms
Custom DNS: servers, IPv4/IPv6	Off; Cloudflare and Google DoH

Notifications

One switch per kind; see Menu Bar and Shortcuts.

WARP

Register a WARP device, see plan and WARP+ data, enter a WARP+ key, Send traffic out through WARP, Add WARP to Servers. See Connecting.

Core

Xray version, Check for Update, Revert to Bundled.

Advanced

Setting	Default
Log level: error, warning, info, debug	warning
Log connections	Off

About

Version, share V2Mac, project links, licences.

---

Backup

Settings → General → Export Backup… writes a .v2m file with your subscriptions, servers, favorites and settings. Restore Backup… (or double-clicking the file) shows what it holds and asks first.

• A restore only adds: missing subscriptions come back with their servers, existing ones get their favorites back, pasted configs are added if not already there.
• Not included: the proxy password, the WARP device, the Keychain choice, active and recent servers, traffic totals and delays.

Secrets

The proxy password and the WARP device are stored encrypted (AES-GCM) in a local file with its own key, readable only by you. You can move them to the macOS Keychain instead (General → Store secrets in Apple Keychain); macOS may then ask for your login password. V2Mac never stores your administrator password.

Files on disk

~/Library/Application Support/v2mac/
├─ default.store      servers and subscriptions
├─ secrets/           encrypted secrets and their key
├─ core/xray          only after an in-app core update
├─ assets/            geoip.dat, geosite.dat, region packs
└─ run/               config.json and flags, only while running

Settings are in ~/Library/Preferences/io.github.lordversa.v2mac.plist.

Privacy

No analytics, no telemetry. Besides your own traffic, V2Mac contacts only your subscription URLs, GitHub (updates, region packs), the exit-check services (through your server), and Cloudflare's WARP API if you register WARP.