Windows-first controller mapping for creative shortcuts, desktop navigation, and media control.
Overview | English | Korean | Chinese | Japanese
| Area | Detail |
|---|---|
| Platform | Windows desktop |
| Core model | Device -> App Profile -> Preset -> Button Mapping |
| Practical controller focus | 8BitDo Zero 2 and Xbox/XInput-family devices |
| Main workflows | Creative apps, one-handed shortcuts, media control, desktop navigation |
Latest stable release: BBCC v0.1.1
Windows ZIP:
Current prerelease: BBCC v0.1.2
Prerelease Windows ZIP:
Release artifacts should be distributed through GitHub Releases, not committed into the source tree.
The connected controller view shows the remembered device, mapping table, Inspector, and profile settings flow.
View full demo walkthrough
The demo flow selects the connected 8BitDo Zero 2 gamepad, reviews the mapping table, checks raw input in Inspector, and opens app-profile settings.
- Run
dist\BBCC.exe. - Confirm that the controller is shown as
Connectedon the first screen. - Click the connected device row.
- Review shortcut assignments and labels in the
button_mappingstable. - Select a button row to edit its shortcut and label in
mapping_editor. - Click
Inspectorin the top-right area to check raw axes, buttons, hats, backend, and GUID values. - Open
Profile Settingsto manage fallback and app-specific profiles by process name.
The first screen confirms that the controller is detected and connected. Select the remembered device row to open its mappings.
The mapping view shows the active app profile, button bindings, labels, and the editor panel used to adjust a selected binding.
The Inspector button opens live raw input values, including axes, buttons, hats, backend information, and device GUID details.
Profile Settings opens the app-profile editor, where fallback and app-specific profiles can be named and matched by process name.
- BBCC is a Windows-first project
- Browser-based media fallback behavior is part of the broader media workflow
- Layouts and mappings are still being refined
- Some device handling is still evolving as controller coverage expands
Bug reports and pull requests are welcome. If you want support for another controller model, please open an issue and include the device name, what happened, and what you expected.
py -3 -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip
pip install -r requirements-dev.txt
python -m zero2_input_inspector- English README
- Korean README
- Chinese README
- Japanese README
- Download and release notes
- Safety and Privacy
- Support Runbook
- Release Checklist
- Third-Party Notices
- Portfolio case study
- GitHub metadata note
This overview is intentionally short. Detailed setup, architecture, limitations, and localized walkthroughs live in the linked README files.