MindControl
3.0 · GitHub
More about this app
Hardware button remapper and AOD toolkit for the iKKO MindOne that monitors physical keys through Shizuku getevent, with a root fallback.
MindControl đ§ đą
MindControl is a deep-integration hardware customization toolkit, physical-keyboard / gamepad mapper, and Always-On Display (AOD) engine designed for Android devices and specifically optimized for the iKKO MindOne. It allows you to intercept and remap physical buttons and keys, run a full XBOX-Style controller layer, handle screen-off hardware events via privileged shell access (Shizuku or Root), dynamically adjust display aspects and DPI, and enjoy a rich, modular AOD experience.
đ¸ Screenshots
| Main Dashboard | Button Config | AOD |
|---|---|---|
![]() Main Dashboard |
![]() Buttonconfig Screen |
![]() Concentric screen with Mediaplayer |
![]() Theme selector and Keyboard button |
![]() Action selector |
![]() Nothing Dot Stacked |
![]() Keyboard Dashboard |
![]() AOD Select Action |
![]() Digital AOD With Media action triggered and charging state |
![]() QR-Code dialog |
đ Key Features
1. Dual Privileged Engine (Shizuku & Root)
MindControl v3.0 introduces native support for both Shizuku and Root (KernelSU, Magisk, APatch, and standard su):
- Zero UI Blocking: Permission detection runs reactively via background Kotlin Coroutines / StateFlows, preventing any frame drops or ANRs.
- Screen-Off Remapping via Kernel Monitor: When the screen is off, standard accessibility services cannot intercept input. MindControl spawns a privileged low-level kernel event monitor (
getevent -l) that translates raw hardware scancodes (volume rocker, power, camera shutter, two-stage focus sensor, AI buttons) in real time. - Secured System Controls: Execute system-level tasks without cumbersome permission hoops, such as changing aspect ratios, display density, airplane/mobile data, location, and brightness.
2. Physical Button & Trigger Remapping
- Hardware Supported: Volume Rockers, Camera Shutter, Half-press Focus Sensor, Dedicated AI / Assistant buttons, Physical Keyboards, Gamepads, and Camera orientation sensors.
- Multi-Trigger Gestures:
Single,Double,Triple,FourandFivepress patterns.Long Press(Hold),Press and Hold, and2x Press & Holddetection.
- Contextual States: Assign distinct behaviors depending on whether the screen is On or Off.
- Per-Button Override Toggle: Enable or disable the custom remapping of each individual button, so an unbound button simply keeps its stock behavior.
3. Gamepad Mode (XBOX Controller Layer)
MindControl can present a virtual XBOX controller to the system, built on a native uinput helper â no game needs to know the physical keyboard exists:
- Per-App Activation: Choose the apps whose keyboard switches to the gamepad layout in
Gamepad keyboard apps; everywhere else the phone stays in normal keyboard mode. - Manual Toggle: Start or stop the controller on demand from the dashboard, in any app.
- Full Controller Layout: Face buttons (
A / B / X / Y), D-pad, bumpers,L3/R3,Start/Menu/Select, and analog stick directions. - Three Switchable Profiles: Keep three independent controller mappings and switch between them at runtime â either from the action picker (
Profile 1 / 2 / 3) or with the presetc/v/bkeys on the home row. Profile 1 ships a ready-to-use preset. - Rumble Feedback: The controller advertises force-feedback; the game's rumble requests are read back from the helper and played on the phone's real vibrator.
- Virtual D-pad for Navigation: Arrow actions are routed through a synthetic gamepad device tagged
SOURCE_GAMEPAD, so Android's Focus Navigation Engine moves focus exactly like a physical XBOX controller instead of the app swallowing the key.
4. Continuum: Continuous Fluid Execution
MindControl includes a Continuum Engine for fluid system interactions:
- How it Works: Assign an action to the Hold or Press and Hold trigger.
- Continuous Repeat: As long as the physical button remains depressed, the assigned action continuously and smoothly repeats (ideal for volume ramping, smooth page scrolling, and fine brightness adjustment).
5. Custom Always-On Display (AOD)
A fully custom, low-overhead AOD built with Jetpack Compose. Can be assigned as an action to any button trigger or combination.
Standalone Watch Faces:
Concentric(Pixel Watch concentric rings)Spinner(Rotating abstract clock indicators)Blocks&Bars(Bold geometric watchfaces)Track(Circular progress-ring clock)Cube(3D rotating cube clock)Digital Abstract(Modern abstract digital segments)
Analog Clock â one watch face with three switchable substyles:
Classic(traditional analog hands with modern dial ticks)Planets(dynamic orbital visualization)Abstract(modern abstract hands)
Text Clock â one watch face with a 2Ã4 grid of layout / substyle combinations, plus full font control:
Modern |
Nothing Dot |
Digital |
Pixel |
|
|---|---|---|---|---|
Stacked |
Stacked (Modern) | Nothing Dot (Stacked) | Digital (Stacked) | Pixel (Stacked) |
Inline |
Inline (Modern) | Nothing Dot (Inline) | Digital (Inline) | Pixel (Inline) |
Text Clock Customization: Pick the Inline or Stacked layout and one of the Modern / Nothing Dot / Digital / Pixel substyles, then fully customize the font â family (Quicksand, Sans-Serif, Serif, Monospace, Cursive), weight (Light â Extra Bold) and italic.
Shared across all watch faces:
- Dynamic Media Art: Renders the currently playing album art as a subtle, blurred and vignetted ambient backdrop.
- Smart Indicators: Real-time mirroring of notification tray icons, charging animations, and battery percentage.
- Simple Dismissal: Press power or swipe up to immediately return to your lock screen or desktop.
6. Display, Aspect Ratio & Density Customization
Switch display geometry on the fly using physical button mappings:
- Aspect Ratios: Full Screen, 4:3, 16:9, Cycle Aspect Ratio, or Step Up/Down.
- Screen Densities (DPI): Density 200, 300, 400, Density Cycle, or apply custom DPI profiles.
- Custom Resolutions: Quickly toggle between native resolution and custom aspect configurations, or open a dialog to enter an exact custom width, height and density (with a live calculated aspect ratio).
7. Universal Physical Keyboard & Input Mapping
- Regional Layouts: Native layout switching for
QWERTY,QWERTY (Spanish),QWERTZ(German/Central European), andAZERTY(French). - Visual Key Mapper: Interactive on-screen keyboard map lets you visualize and bind custom actions to individual physical keys.
- Key Injection: Send single key presses, letters with
Shift/Ctrl/Altmodifiers, arrow keys,TabandReverse Tabdirectly to the focused app. - Better Shift: A dedicated Shift action that taps for
Shiftand holds forShift Lock, reacting instantly and always overriding the keyboard. - Emoji Keyboard: Open the system emoji picker from any physical key. (requires Shizuku / Root)
- Zero-Latency Remapping: Per-button mode where a single press fires the moment the key is released â no multi-press waiting window, ideal for fast typing. The
,key ships preconfigured this way. - Permanent Keyboard Overwrite: Keep the remapped behavior active even while a text field is focused.
8. QR-Code Sharing
Generate a QR code on the fly from any button â great for sharing a link, phone number or block of text without typing it out. Rendered in-app with ZXing and themed to match your device palette.
9. Instant Shortcuts From the Lock Screen
A dedicated overlay activity lets a button trigger launch an app or shortcut directly from a locked / screen-off state, waking the screen, dismissing the keyguard and a black frame appears over the whole screen so there are no distractions for short actions.
10. Adaptive Theming & Dynamic Icons
- Adaptive App Icons: The launcher icon dynamically adapts to match your device casing (Black, White, Pink, Blue).
- Device & Keyboard Palettes: Theme both the main interface and physical keyboard mapper to match your hardware style.
đ Action Library (70+ Actions)
Click to expand the available actions
Note: Actions marked with (Continuum) support continuous hold execution. Actions marked with (Privileged) require Shizuku or Root.
| Category | Actions |
|---|---|
| Navigation | Home, Back, Recents, Last App, Show Menu (Privileged) |
| Media | Play/Pause, Next, Previous, Stop, Fast Forward, Rewind, Step Forward/Back, Volume Up/Down (Continuum), Volume Dialog, Mute Volume, Mute Microphone Toggle (Privileged) |
| Connectivity | WiFi Toggle (Privileged), Bluetooth Toggle (Privileged), Mobile Data Toggle (Privileged), NFC Toggle (Privileged), Location Toggle (Privileged), Do Not Disturb |
| Display & Geometry | Aspect Ratio (Full / 4:3 / 16:9 / Cycle / Up / Down / Full+4:3+16:9) (Privileged), Screen Size (Full / 4:3 / 16:9 / Custom) (Privileged), Display Density (200 / 300 / 400 / Cycle / Up / Down / Custom) (Privileged), Brightness Up/Down (Continuum), Auto-Brightness Toggle (Privileged), Auto-Rotate Toggle, Rotate 360°, Toggle AOD |
| System | Flashlight, Screenshot, Lock Screen, Assistant, Power Dialog, Notifications Panel, Quick Settings Panel, Cycle Sound Mode, Vibrate Ringer |
| Navigation & Scroll | Scroll Up/Down (Continuum), Smooth Scroll Normal/Fast (Continuum), Copy, Cut, Paste, App Info, Google Search |
| Keyboard & Input | Key Press / Letter (with Shift / Ctrl / Alt modifiers), Arrow Up/Down/Left/Right, Shift Hold, Shift Lock, Tab, Reverse Tab, Open Emoji Keyboard |
| Gamepad | Profile 1, Profile 2, Profile 3 (see Gamepad Mode) |
| Custom & Shortcuts | Launch App, Launch Custom Shortcut, Speed Dial, Open Custom URL, Show QR Code Dialog |
đ Technical Architecture
- Accessibility Key Filtering: Intercepts key events using
AccessibilityService.FLAG_REQUEST_FILTER_KEY_EVENTSwhen the screen is active. - Kernel Event Monitoring: When the screen turns off, MindControl falls back to reading raw scancodes via
/system/bin/getevent -lthrough Shizuku or Root, ensuring reliable triggers even under aggressive OEM sleep states. - Native
uinputGamepad Helper: A small NDK-built executable (virtual_dpad.c) stages an executable copy to disk via privileged shell, then creates synthetic input devices through/dev/uinputâ a D-pad device taggedSOURCE_GAMEPADfor Focus Navigation, and a resident rumble-capable XBOX-identified pad with axes. It speaks a line-based stdin/stdout protocol and reports back the app's force-feedback requests. - Device-Protected Storage (
Direct Boot): User configurations and root statuses are kept in encrypted device-protected storage (createDeviceProtectedStorageContext()), allowing MindControl to initialize and function immediately upon boot before the first user unlock. - Shortcut Overlay Handoff: A dedicated
ShortcutOverlayActivitywakes the screen, dismisses the keyguard and holds a black frame across the transition, finishing only once the launched app's window fully covers the screen â never flashing the launcher. - Local & Reactive Architecture: State is driven by Kotlin Coroutines
StateFlowand Jetpack Compose without polling loops or blocking threads.
đĨ Installation & Setup
- Install the APK from the Releases page.
- Enable Accessibility Service: Open
Settings > Accessibility > MindControland toggle it ON. (If greyed out on Android 13+, tap the 3 dots in App Info and choose "Allow restricted settings"). - Privileged Access (Recommended):
- Root: If your device is rooted (KernelSU / Magisk / APatch), grant root access when prompted or from your root manager.
- Shizuku: If unrooted, launch Shizuku and authorize MindControl.
- Battery Optimization: Exclude MindControl from battery optimization to keep the background monitoring service persistent.
- Notification Listener (Optional): Enable notification access to display media controls and notification badges on the AOD.
- Gamepad Mode (Optional): Open Gamepad keyboard apps and tick the apps that should switch to the controller layout, or start the controller manually from the dashboard. Requires Shizuku or Root for the native
uinputhelper.
đĄ Privacy & Security
- No Internet Access: MindControl requests zero network permissions (
android.permission.INTERNETis not included in the manifest). All data, actions, and key events stay strictly on your device. - No Analytics or Tracking: No telemetry, third-party trackers, or cloud dependencies.
- Open Source: Full source code is open and verifiable.
â Support the Project
If you find MindControl helpful, consider supporting its development!
đ¨âđģ Developer & Credits
- Company: Xenonware
- Lead: Nico (Dinico414)
Disclaimer: This application uses Accessibility Services and privileged shell APIs. It is an independent project by Xenonware and is not affiliated with Nothing Technology Ltd., iKKO, Google LLC, or any OEM.
How Shizuku is used
Can detect hardware button presses via `getevent` and toggle radios, display, mic privacy, inject keys and emulate a gamepad via shell commands through Shizuku.
This is an AI-assisted analysis of Shizuku-related usages in the app's public source code. It is best effort, so it may not catch every single usage.
How this app uses Shizuku
MindControl uses Shizuku to watch physical buttons at system level and to run privileged toggles and input actions assigned to button presses.
- Detect hardware buttons: reads raw key input with the
geteventshell command through Shizuku and maps scancodes to volume, power, camera, focus and assistant keys, including when the screen is off or locked. - Toggle wireless connections: a button press switches Wi-Fi, Bluetooth, mobile data or NFC on or off with the
svc wifi,svc bluetooth,svc dataandsvc nfcshell commands through Shizuku. - Switch auto brightness: a button press flips automatic brightness on or off with the
settings put system screen_brightness_modeshell command through Shizuku. - Switch location mode: a button press turns location off or back to high accuracy with the
settings put secure location_modeshell command through Shizuku. - Mute microphone privacy: a button press checks and flips the system microphone block with
cmd sensor_privacyshell commands through Shizuku and syncs the software mute state. - Change screen size: a button press cycles or sets display resolution and pixel density with the
wm sizeandwm densityshell commands through Shizuku, including custom values typed in settings. - Inject keys and shortcuts: a button action sends menu, wakeup, emoji picker, typed text and key combinations with the
input keyeventandinput keycombinationshell commands through Shizuku, and drives arrow navigation through a virtual D-pad device. - Emulate game controller: in chosen apps the app starts a packaged helper through Shizuku to advertise a virtual gamepad and route button, stick, trigger and D-pad presses as genuine controller input.
- Assist display and unlock: after opening Display settings from the lift to wake prompt, the app auto scrolls with
input swipeandinput keyeventshell commands through Shizuku, and it can dismiss the keyguard with thewm dismiss-keyguardshell command through Shizuku when the system unlock prompt is unavailable.
Android APIs or commands used
geteventsvc wifisvc bluetoothsvc datasvc nfcsettings put system screen_brightness_modesettings put secure location_modecmd sensor_privacy helpcmd sensor_privacy get-statecmd sensor_privacy set-statewm sizewm densitywm dismiss-keyguardinput keyeventinput keycombinationinput swipe/dev/uinput
Notable details
Auto brightness can still work through the normal system settings path without Shizuku, and microphone mute falls back to software mute only without Shizuku.
Changelog
What's new for version 3.0
đ§ MindControl(ler) 3.0 â Never Mind the Impossible đđŽ
This is the biggest update in MindControl's history. Feature Drop 2 turns your handset into a full controller, a remapping powerhouse, and a shortcut launcher â all without ever touching the network. This is not a patch. This is a mind-shift.
"The mind is not a vessel to be filled, but a fire to be set â and a button to be remapped."
đ New Features
đŽ Gamepad Mode â Full Xbox Controller Layer
MindControl now presents a virtual Xbox controller to Android using a native uinput helper:
- Per-app activation â pick which apps switch their keyboard into the controller layout; everything else stays a normal phone.
- Manual control â start or stop the controller instantly from the dashboard, in any app.
- Complete layout â
A / B / X / Y, D-pad, bumpers,L3/R3,Start/Menu/Select, and analog stick directions. - Three switchable profiles â store three independent mappings and swap between them live, from the action picker (
Profile 1 / 2 / 3) or the presetC/V/Bhome-row keys. - Real rumble feedback â the pad advertises force-feedback, and the game's rumble requests are read back and played on your phone's actual vibrator.
đšī¸ Virtual D-pad & Arrow Navigation
Arrow actions are routed through a synthetic device tagged SOURCE_GAMEPAD, so Android's Focus Navigation Engine moves the focus exactly like a physical controller â no more apps swallowing your arrow keys.
â¨ī¸ Universal Physical Keyboard & Input Mapping
- Key Injection â send single keys, letters with
Shift/Ctrl/Alt, arrow keys,TabandReverse Tabstraight to the focused app. - Better Shift â tap for
Shift, hold forShift Lock; instant, and always overrides the keyboard. - Emoji Keyboard â summon the system emoji picker from any key.
- Zero-Latency Remapping â a per-button mode that fires the single-press the instant you release, with no multi-press wait. Tuned for fast typing; the
,key ships preconfigured. - Permanent Keyboard Overwrite â keep your mappings active even while typing.
đ Instant Shortcuts From the Lock Screen
Launch an app or shortcut straight from a locked / screen-off state. MindControl wakes the screen, dismisses the keyguard, and holds a black frame across the whole hand-off â so your launcher is never flashed to the screen.
đ New AOD Watch Faces
- Analog clock family â
Classic,Planets, andAbstractsubstyles. - Text Clock â a 2Ã4 grid of layout à substyle (
Inline/StackedÃModern/Nothing Dot/Digital/Pixel) with full font customization (family, weight, italic). - Track (progress-ring), Abstract (Digital with abstract shapes) and Cube (Cubes morphed and rounded) faces.
đ ī¸ Fixes & Improvements
- End-to-end screen-off shortcuts â reliable black-overlay handoff from lock screen into the app.
- Multi-tap reliability â camera multi-tap detection restored and no longer overwritten by the focus button.
- Keyboard recognition cleanup â more reliable key detection and a tidier unmapped-button noise path.
- UI polish â preset improvements, cleaner arrow-key behavior, and a general cleanup pass.
đ About MindControl
MindControl is the ultimate button mapper + controller toolkit built for the iKKO MindOne and beyond:
- Remap hardware buttons with
Single/Double/Triple/Four/Fivepress,Hold,Press & Hold, and2x Press & Holdtriggers. - Screen-off remapping powered by low-level kernel event monitoring (
getevent -l). - A rich, customizable AOD with live media art, charging states, and notification mirroring.
- Zero network permissions. Zero telemetry. Everything stays on your device.
Full Changelog: https://github.com/Dinico414/MindControll/compare/2.1...3.0
Permissions
18 permissions requested









