Skip to content

About

Map the Oppo Snap Key to any app or action

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

 
 

Repository files navigation

Find SnapKey Map useful? Please support its development.

SnapKey Map icon

SnapKey Map

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.

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.

Requirements

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

Get started

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

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 the Oppo Snap Key to any app or action

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages