A guided-capture tool that helps you add InputPlumber support for a new device by prompting you to press each Steam-Deck-canonical button, then emitting the required CompositeDevice + CapabilityMap YAML files.
Status: early scaffold. First target device: AYANEO Pocket ACE (via Armada).
InputPlumber's onboarding for a new device is entirely manual:
- Read
/sys/firmware/devicetree/base/model(or DMI on x86). - Enumerate every
/dev/input/event*and/dev/hidraw*, guess which ones belong to the built-in gamepad. - Press every button, watch
evtestoutput, hand-copy the evdev codes. - Hand-write two YAML files.
ipcap collapses steps 2–4 into a wizard.
See RESEARCH.md for the full write-up. Short version:
ipcap.canonical— single source of truth for the Steam-Deck-canonical button/axis vocabulary (mirrored from InputPlumber'sGamepadButtonenum).ipcap.discover— DMI +/sys/firmware/devicetree+/dev/input/event*+/dev/hidraw*enumeration.ipcap.capture— evdev/hidraw event capture with a per-prompt timeout.ipcap.mapper— session state:{canonical_name → observed (node, event_type, event_code, value_type)}.ipcap.emit— pure function: mapper state → validatedCompositeDevice.yaml+CapabilityMap.yaml.ipcap.ui— PyQt6 wizard; deferred until headless core is stable.
The core (canonical, discover, emit, YAML validation) runs anywhere Python 3.12 does. Live capture requires:
- Linux with
/dev/input/event*and the target gamepad plugged in. python-evdev(built against kernel headers ≥ 6.5 for newest key codes).- Optional:
python3-pyqt6for the wizard UI.
On this Azure VM we develop and test the headless modules. Live capture and the UI wizard are exercised on the actual handheld (e.g. win5 or the Pocket ACE running Armada).
cd projects/inputplumber-suite
python3 -m venv .venv
. .venv/bin/activate
pip install -e '.[dev]' # once pyproject exists
python -m pytest tests/ # everything except live-captureArmada currently lists Pocket ACE as untested. The device conf sets ARMADA_GAMEPAD_QUIRK=ayaneo-xbox, but the 01-ayaneo-controller.yaml CompositeDevice only matches EVO/DS/S 2K. First contribution goal:
- Run
ipcap captureon a Pocket ACE with Armada booted. - Compare captured evdev vocabulary against
ayaneo_mcu_xbox.yaml. - If it matches, submit a one-line PR adding
AYANEO Pocket ACEto thematches:block. - If it doesn't, submit a PR with a new capability_map + composite update.
Either way, the tool proves itself and delivers real value upstream.
GPLv3+ to match InputPlumber.