Mapping Config Reference

An optional --mapping TOML file overrides the default button/axis pass-through with remapping, gyro mouse, stick modes, layers, and macros.

Top-level Fields

name = "fps"

Field	Type	Description
`name`	string	Mapping profile name

Top-level button remapping (active when no layer overrides). Keys are ButtonId names, values are target button names, KEY_* codes, mouse_left/mouse_right/mouse_middle/mouse_side, disabled, or macro:<name>.

[remap]
M1 = "KEY_F13"
M2 = "mouse_side"
M3 = "disabled"
A = "B"
M4 = "macro:dodge_roll"

`[gyro]`

Global gyro-to-mouse configuration.

[gyro]
mode = "mouse"
activate = "L3"
sensitivity = 2.0
deadzone = 300
smoothing = 0.4
curve = 1.0
invert_y = true

Field	Type	Default	Description
`mode`	string	`"off"`	`"off"` or `"mouse"`
`activate`	string	—	Button name to hold for activation (e.g. `"L3"`, `"hold_RB"`)
`sensitivity`	float	—	Overall sensitivity multiplier
`sensitivity_x`	float	—	X-axis sensitivity override
`sensitivity_y`	float	—	Y-axis sensitivity override
`deadzone`	integer	—	Raw gyro deadzone threshold
`smoothing`	float	—	Smoothing factor (0–1)
`curve`	float	—	Acceleration curve exponent
`max_val`	float	—	Maximum output value cap
`invert_x`	bool	—	Invert X axis
`invert_y`	bool	—	Invert Y axis

`[stick.left]` / `[stick.right]`

Per-stick mode configuration.

[stick.left]
mode = "gamepad"
deadzone = 128
sensitivity = 1.0

[stick.right]
mode = "mouse"
sensitivity = 2.5
deadzone = 100
suppress_gamepad = true

Field	Type	Default	Description
`mode`	string	`"gamepad"`	`"gamepad"`, `"mouse"`, or `"scroll"`
`deadzone`	integer	—	Stick deadzone threshold
`sensitivity`	float	—	Sensitivity multiplier
`suppress_gamepad`	bool	—	Suppress gamepad axis output when in mouse/scroll mode

`[dpad]`

D-pad mode configuration.

[dpad]
mode = "gamepad"

Field	Type	Default	Description
`mode`	string	`"gamepad"`	`"gamepad"` or `"arrows"` (emits arrow keys)
`suppress_gamepad`	bool	—	Suppress gamepad d-pad output when in arrows mode

`[[layer]]`

Each layer defines an activation condition and overrides for remap, gyro, sticks, and d-pad. Layers are evaluated in declaration order.

[[layer]]
name = "fps"
trigger = "LM"
activation = "hold"
tap = "mouse_side"
hold_timeout = 200

Field	Type	Required	Description
`name`	string	yes	Unique layer identifier
`trigger`	string	yes	Button name that activates this layer
`activation`	string	no	`"hold"` (default) or `"toggle"`
`tap`	string	no	Button/key emitted on short press (when using hold activation)
`hold_timeout`	integer	no	Hold detection threshold in ms (1–5000)

`[layer.remap]`

Per-layer button remapping. Same syntax as top-level [remap].

[layer.remap]
RT = "mouse_left"
A = "KEY_R"

`[layer.gyro]`

Per-layer gyro override. Same fields as [gyro].

[layer.gyro]
mode = "mouse"
sensitivity = 8.0
deadzone = 40
smoothing = 0.4
invert_y = true

`[layer.stick_left]` / `[layer.stick_right]`

Per-layer stick overrides. Same fields as [stick.left]/[stick.right].

[layer.stick_right]
mode = "mouse"
sensitivity = 2.5
deadzone = 100
suppress_gamepad = true

`[layer.dpad]`

Per-layer d-pad override. Same fields as [dpad].

[layer.dpad]
mode = "arrows"
suppress_gamepad = true

`[layer.adaptive_trigger]`

Per-layer adaptive trigger override. Same fields as top-level [adaptive_trigger].

`[adaptive_trigger]`

DualSense adaptive trigger configuration.

[adaptive_trigger]
mode = "feedback"

[adaptive_trigger.left]
position = 70
strength = 200

[adaptive_trigger.right]
position = 40
strength = 180

Field	Type	Default	Description
`mode`	string	`"off"`	`"off"`, `"feedback"`, `"weapon"`, or `"vibration"`
`command_prefix`	string	`"adaptive_trigger_"`	Command template prefix in device config

`[adaptive_trigger.left]` / `[adaptive_trigger.right]`

Field	Type	Description
`position`	integer	Trigger position threshold
`strength`	integer	Resistance strength
`start`	integer	Start position (weapon mode)
`end`	integer	End position (weapon mode)
`amplitude`	integer	Vibration amplitude
`frequency`	integer	Vibration frequency

`[[macro]]`

Named sequences of input steps bound via macro:<name> in remap values.

[[macro]]
name = "dodge_roll"
steps = [
    { tap = "B" },
    { delay = 50 },
    { tap = "LEFT" },
]

[[macro]]
name = "shift_hold"
steps = [
    { down = "KEY_LEFTSHIFT" },
    "pause_for_release",
    { up = "KEY_LEFTSHIFT" },
]

Step types:

Step	Description
`{ tap = "KEY" }`	Press and release a key
`{ down = "KEY" }`	Press and hold a key
`{ up = "KEY" }`	Release a key
`{ delay = N }`	Wait N milliseconds
`"pause_for_release"`	Wait until the trigger button is released

Bind a macro in remap: M1 = "macro:dodge_roll"

padctl