ajp_anton/navbuttons
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 6 Wiki Activity
Files
6b11e76504b91e55c79a8e8d5002a1e51a19922c
navbuttons/README.md
T

2.2 KiB
Raw Blame History

NavButtons

NavButtons is an Android LSPosed module for customizing the three-button navigation bar.

It lets you choose what should happen when Back, Home, or Recents is pressed or long-pressed, and lets you configure the long-press duration per button.

Features

  • Configure press and long-press actions for Back, Home, and Recents.
  • Keep the stock Android behavior with the Stock action.
  • Disable a press with the None action.
  • Reassign navigation actions: Back, Home, Assistant, and Recents.
  • Kill the foreground app.
  • Toggle auto-rotate.
  • Toggle the flashlight.
  • Add optional side-arrow buttons for moving the text cursor left and right.
  • Configure side-arrow long-press behavior, including repeated cursor movement.
  • Test long-press durations from the settings screen.

Requirements

  • Android device using three-button navigation.
  • LSPosed with Xposed API 101 or newer.
  • Android 14 / API 34 or newer.
  • The module enabled for the relevant navigation packages.

The module declares scope entries for:

  • android and system, used for privileged actions such as killing the foreground app.
  • com.android.systemui, used for phone navigation bars.
  • com.android.launcher3 and com.google.android.apps.nexuslauncher, used for AOSP/Google taskbar navigation.
  • com.sec.android.app.launcher and com.samsung.systemui.navillera, used for Samsung/One UI navigation.

Tested On

  • Samsung Galaxy Z Fold5 running One UI 8.0 / Android 16 with Magisk and LSPosed.
  • AOSP emulator API 34 / Android 14 with Magisk and LSPosed.
  • AOSP emulator API 35 / Android 15 with Magisk and LSPosed.
  • AOSP emulator API 36 / Android 16 with Magisk and LSPosed.
  • Android 16 Google APIs emulator with Magisk and LSPosed.

The emulator tests covered button press overrides, long-press overrides with custom duration, side-arrow visibility, side-arrow tinting, enabling/disabling side arrows, and side-arrow long-press repeat behavior where supported by the emulator navigation implementation. Actual device testing with others than the Galaxy Z Fold 5 has not been done. Compatibility may vary between Android versions and vendor System UI / launcher implementations.

AI Assistance

This project was developed with help from AI-assisted coding tools.

Reference in New Issue View Git Blame Copy Permalink