Keyboard Shortcuts & Tray
Keyboard shortcuts of Throne desktop, how to change them, global hotkeys, and what the tray icon and its menu do.
This page lists the keyboard shortcuts of Throne desktop, the global hotkeys you can set, and what the tray icon does. Shortcuts work while the Throne window is active. Global hotkeys work in every app, also when the Throne window is hidden.
macOS: Ctrl on this page means Cmd on a Mac, and Alt means Option. For example, Ctrl+Shift+S is Cmd+Shift+S. On a Mac laptop keyboard, Del is Fn+Delete.
Main window
The toolbar buttons Program, Settings, Groups, Routing and Tools open the menus of the main window. The Settings and Routing menus have no shortcuts.
The column "Can change" shows whether you can set another shortcut in Settings → Hotkey Settings. See Change a shortcut.
Program menu
| Action | Shortcut | Can change |
|---|---|---|
Hide window |
Ctrl+H (macOS: also Cmd+W) |
Yes |
New profile |
Ctrl+N |
Yes |
Add profile from clipboard |
Ctrl+V |
No |
Add profile from File(s) |
Ctrl+O |
Yes |
Scan QR Code |
Ctrl+Shift+Q |
Yes |
You can also drop files, images with a QR code, or links on the window to import them.
Groups menu
The group actions work on the group of the open tab.
| Action | Shortcut | Can change |
|---|---|---|
Url Test Group |
Ctrl+Shift+G |
Yes |
Speedtest Group |
Ctrl+Alt+P |
Yes |
Resolve Domain for group |
Ctrl+Shift+I |
Yes |
Clear Group test result |
Ctrl+Shift+C |
Yes |
Update subscription |
Ctrl+U |
Yes |
Remove Duplicates |
Ctrl+Shift+D |
Yes |
Remove Unavailable |
Ctrl+Shift+R |
Yes |
Remove Invalid |
Ctrl+Alt+I |
Yes |
Stop Testing |
Ctrl+. |
Yes |
Stop Testing appears in the menu only while a test is running.
Right-click a group tab to open that group and its menu. The tab menu has Add new Group, Edit selected Group, Delete selected Group, Update subscription, Url Test selected Group and Speed Test selected Group. Drag a tab to change the order of the groups.
Tools menu
| Action | Shortcut | Can change |
|---|---|---|
Speedtest Current |
F6 |
Yes |
Speedtest Current works only while a profile is running.
Status bar
- Click the running profile on the left of the status bar to run a URL test of it.
- Click
Mixed: …in the middle of the status bar to openBasic Settings.
Profile list
Right-click the profile list to open its menu. It has the same four "add" actions as the Program menu, plus these:
| Action | Shortcut | Can change |
|---|---|---|
Start |
Enter |
No |
Stop |
Ctrl+S |
No |
Share → Export Sing-box config |
Ctrl+E |
Yes |
Share → Copy links of selected |
Ctrl+C |
No |
Share → Copy links of selected (Deep Links) |
Ctrl+Alt+C |
No |
Delete |
Del |
No |
Select All |
Ctrl+A |
No |
Clone |
Ctrl+D |
Yes |
Url Test Selected |
Ctrl+Shift+S |
Yes |
Speedtest Selected |
Ctrl+Shift+P |
Yes |
Reset Traffic |
Ctrl+R |
Yes |
Other keys and mouse actions in the list:
| Key or action | What it does |
|---|---|
| Double-click a profile | Opens the profile editor. |
Esc |
Clears the selection. |
| Drag a row | Moves the profile. This does not work while a filter is active. |
| Click a column header | Sorts by that column. Click it again to sort in the other direction. |
Ctrl+F |
Shows or hides the filter row. Hiding it clears the filters. |
Up on the first row |
Moves to the filter row, if it is open. |
Down in the filter row |
Moves back to the list. |
Esc in the filter row |
Closes the filter row. |
Actions without a default shortcut
You can give a shortcut to these actions, which have none by default: QR Code and link, Copy Test Result, Resolve Selected Domain, Resolve Selected Out IP, Clear Test Result, Resolve out IP for group, Update all subscriptions, Remove Insecure Configs and Refresh Column Widths.
Change a shortcut
- Open
Settings→Hotkey Settings. - Open the
Shortcutstab. It lists every action whose shortcut you can change. - Click the field next to an action and press the new key combination. To remove a shortcut, click the field and press
Backspace. - Click
OK.
If two actions have the same shortcut, neither of them works. The shortcuts marked "No" in the tables above cannot be changed, and Ctrl+F cannot be changed either.
Global hotkeys
Global hotkeys work in any app, even when the Throne window is hidden. All of them are empty by default.
- Open
Settings→Hotkey Settings. - On the
Globaltab, click the field of a hotkey. - Press the key combination.
- Click
OK.
| Hotkey | What it does |
|---|---|
Trigger main window |
Shows the main window, or hides it if it is active. This is the same as clicking the tray icon. |
Show groups |
Opens the Manage Groups window. |
Show routes |
Opens Routing Settings. |
Proxy mode |
Opens the Operation Mode menu (System Proxy, Tun Mode) at the mouse pointer. |
Toggle System Proxy |
Turns System Proxy on or off. |
- If two global hotkeys use the same keys, Throne registers none of them.
- If another program already uses a key combination, that hotkey does not work. Choose a different one.
- Global hotkeys are paused while the
Hotkey Settingswindow is open. - macOS:
Trigger main windowhas no effect. UseShow Windowin the tray menu instead. - Linux: global hotkeys use X11. In a Wayland session they may not work.
Tray icon
Throne shows an icon in the system tray. On macOS, the icon is in the menu bar. The icon changes when a profile is running and when System Proxy or Tun Mode is on. Hover over it to see the running profile and its location. The tooltip also shows the mode when one is on, and the active routing profile when it is not Default.
- Windows and Linux: click the icon to show the window, or to hide it if it is active. Right-click the icon to open the tray menu.
- macOS: click the icon to open the tray menu.
Closing the window does not quit Throne. The window hides, and Throne keeps running in the tray. To quit, choose Exit in the tray menu or in the Program menu.
macOS: while the window is hidden, Throne has no icon in the Dock.
Linux: GNOME shows tray icons only when the AppIndicator extension is installed (#1623). Without a tray icon, you can still bring back a hidden window: start Throne again, and the running Throne shows its window.
Tray menu
| Item | What it does |
|---|---|
Show Window |
Shows the main window. |
Start with system |
Starts Throne when you log in. |
Remember last profile |
At the next start, Throne starts the last running profile again and turns System Proxy and Tun Mode back on if they were on. |
Allow other devices to connect |
Opens the local proxy port to other devices on your network. See LAN sharing. |
Select Profile |
Opens a small list of your groups. Choose a group, then a profile to start it, or type to search all profiles. The running profile has a check mark. The Stop: <name> button stops it. |
Select Routing |
Lists your routing profiles. Choosing one makes it active and restarts the running profile. |
OTP Codes |
Lists your OTP profiles. Click one to copy its current code. |
Operation Mode → System Proxy, Tun Mode |
Turns system proxy or TUN mode on or off. |
Restart Core |
Restarts the core. |
Restart Program |
Restarts Throne. |
Exit |
Quits Throne. |
Start with system works differently on each system:
- Windows: Throne adds a Task Scheduler task. The window opens at login unless
Hide dashboard at startupis on. Each time Throne starts, it sets the task to the rights of the running Throne: if Throne runs as administrator, the task also starts it as administrator, unlessAlways Start as Standard Useris on. - Linux: Throne adds
Throne.desktopto~/.config/autostartwith the option-tray, so it starts in the tray. - macOS: Throne adds a login item. The window opens at login unless
Hide dashboard at startupis on.
Tray settings
These settings are in Settings → Basic Settings → Style.
| Setting | Default | What it does |
|---|---|---|
Hide dashboard at startup |
Off | Throne starts with only the tray icon, and the window stays hidden. The command-line option -tray does the same. |
Disable tray |
Off | Removes the tray icon. Closing the window then quits Throne. |