Map your OPPO Snap Key or OnePlus Plus Key to any app or action.
A different action for a press, a double press, a press and hold, and a tap then hold. No root needed.
- Screenshots
- Features
- Supported phones
- Requirements
- Get started
- Documentation
- Roadmap
- Contributing
- License
- Support
Assign one action each to Press, Double press, Press & hold, and Tap, then hold. For the last gesture, tap once, then hold the second press. When it is assigned, a quick double press runs on release instead of on the second press down.
Tap the lock next to a gesture to run it only when your phone is unlocked.
| Category | Actions |
|---|---|
| Phone | Flashlight, ringer presets you can create and edit (ring, vibrate, silent), a distinct vibration for each ringer mode, Do Not Disturb |
| Screen & navigation | Screenshot, Circle to Search, lock screen, notifications, quick settings, recent apps, home, back, power menu |
| Music & video | Play / pause, next and previous track, media volume up and down, mute / unmute media, volume slider |
| Open | Camera, video camera, voice assistant, Wi-Fi panel, Bluetooth settings, NFC panel, internet and mobile data panel |
| More | Call a contact (opens the dialer with their number), open a link (including sms: and wa.me links with a message filled in), run a supported app shortcut |
| Open an app | Any installed app |
On the home screen you can pause the key in chosen apps, such as the camera, and hide confirmation pop-ups. Errors still show.
Tap ▶ next to a gesture to try its action without pressing the key. Turn the mapping on or off from the Snap Key Quick Settings tile. Back up your settings, including the learned key, to a file and restore them after a reinstall. Details on the status card can copy a bug report or open a prefilled bug form.
The app follows Material 3 with dynamic colour and a System, Light, or Dark theme. It declares no internet permission.
SnapKey Map supports OPPO phones with a Snap Key and OnePlus phones with a Plus Key. It is not limited to the Find X9. The app calls both buttons Snap Key during setup.
App compatibility: the maintainer tests on an OPPO Find X9. Users have also reported it working on the Find X9 Pro, Find X9 Ultra, Find X9s, Find X9s Pro, OnePlus 15R, and OnePlus 13s. Detection, screen-off behaviour, and background reliability can vary with the model and ColorOS / OxygenOS version. Teach the key during setup and test each gesture on your phone.
Phones with the hardware: examples found in product pages and reviews include:
- OPPO: Find X9, Find X9 Pro, Find X9 Ultra, Find X9s, Find X9s Pro; Find X10 and Find X10 Pro Max. Earlier Find X8s, Find X8s+, and Find X8 Ultra models also have a customisable shortcut button.
- OnePlus: OnePlus 15, OnePlus 15R, OnePlus 13s, OnePlus 13T, and OnePlus Nord 5.
This is not an exhaustive list or a claim that every listed model has been tested with SnapKey Map. Having the button alone does not guarantee detection on every firmware. Phones with only the older Alert Slider, or without a Snap / Plus Key, are not covered by this support claim. The separate camera Quick Button is not the Snap Key.
Sources for the phone hardware list (checked 11 November 2026)
- OPPO product pages: Find X9, Find X9 Pro, Find X9 Ultra, and Find X9s describe the Snap Key. ZOL's Find X9s Pro review describes its customisable physical shortcut key.
- Find X10 reviews: Digital Trends — Find X10 and The Hindu — Find X10 Pro Max describe the Snap Key on the left side.
- OPPO's Chinese product pages: Find X8s, Find X8s+, and Find X8 Ultra describe a customisable physical shortcut key.
- OnePlus product pages: OnePlus 15, OnePlus 15R, OnePlus 13s, and OnePlus Nord 5 describe the Plus Key. The Verge's coverage of the 13s and 13T confirms the button on both models.
These sources establish the presence of the button, not app compatibility. Availability and naming vary by market.
- An OPPO phone with a Snap Key or a OnePlus phone with a Plus Key. See supported phones for tested and user-reported models.
- Android 10 or later.
- One of these, for the one-time log permission:
- Shizuku, running through wireless debugging. No computer needed.
- A USB cable and a computer with Google's SDK Platform-Tools.
- Download
SnapKeyMap-*.apkfrom the latest release on your phone and install it. - Set your phone's built-in Snap Key / Plus Key action to None or No action in Settings. Open SnapKey Map and follow the setup wizard. It gives the app log access through Shizuku or ADB, turns on the accessibility service, and teaches it your key.
- Assign actions to the gestures and test each one. Last: in the Ready card shows what the app detected.
To update, install the new APK over the existing app. Do not uninstall first, or you lose your mappings and the log permission.
The setup guide explains each step, including the ADB command.
- Setup guide. Installing and updating, the setup wizard, log access with Shizuku or ADB, and the accessibility permission.
- Troubleshooting. Refused grants, the key stopping after a restart, and missed double presses.
- Privacy and limits. What the app reads, what it keeps, and what it cannot do.
- Roadmap. What comes next and what each release delivered.
- Help and FAQ on the website.
Next is the F-Droid release. The roadmap lists every step and what each release delivered.
Have an idea? Request a feature.
Bug reports, fixes, and device notes from OPPO and OnePlus phones on different ColorOS / OxygenOS versions are welcome. Read CONTRIBUTING.md for the code layout, Find X9 device notes, and how to build, sign, and release the app.
SnapKey Map is free software under the GNU General Public License v3.0 or later.
The third-party GSAP files in docs/vendor/gsap retain their own license. They are used only by the website and are not part of the Android app.
SnapKey Map is free and has no ads. If it saves you a few taps, you can support its development.
- SelenStudio/plus-key-remapper. Its OnePlus 15 Plus Key approach informed the system-log detection.
- Shizuku. Log access without a computer.
- GSAP. Animations on the website.
SnapKey Map is made by Krithik (@heykay-47). Tap the info button on the home screen for the About page.





