A focused, local-first Android utility that restores programmable barrel-button gestures and a classic Air Command wheel on AOSP/LineageOS ROMs — and turns your Note's Wacom digitizer into a low-latency tablet input for your PC.
Tap the pen to open Air Command
Flash AOSP or LineageOS on a Galaxy Note and Samsung's entire S Pen framework disappears. Air Command is gone, the barrel button goes dead, and one of the best Wacom digitizers ever shipped in a phone becomes just another input node nobody listens to.
SPenGestureFix talks to the kernel directly. A root shell reads raw events from sec_e-pen and the w1 presence switch, a state machine decodes clicks and hovers, and a foreground service drives overlays, actions and a normalized tablet stream. No Samsung framework, no cloud, no telemetry.
All running locally on your device, with nothing phoning home.
Single click, double click and long press each run an independent action — remap them anytime from the dashboard.
Six configurable radial actions in a lightweight single-window fan anchored lower-right like classic Note Air Command. Custom accent color, spaced hit targets, tap outside to dismiss — no full-screen touch blocker.
Fully offline notes with editing, search, copy, sharing, character counting, phone-number dialing and Maps lookup.
Annotate a screenshot with Screen Write, or crop a precise rectangle with Smart Select — both use coordinate-correct bitmap mapping.
Tunable pressure curves, monitor-matched orientation, smoothing, haptics, configurable pen button — plus a normalized TCP stream for a PC client.
Screenshots, flashlight, Wi-Fi/Bluetooth toggles, lock screen, experimental freeform windows and fully custom root commands.
Jetpack Compose + Material 3, localized into English, Italian, Spanish, French, German, Portuguese, Dutch, Polish, Turkish, Russian, Ukrainian, Chinese, Japanese, Korean, Arabic, Hindi and Indonesian.
No accounts, no analytics, no network calls from the app itself. Every byte is parsed on-device from your own kernel's input stream.
Pick a gesture to see how a real mapping behaves. Every gesture is fully remappable in-app.
Phone Wacom drivers surface as Linux input devices, not reliable USB HID gadgets — so the service reads getevent -l through a root shell and owns every layer of the pipeline.
sec_e-pen carries absolute X/Y, pressure, hover, tip and barrel-button events. The separate w1 node reports physical S Pen insertion/removal through a device-specific switch code.
Each device gets its own EPenInputReader process running exec getevent. Stopping one reader never kills another process — a lesson learned the hard way.
PenGestureAnalyzer decodes single/double/long presses and hover transitions without ever blocking the digitizer stream.
SPenGestureService, an Android foreground service, routes results to overlays, broadcasts, mapped actions and the tablet capture pipeline. Overlay operations run only on the main thread.
Entering Wacom Mode pauses the normal reader and takes exclusive ownership of sec_e-pen, handing it back on exit. Two readers never compete for the same kernel stream — and a back event can't leave Wacom Mode accidentally.
Some ROMs never report the live switch, so presence also follows real activity: any pen event marks it extracted, and 5 seconds of silence marks it inserted again. This never gates the digitizer pipeline.
Devices are found via /proc/bus/input/devices, falling back to getevent -lp because some ROMs deny the proc file even to root. Initial slot state can come from driver nodes like epen_connection (OK/NG).
Compose pointer input stays local to a screen or the compact wheel window. The service never intercepts Android MotionEvent dispatch, so normal touch keeps working everywhere else.
Stream pressure-aware pen input straight into any desktop app on your PC — over ADB or Wi-Fi.
# optional newline-terminated metadata record:
#SPEN_TABLET 1 1920 1080 1 landscape
# then one record per frame:
X,Y,P,FLAGS| Bit | Meaning |
|---|---|
| 1 | Tip pressed |
| 2 | Right / barrel button |
| 4 | Eraser end |
| 8 | In-range (hover) |
| 16 | Middle button |
Axis mapping happens once on the phone; the Windows client only re-orients when its monitor aspect differs from the source metadata. Legacy clients can safely ignore the comment line.
The PC client scripts/SPGF_Wacom.py auto-discovers sec_e-pen, reads the real axis limits and drives the Windows cursor via SendInput — DPI-aware, no extra dependencies. Or skip the cable and receive the TCP stream over Wi-Fi.
# discover devices and real axis limits
python scripts\SPGF_Wacom.py --list
# ADB mode over USB
python scripts\SPGF_Wacom.py --screen-w 1920 --screen-h 1080
# or receive the Wacom Mode stream over Wi-Fi
python scripts\SPGF_Wacom.py --tcp --host 192.168.1.42 --port 7654Assign any action to any side-button gesture or any of the six wheel slots.
Launches a selected launcher application.
Opens or closes Air Command.
Captures into Pictures/SPenScreenshots.
Captures and annotates a screenshot.
Crops a selected rectangle from a screenshot.
Opens the offline note editor.
Searches launcher applications and opens one.
Starts a selected app in an experimental freeform window.
Toggles the available camera torch.
Runs the corresponding rooted svc command.
Sends the relevant rooted key event.
Runs an explicitly configured root command.
Real captures from the tested device running a connected AOSP ROM.
Everything you need before the first gesture fires.
su# From the repository root (Gradle 8.x or bundled .tools/gradle-8.13)
gradle :app:assembleDebug
# Install on a connected device
adb install -r app/build/outputs/apk/debug/app-debug.apkKotlin · AndroidX · Jetpack Compose · Material 3 — no NDK or JNI required.
The service notification reports whether the digitizer reader is active. If the kernel device is missing, the app stays usable as a configuration tool and reports the failure instead of blocking the UI.
Samsung Galaxy Note 3 SM-N9005
The only hardware validated on the connected rooted ROM used by this repository. Everything — presence switch, digitizer axes, Wacom Mode, the wheel — is tuned against this device.
ABS_X, ABS_Y, pressure, BTN_TOUCH and BTN_STYLUSEach target needs its own device-name, axis-range, switch-polarity, kernel-permission and orientation validation. An S Pen slot alone implies nothing.
# Inspect input devices without changing state
adb shell su -c "getevent -lp"
# Watch the app's own logs
adb logcat -s SPenGestureService EPenInputReader SPenDebugExpected capabilities include BTN_TOUCH, BTN_STYLUS and BTN_DIGI. The service accepts switch codes 001a, SW_001A and common pen-switch aliases; if the switch never fires, the 5-second activity fallback takes over.
No magic, no overpromises — here is exactly what this tool is and isn't.
getevent parsing has slightly more latency than a native binary reader.--orientation landscape-inverted.SPenGestureService.ktEPenInputReader.ktEventDeviceFinder.ktPenGestureAnalyzer.ktWheelOverlay.ktMainComposeScreen.kt et al.TabletInputCapture.ktTabletNetworkServer.ktscripts/SPGF_Wacom.pydocs/TRANSLATION.mdgradle :app:testDebugUnitTest
python scripts\test_i18n.py
python scripts\test_spen_mouse_emulator.pyCovers input parsing, presence decoding, the five-second idle rule, coordinate normalization and pressure curves. A connected phone is recommended for final acceptance testing because switch codes and polarity are kernel-specific.
Grab the latest APK straight from GitHub Releases — or build it yourself from source.
Latest
Rooted Android · AOSP/LineageOS-based ROM · Wacom digitizer required. Root via Magisk/SuperSU, overlay permission and notifications on Android 13+.
Clone it, build it, flash your gestures back. Star the repo if it saves your Note from a drawer.