System Diagnostics

Troubleshooting

Most setup problems fall into one of four groups: Shizuku is not running, a required permission was denied, Android is not exposing the controller correctly, or a gyro mapping still needs tuning. Start with the section that matches the behavior you see.

terminal

Shizuku Problems

Shizuku access denied

expand_more
  • 01 Open the Shizuku app from your launcher.
  • 02 Navigate to Authorized applications.
  • 03 Toggle Axis Gamepad Pro back to the enabled state.
  • 04 Return to Axis and relaunch the engine session.

Axis stopped working after a reboot

expand_more

This is expected behavior. Shizuku is a user-mode process and does not persist after a system restart. Start the Shizuku service again through Wireless Debugging or ADB before reopening Axis.

note_add

Overlay and Permissions

Overlay editor missing

Confirm Display over other apps is explicitly enabled for Axis Gamepad Pro in Android system settings.

Foreground service warnings

On Android 13+, notification permission is required to keep the background process visible and reduce silent service kills.

Service keeps disappearing

Aggressive battery management from some vendors can stop Axis. Set battery usage to Unrestricted where available.

Android 12+ anti-tapjacking

System permission dialogs block touch overlays for security. Complete the system prompt first, then reopen your overlay editor inside Axis.

sports_esports

Controller Input

Buttons do not register

Verify the controller is exposed to Android as a real input device in Bluetooth or OTG settings. If the hardware supports alternate modes, try switching between X-Input and HID.

Only some controls work

Reset to a minimal layout with one movement input and one button. If that works, add new bindings gradually so mapping conflicts are easier to isolate.

360

Gyro & Aim Behavior

Camera drifts

Increase the deadzone threshold in advanced gyro settings until the camera settles while the device is still.

Aim too fast

Lower the horizontal and vertical sensitivity sliders before changing smoothing or acceleration.

Direction reversed

Use the Flip X or Flip Y toggles in the mapper if turning feels inverted inside the game.

Inconsistent aiming

Save the layout, change only one parameter at a time, and retest in the same gameplay scenario for clear feedback.

info Still Having Trouble?

Reset to the Basics

Return to the Installation & Setup guide, confirm Shizuku is active, and test again with a simple button-only layout before restoring your full profile.