Subscriptions¶
All platforms.
| Setting | Default · what it does |
|---|---|
| Automatic refresh | on — Reloads your subscriptions in the background so new servers and expiry dates stay current |
| Refresh interval | 1 hour — How often that happens. Your value overrides whatever interval the provider suggested |
| Refresh on open | off — Also reloads every subscription each time you open the app |
| Collapsible subscriptions | on — Lets you fold a subscription's server list in the main screen. Groups start expanded; which ones you collapsed is remembered |
| Refresh all subscriptions | — — Reloads everything right now, ignoring the interval |
A subscription is also refreshed regardless of these settings when it looks expired, so a renewal on the provider's side is picked up rather than reported as “expired”.
A subscription link may also point at a plain WireGuard / AmneziaWG .conf (any URL that returns the [Interface] / [Peer] text) — it is added as a single server and refreshed like any other subscription. Android 449, iOS / macOS / tvOS 331, desktop 218 and later.
“My servers”¶
Servers added by a single link, a .conf file or a subscription URL whose panel never sent a name live in one panel, My servers, without a provider heading. Once a panel has sent a name, that subscription stays a regular subscription even if a later refresh does not include a name. The panel folds and unfolds with the arrow or a double click / double tap on its header, like subscriptions.
Each row shows the server address without the port: for WireGuard / AmneziaWG next to the protocol (AmneziaWG 3.1 | 5.183.191.229), for the rest on a line under the name; it is omitted when the name already is the address. While connected to one of these servers the header says “Connected to .conf file does not use the file name as the server name — the server is named by its host unless you type a name. (Android 473+, iOS/macOS/tvOS 2.0.17 (350)+, Windows/Linux 243+.)
🏷
Each server can carry a short caption from the provider, shown under its name in place of the protocol label (for example Netflix / streaming instead of VLESS | TCP | Reality). This only appears for subscriptions whose provider is active.
Server names¶
Server names stay on one line. Long names automatically shrink to fit the available width, down to 70% of the normal font size. Short names keep their normal size; names that still do not fit at the minimum size end with an ellipsis. The font returns to its normal size when more space becomes available.
iOS / macOS / tvOS 2.0.33 (366), Android 496, Windows / Linux 255+.
Share a configuration or an individual server¶
On iOS, iPadOS, macOS and Android, open View config from the subscription or server menu, then select Share. A single server link such as vless:// is sent as text; a multiline configuration is attached as a text file. The entire configuration is exported even when the preview only shows its beginning.
On Android TV, the same action displays a local-network download address. On Windows and Linux, Share configuration opens a Save dialog; attach the saved file in your messenger or email. Individual servers also have a sharing action in their row menu (on Apple, a server link uses Share link).
Sharing a subscription link remains a separate action. Configurations hidden by the provider cannot be viewed or exported.
Available from iOS / iPadOS / macOS 2.0.42 (378), Android 505 and Windows / Linux 261.
Favorites and the Servers tab¶
On iOS, iPadOS, macOS and Android phones/tablets, stars control what appears on Home. Servers always contains the full catalog; changing a star does not remove a server from that tab. Search and the collapse arrow work independently of favorites.
- A subscription's star selects all its servers. Tap it again to clear that selection.
- If all servers are selected, removing the star from one server keeps the others selected and clears the subscription's overall star.
- Selecting every server individually also marks the overall subscription star.
- Home keeps the current or last selected server visible even without a star. Removing the last individual star never expands the whole subscription.
- The My servers overall star works the same way. Identical servers in different subscriptions have independent favorites.
Double-click/double-tap the subscription name or use its collapse arrow to fold the list. Star buttons do not collapse it.
Favorites fixes: iOS / iPadOS / macOS 2.0.43 (379), Android 507.
Reconnect after a subscription update¶
Open Settings → Subscriptions and use Reconnect when the server changes. It is enabled by default on every platform. After a successful subscription update, the app reconnects an active VPN if the connected server’s connection settings change, for example its address, port or credentials.
Changes to the name, description, traffic counters or JSON key order do not require reconnection. A disconnected VPN is never started by this feature. A removed server or ambiguous matching names do not cause another server to be selected automatically. Disconnecting or selecting another server during the update cancels reconnection of the old connection.
A provider can override the switch for its subscription using s-reconnect-on-update. Without the header, the app setting applies. Available since Apple 3.0.2 (385), Android 3.0.1 (514), Windows/Linux 2.0.2 (267).