# 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.