Button Manager Config Format

INI-style config at /data/misc/ax86_btn_manager.conf. This file is the source of truth. Keylayout (.kl) overlays under /data/system/devices/keylayout/ are generated from it and are not meant to be edited by hand.

Top level

version=1

Button sections

One [button.<id>] section per mapping.

Field	Required	Description
`label`	no	Name shown in the UI
`device_match`	yes	Input device name, or `*` for any device
`scan_code`	for intercept	evdev scan code, hex (`0x190`) or decimal
`android_key`	no	Symbolic Android keycode. Prefer `KEYCODE_BUTTON_1` through `KEYCODE_BUTTON_16` for hardware P-keys
`action`	yes	`screenshot`, `keyevent`, `keycombo`, `activity`, `device_control`, `broadcast`, `passthrough`
`long_press`	no	`true` / `false`

Action-specific fields

Action	Fields
`keyevent`	`emit_key=KEYCODE_*` (falls back to `android_key`)
`keycombo`	`keys=ctrl+alt+backspace`
`activity`	`component=pkg/.Activity`, optional `flags=NEW_TASK`
`device_control`	`control=...` plus control params
`broadcast`	`intent=<action>`, optional `component=pkg/.Receiver`

device_control params

Percent values are 0-100.

`control`	Params
`brightness_toggle`	`low`, `high`
`brightness_set`	`level`
`volume_up` / `volume_down`	`stream` (media/ring/alarm/notification/system), `step`
`volume_mute_toggle`	`stream`
`volume_set`	`stream`, `level`
`rotation_lock_toggle`, `auto_brightness_toggle`, `night_mode_toggle`, `screen_timeout_cycle`, `wifi_toggle`, `bluetooth_toggle`, `airplane_mode_toggle`, `location_toggle`, `mic_mute_toggle`, `ringer_mode_cycle`, `speakerphone_toggle`, `dnd_toggle`, `media_play_pause`, `media_next`, `media_previous`, `lock_screen`, `show_touches_toggle`	none required

Global section

[global]
intercept_mode=consume
reload_on_boot=true

Android keycodes and `.kl` overlays

For hardware function keys (P1/P2/P3), use KEYCODE_BUTTON_1 through KEYCODE_BUTTON_16. Those produce valid .kl labels (BUTTON_1, and so on). KEYCODE_F1 through F12 also work. Names like PROG1 are not valid .kl labels.

Example

[button.P4]
label=Brightness
device_match=*
scan_code=0x193
action=device_control
control=brightness_toggle
low=0
high=100

Apply / reload

adb push ax86_btn_manager.conf /data/misc/
adb shell cmd ax86_btnmgr reload

Or:

adb shell setprop persist.ax86.btnmgr.reload 1