Skip to content
Shortcuts and system menus

Shortcuts and system menus

Mobile shortcuts and desktop tray menus have different layouts. Both use the same connection and update operations as the main app.

iOS and Android

Press and hold the OneXray app icon to access four actions:

Action What it does
Start VPN Starts the saved connection; missing settings or permissions still need to be completed.
Stop VPN Stops the current connection.
Switch configuration Opens the existing server or complete-configuration selection page for the current plan.
Update subscriptions Updates subscriptions using their saved settings.

These are app-icon quick actions, not Siri Shortcuts. Android separately offers opt-in token-authenticated broadcast automation for background start/stop from third-party tools.

Android widget and notification

Add the traffic widget from Settings or your launcher’s widget list. Its compact layout targets 4×2 cells; the actual grid depends on the launcher. It shows the app icon, connection state, upload/download speeds, current-connection traffic, and a start/stop button. The VPN notification shows the same session statistics.

When a complete saved startup configuration and permissions are available, the widget and Quick Settings tile start the VPN service in the background. Otherwise they open the app to complete setup. Stopping does not require opening the app. Tapping the widget title or statistics opens OneXray. Force-stopping the app may leave the last widget display until Android refreshes it. Long-pressing the Quick Settings tile opens the existing App activity and does not submit an extra VPN command.

macOS does not display network speeds in the menu bar; open Connect for current-connection statistics.

Desktop tray menu

Use the menu-bar or system-tray icon to:

  • Start, stop, or reconnect the VPN.
  • Select automatic server choice, a subscription, all manual servers, provider configuration, or individual node; select a personal Raw JSON configuration.
  • Change the traffic method.
  • Update all subscriptions or an individual subscription.
  • Update geodata, including the default pair or an individual custom source.
  • Show the main window or quit the app.

Each data-driven list displays up to ten entries. This is a menu display limit, not a limit on saved data. Open the app to see all entries. Fixed items such as automatic selection, manually added servers, and Update all do not consume those ten slots; Update all still covers the full collection.

Changing a selection while disconnected saves it without starting the VPN. When connected, changes that affect the running connection use the app’s confirmation and reconnection flow. Update results and failures use system notifications. A failed tray start, such as having no servers, does not by itself force the main window to open; settings or authorization that need interaction may open it.

Quit behavior

On macOS and Windows MSIX, Quit leaves the VPN running. Use Quit and Stop VPN to stop it too. On Windows EXE/ZIP and Linux, quitting stops the VPN.

Connection · Windows channels

iOS/iPadOS connection widget and Control Center

OneXray requires iOS/iPadOS 16 or later. Add a small or medium home-screen widget, or a circular/rectangular accessory where the system supports it. In version 16, tapping opens Connect. Accessory widgets always only open Connect.

From iOS/iPadOS 17, home-screen widgets have one power button. From version 18, Control Center offers the same single VPN button. A tap reads current native status: connected or connecting stops VPN, disconnected starts it, and disconnecting does not queue another start. A possibly stale displayed state does not decide the action.

Supported systems run the action in the main App process in the background. Startup reuses the most recently generated runtime configuration and existing system VPN profile; it does not rebuild from later selections or wait for tests. Missing startup input or required authorization opens Connect for the user to continue, without automatically connecting with a different plan. Stopping does not require the startup file.

The widget follows App language and system appearance, showing status and the single power action without observation time, traffic, server or subscription details. Missing or more than 15-minute-old snapshots show unknown; WidgetKit controls refresh timing. The status summary and onexray://widget/connect link only open Connect. No general command URL, discoverable Siri/App Shortcut or Live Activity is published.

Last updated on