47 lines
2.2 KiB
Markdown
47 lines
2.2 KiB
Markdown
# 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.
|