C9 is a dual-cursor application that takes inspiration from T9 to provide clicks using the numpad on Android feature phones. Features of the application include:

• 🌎 Universal Android 7.0+ support via Shizuku as needed
• ⚡ Introduction of a grid cursor focused on efficiency
• 🖱️ Standard cursor to provide a traditional proxy for touchscreen gestures
• ⚙️ Remappable cursor activation keys and integration with button mappers
• 🔀 Translation of key presses into near-native taps, double taps, long press (and drag), scrolling, and zoom
• ✨ Additional quality-of-life features such as cursor auto-hide and landscape orientation support

• Overview
  • Grid Cursor
    • Instructions
  • Standard Cursor
    • Instructions
  • Example Usage
• Settings
• Installation
• Device Compatibility
• Troubleshooting
• Known Issues
• FAQs
• License
• Acknowledgment

The majority of modern applications are touch-oriented. The goal of C9 is to mimic the touchscreen gestures required of these applications as closely as possible by adapting button presses in each of the two cursor modes.

Because of their different navigation paradigms, each cursor mode maps gestures uniquely as will be shown below. While both modes can be enabled simultaneously (by mapping their activation key or shortcut), only one cursor can be active at a time. As a final note, all buttons in the numpad and D-pad are generally reserved/intercepted while the cursor is active.

The grid cursor trades precision for efficiency, taking advantage of the fact that many interactions with UI elements do not require pixel-by-pixel precision. n grid levels produce 9^n points onscreen that can be reached with at most n numpad clicks. The visualizations below show the points that can be reached with two grid levels/clicks (81 points), three grid levels/clicks (729 points), and four grid levels/clicks (6561 points).

A standard cursor is included for actions requiring more precision and for those who strictly prefer a traditional pointer. The demo above shows auto-hiding in text fields as well as long press and drag.

All gestures are dispatched at the tip of the cursor's current location.

• For precise clicks, you can use a) grid cursor mode or b) standard cursor with a low cursor speed and high cursor acceleration.
• In the standard cursor mode, both numpad 5 and D-pad center can be used to initiate a long press and drag. It may be easier to use either the numpad or D-pad to initiate the long press and use the other pad to drag.
• Enable C9 > Gesture Visualization to learn what each gesture is doing.
• Use C9 > Auto-Hide Cursor Options to auto-hide the cursor in select locations. See Settings for more information.
  • Automatic restoration is cancelled if any cursor is manually reactivated. Cursor auto-hide will resume the next time any of the enabled locations is observed.
  • The standard cursor's last position is saved upon restore.
• In the standard cursor mode, behavior at the edge of the screen can be set with C9 > Standard Cursor > Screen Edge Behavior.
• In the grid cursor mode, quickly navigate to the center of any cell in the current subgrid by pressing that cell's number followed by quick, successive presses of numpad 5.
• When using custom icons for the standard cursor, the following should be noted:
  • The top left of the file corresponds to the cursor's position. A tight crop is recommended.
  • Cursor performance may be impacted by file size and cursor size. If you are experiencing performance issues, try a smaller cursor size and/or compressing the file.
  • Because the file is scaled to fit within a square box, a 1:1 aspect ratio would fit the best, but other aspect ratios can be compensated for by adjusting the cursor size.
• The zoom fallback gestures can be used if an application does not interpret a regular zoom gesture correctly.
• Scroll distance will not exceed the edges of the screen; this behavior can be used on the fly to perform a scroll gesture with a distance smaller than the configured distance.
• Enable C9 > Developer Options > Ignore Numpad to allow typing while the cursor is activated. This may pair well with C9 > Standard Cursor > Control Scheme set to D-pad and C9 > Auto-Hide Cursor Options > Text Fields disabled.

The following settings and values are available.

The latest version can be found under releases. You can use GitHub's Watch > Custom > Releases option to be notified of new releases.

Install using the standard package installer. Allow the accessibility service using the banner in the application.

Install using adb:

>> adb install path/to/apk
>> adb shell settings put secure enabled_accessibility_services com.austinauyeung.nyuma.c9/com.austinauyeung.nyuma.c9.accessibility.service.OverlayAccessibilityService

Refer to the following table to determine if you will need to install Shizuku to use this application:

Once installed, navigate to, and enable, C9 > Developer Options > Enable Shizuku Integration.

Note that unless your device is rooted, you will need to restart the Shizuku service upon reboot.

The following devices have been confirmed by users and is not exhaustive.

If gestures do not work as expected, logs can be generated to help identify and fix any issues. Enable C9 > Developer Options > Collect Logs, duplicate the issue, and copy the logs in C9 > Developer Options > Log Screen and submit a GitHub issue. The example logs below correspond to the screen recording above.

--- SYSTEM INFORMATION ---
Device: Google sdk_gphone64_x86_64
Android Version: 15 (SDK 35)
Screen: 720 x 1232 pixels (density 2.0)

--- USER SETTINGS ---
...

--- LOG ENTRIES ---
[19:53:58.362] [D] Key event: KeyEvent { action=ACTION_DOWN, keyCode=KEYCODE_EQUALS, scanCode=13, metaState=0, flags=0x8, repeatCount=0, eventTime=14387767052000, downTime=14387767052000, deviceId=0, source=0x301, displayId=-1 }
[19:53:58.665] [D] Overlay mode changed: NONE -> CURSOR
[19:53:58.669] [D] Cursor state changed: true
[19:53:58.682] [D] Overlay view created and added to window manager
[19:53:58.886] [D] Key event: KeyEvent { action=ACTION_UP, keyCode=KEYCODE_EQUALS, scanCode=13, metaState=0, flags=0x8, repeatCount=0, eventTime=14388291421000, downTime=14387767052000, deviceId=0, source=0x301, displayId=-1 }
[19:53:59.716] [D] Key event: KeyEvent { action=ACTION_DOWN, keyCode=KEYCODE_ENTER, scanCode=28, metaState=0, flags=0x8, repeatCount=0, eventTime=14389121655000, downTime=14389121655000, deviceId=0, source=0x301, displayId=-1 }
[19:53:59.717] [D] Starting tap gesture at (360.0, 640.0)
[19:53:59.718] [D] DefaultGestureStrategy: starting tap at (360.0, 640.0)
[19:53:59.718] [D] Gesture paths changed: 1 paths
[19:53:59.746] [D] DefaultGestureStrategy: start tap completed successfully
[19:53:59.771] [D] Gesture paths changed: 0 paths
[19:53:59.798] [D] Key event: KeyEvent { action=ACTION_UP, keyCode=KEYCODE_ENTER, scanCode=28, metaState=0, flags=0x8, repeatCount=0, eventTime=14389190365000, downTime=14389121655000, deviceId=0, source=0x301, displayId=-1 }
[19:53:59.799] [D] Ending tap at (360.0, 640.0)
[19:53:59.799] [D] DefaultGestureStrategy: ending tap at (360.0, 640.0)
[19:53:59.808] [D] DefaultGestureStrategy: end tap completed successfully
[19:54:01.307] [D] Key event: KeyEvent { action=ACTION_DOWN, keyCode=KEYCODE_EQUALS, scanCode=13, metaState=0, flags=0x8, repeatCount=0, eventTime=14390712608000, downTime=14390712608000, deviceId=0, source=0x301, displayId=-1 }
[19:54:01.609] [D] Overlay mode changed: CURSOR -> NONE
[19:54:01.612] [D] Cursor state changed: false
[19:54:01.626] [D] Overlay view removed
[19:54:01.875] [D] Key event: KeyEvent { action=ACTION_UP, keyCode=KEYCODE_EQUALS, scanCode=13, metaState=0, flags=0x8, repeatCount=0, eventTime=14391281290000, downTime=14390712608000, deviceId=0, source=0x301, displayId=-1 }
[19:54:02.231] [D] Key event: KeyEvent { action=ACTION_DOWN, keyCode=KEYCODE_DPAD_RIGHT, scanCode=106, metaState=0, flags=0x8, repeatCount=0, eventTime=14391636575000, downTime=14391636575000, deviceId=0, source=0x301, displayId=-1 }
[19:54:02.322] [D] Key event: KeyEvent { action=ACTION_UP, keyCode=KEYCODE_DPAD_RIGHT, scanCode=106, metaState=0, flags=0x8, repeatCount=0, eventTime=14391727695000, downTime=14391636575000, deviceId=0, source=0x301, displayId=-1 }
[19:54:02.869] [D] Key event: KeyEvent { action=ACTION_DOWN, keyCode=KEYCODE_DPAD_RIGHT, scanCode=106, metaState=0, flags=0x8, repeatCount=0, eventTime=14392275611000, downTime=14392275611000, deviceId=0, source=0x301, displayId=-1 }
[19:54:02.950] [D] Key event: KeyEvent { action=ACTION_UP, keyCode=KEYCODE_DPAD_RIGHT, scanCode=106, metaState=0, flags=0x8, repeatCount=0, eventTime=14392344310000, downTime=14392275611000, deviceId=0, source=0x301, displayId=-1 }
[19:54:03.460] [D] Key event: KeyEvent { action=ACTION_DOWN, keyCode=KEYCODE_ENTER, scanCode=28, metaState=0, flags=0x8, repeatCount=0, eventTime=14392865662000, downTime=14392865662000, deviceId=0, source=0x301, displayId=-1 }
[19:54:03.507] [D] Key event: KeyEvent { action=ACTION_UP, keyCode=KEYCODE_ENTER, scanCode=28, metaState=0, flags=0x8, repeatCount=0, eventTime=14392912821000, downTime=14392865662000, deviceId=0, source=0x301, displayId=-1 }

A green banner on the main page indicates that Shizuku authorization has been granted to C9. Only the third screenshot below indicates successful authorization.

If you are unable to deactivate the cursor, clear the internal activation key, which unmaps that cursor and hides any active cursor, even if it was activated using a button mapper.

• On the Vortex V3, the numpad backlight may not function when the cursor is active.
  • This is likely due to a firmware limitation in the phone as well as the cursors' interception of key presses. There is an experimental setting "Allow Passthrough" that may fix this at the expense of unintended behavior in the underlying application.

You can use the issues tab for both. For bugs, please provide logs using the built-in logger or adb logcat C9App:V *:S.

Please feel free to submit a pull request, create a video walkthrough, confirm your device's compatibility, or provide anything else you think would be helpful!

Shizuku allows applications in general to perform actions that require elevated privileges. In C9, it is required to dispatch gestures on Android 11 using InputManager instead of the standard dispatch using AccessibilityService.

The cursors sit between your button presses and the underlying application. If a button is used by the cursor, the cursor will consume it and prevent the underlying application from receiving the button press.

Apache License Version 2.0

• Allegra and Arlie for their support
• Everyone on the releases page for their feature suggestions and bug reports
• sam-club for extensive initial testing
• Dev-in-the-BM for initial testing and the Shizuku suggestion
• anonymousfliphones for initial testing

As the package name would suggest, this application is dedicated to my late cat, Nyuma.