Skip to content

About

Map Oppo's Snap Key to any app or action

Resources

Contributing

Security policy

Stars

37 stars

Watchers

0 watching

Forks

Repository files navigation

Find SnapKey Map useful? Please support its development.

SnapKey Map icon

SnapKey Map

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.

Downloads Latest release Report a bug Request a feature Website Sponsor on GitHub Buy Me a Tea


Navigation

Screenshots

Home screen with the Ready card and four gestures, including Circle to Search on Double press Lower home screen with Timing, Show confirmations, Pause in apps, and tips Action picker with Phone and Screen and navigation actions, including Circle to Search

Action picker with Open actions and More actions such as Call a contact, Open a link, and App shortcut Timing dialog with the double-press window and press-and-hold sliders Help screen with Run setup again and Getting started

Features

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.

Supported phones

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)

These sources establish the presence of the button, not app compatibility. Availability and naming vary by market.

Requirements

  • 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.

Get started

  1. Download SnapKeyMap-*.apk from the latest release on your phone and install it.
  2. 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.
  3. 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.

Documentation

  • 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.

Roadmap

Next is the F-Droid release. The roadmap lists every step and what each release delivered.

Have an idea? Request a feature.

Contributing

Contributors

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.

License

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.

Support

SnapKey Map is free and has no ads. If it saves you a few taps, you can support its development.

Sponsor on GitHub Buy Me a Tea

Thanks

SnapKey Map is made by Krithik (@heykay-47). Tap the info button on the home screen for the About page.

Stars <3

Star history chart

About

Map Oppo's Snap Key to any app or action

Resources

Contributing

Security policy

Stars

37 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages