Map the Oppo Find X9's Snap 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.
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.
- An Oppo Find X9. Other devices and ColorOS versions may behave differently. Users have also reported it working on the Find X9 Pro, X9 Ultra, X9s, X9s Pro, OnePlus 15R, and OnePlus 13s.
- 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. - 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 Snap 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 other ColorOS 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.





