SagerNet / SagerNet/sing-box

[Feature Request] Restore/Add App Shortcuts for connection toggling (Android / Samsung Modes & Routines)

Open
#4,418 1 comment 2 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Go
Stars
38.1k
Forks
4.6k
Avg merge
19d 15h
Merged PRs (30d)
1

Description

Is your feature request related to a problem? Please describe.

In current versions of sing-box for Android, system automation tools (such as Samsung's Modes and Routines, Tasker, etc.) can only trigger the standard "Open application" action.

Previously, an App Shortcut / Quick Action (sing-box Toggle) was available, allowing users to toggle the proxy/VPN service state directly in the background without opening the main UI.

Describe the solution you'd like

Please consider restoring or adding Android App Shortcuts (android:shortcuts / ShortcutManager) or Intent actions for controlling the VPN state:

  • Toggle service (Start/Stop)
  • Start service
  • Stop service

This would allow native integration with Android automation tools (e.g., automatically toggling sing-box when connecting to specific Wi-Fi networks or launching specified apps via Samsung Modes and Routines).

Describe alternatives you've considered

Using third-party automation tools like MacroDroid or UI click macros via Routines+, which are less reliable and require extra setup compared to native App Shortcuts.

Additional context

Samsung One UI "Modes and Routines" relies on registered Android App Shortcuts to expose app actions to users. Having static shortcuts would restore seamless background automation for Samsung Galaxy and other Android devices.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by locating the Android app's existing shortcut declarations or ShortcutManager integration, then trace the VPN service actions exposed to the app. Check how Samsung Modes and Routines discovers registered shortcuts; done means static actions exist for toggling, starting, and stopping the service without opening the main UI.

Written by the indexing model from the issue text.

Assessment

Tech stack
android
Domain
mobile
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
64/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.