A controller remapping app for ARM64 handhelds running Armada.
It edits supported InputPlumber button assignments, saves them across reboots, and provides Undo and Restore defaults from a touch-friendly desktop interface.
Current release: 0.7.0 — first public preview
The main target is the KONKR Pocket FIT Elite, including its two MCU-controlled rear buttons. Ordinary InputPlumber remapping is also designed to work on other compatible Armada devices.
- Remap supported controller buttons, extra inputs and reported keyboard keys.
- Choose existing application actions or built-in Steam shortcut presets where supported.
- Save mappings for startup and undo the last apply.
- Restore Armada's shipped defaults and remove the installed app and remapping setup through reviewed controls.
- Give unfamiliar inputs personal names inside the app.
- Use the interface with touch, mouse, keyboard or optional controller navigation.
- Configure hardware rear-button assignments on a verified KONKR Pocket FIT Elite.
Available buttons and actions depend on the device configuration and outputs exposed by InputPlumber.
| Device | Current status |
|---|---|
| KONKR Pocket FIT Elite | Primary target. Ordinary remapping has been hardware-tested. MCU rear assignments, reboot persistence and Restore defaults are confirmed on hardware. |
| Odin 3 | App installation, launch, discovery and fresh remapping setup have been tested. It uses the generic InputPlumber path; no MCU backend is enabled. |
| Other Armada devices | Ordinary remapping can work when InputPlumber exposes a compatible editable configuration and suitable outputs. |
MCU support is validated separately for each device. The regular KONKR Pocket FIT has not yet been verified for MCU writes. A matching interface may be shown read-only, but editing stays disabled until its real button output, reboot persistence, Restore defaults and Undo have been tested.
Use the release on ARM64 Armada in Desktop Mode:
- Download
ArmadaController-Installer-0.7.0-aarch64.zipfrom Releases. - Extract the ZIP.
- If necessary, open the AppImage's Properties → Permissions and enable Is executable.
- Open the AppImage and choose Install app.
- Leave Set up remapping selected on a fresh installation and enter your administrator password when asked.
- Choose Open app.
The app installs under ~/Applications and adds an application-menu entry. See INSTALL.md for updating, portable use, defaults restoration and removal.
- Select a controller and button.
- Choose an available action.
- Select Review changes → Apply and save.
- Test the result in Desktop or Gaming Mode.
On a Pocket FIT Elite, open Rear assignments… to configure its hardware rear buttons. Changes persist with the app closed. Undo last apply… restores the preceding saved state, while Restore defaults… returns supported mappings to Armada's shipped configuration.
Updating or reinstalling the desktop app keeps existing mappings. A diagnostic report describes the current setup; it is not a settings backup.
- InputPlumber 0.78.1 and 0.79.0 are the currently reviewed versions.
- Keyboard actions require an enabled keyboard output. The tested Odin 3 setup exposes only the Steam Deck controller output.
- Steam shortcuts require the Steam Deck target and suitable outputs; behavior can also depend on the active Steam layout.
- Separate tap and hold actions, arbitrary combinations, and stick, trigger or trackpad movement editing are not available yet.
- MCU editing is currently verified only on the KONKR Pocket FIT Elite. MCU Undo has automated coverage but still needs a physical test.
The app uses Python, PySide6/Qt and Armada's installed InputPlumber service. Protected mapping changes use a typed helper through normal system authentication. Persistent overrides and recovery data are stored in Armada's writable /etc and /var locations; the immutable system image is not unlocked.
The AppImage currently requires ARM64 Armada with system Python 3.14 and glibc 2.39 or newer.
From a source checkout, create a virtual environment, install
requirements.txt, and run ./run.sh. Run the test suite with
.venv/bin/python -m unittest discover -s tests -v. The downloadable AppImage
is built with scripts/package-armada.py; this repository is not published as
a pip application.
Copyright © 2026 mrdidit and contributors. Original Armada Controller (RE)Mapper code is released under GPL-3.0-only. Third-party and upstream reference material keeps its original licence; see SOURCES.md.