Your bindings, visualized in seconds.
Automatically create hardware-accurate visual reference cards for your HOTAS setup, directly from your game configuration files.
Download Free · Documentation · Report Bug · Request Feature
Joystick Diagrams reads your game config files and generates hardware-accurate visual diagrams of every button, axis, hat switch, and modifier on your controllers.
No manual data entry. No design skills needed. Always in sync with your actual bindings.
If you've ever found yourself:
- Memorizing bindings through repetition
- Building reference cards in PowerPoint or Photoshop by hand
- Printing ugly, unreadable binding lists from the game settings
- Pausing mid-flight to check which button does what
...this is what I built it to fix.
| Game | Import Type |
|---|---|
| DCS World | Per-aircraft profiles |
| Microsoft Flight Simulator 2020 | Controller bindings |
| Star Citizen | Action maps |
| IL-2 Sturmovik: Great Battles | Controller bindings |
| Joystick Gremlin | Macro profiles (covers any game) |
More games can be added through the open plugin system.
46+ SVG templates matching the exact physical layout of real HOTAS hardware. Bindings show up on the diagram right where the button sits on the actual device.
| Manufacturer | Devices |
|---|---|
| Virpil Controls | Constellation ALPHA (L/R/Prime), MT-50CM2 Stick & Throttle, WarBRD, VFX, Control Panel |
| WinWing | Orion2 (F-16, F-18, F-15EX), URSA MINOR, Super Taurus Throttle, ICP, MFD, UFC, HUD panels |
| VKB Sim | Gladiator NXT (L/R) |
| Thrustmaster | Warthog Joystick & Throttle, T.16000M Joystick (L/R) & Throttle |
| Saitek/Logitech | X52, X56 H.O.T.A.S. (Stick & Throttle), X56 Rhino |
| CH Products | Fighterstick, Pro Throttle |
| Total Controls | Apache MPD, Multi-Function Button Box |
A starter template is included for creating custom device layouts using draw.io.
- Automatic Binding Import. Point the app at your game's config folder and every binding is extracted. Change a binding in-game, re-run the export, done.
- Hardware-Accurate Diagrams. 46+ templates matching real HOTAS hardware layouts. Glance at the diagram and know exactly which physical button does what.
- Custom Labels. Override verbose game action names with your own text. "Weapon Fire Primary Mode Toggle" becomes "Guns".
- SVG & PNG Export. SVG for print-quality output at any size. PNG at 2x resolution for sharing on Discord, forums, or as stream overlays.
- Batch Export. Select multiple profiles and devices, export them all at once. Regenerate all your aircraft diagrams in seconds.
- Profile Inheritance. Set parent profiles so common bindings carry through. Only document the differences per aircraft.
- Device Management. Hide devices you don't need for a particular aircraft. Manage visibility from Settings.
- Plugin Architecture. Open plugin system for adding new game support. Community can contribute parsers for new titles.
- Setup. Install the app, add your game plugins, point each at the game's config folder. Profiles and devices are discovered automatically.
- Customise. Browse profiles by game and aircraft. Rename actions with custom labels. Hide devices you don't need.
- Export. Pick your profiles, choose a template for each device, select SVG or PNG, hit Export. Diagrams land in your chosen folder.
- Download the latest release
- Unzip to your preferred location
- Launch
Joystick Diagrams.exe
For setup guidance, see the documentation.
git clone https://github.com/Rexeh/joystick-diagrams.git
cd joystick-diagrams
poetry install- Discord. Join the Joystick Diagrams Discord for support, template sharing, and feature requests.
- Issues. Report bugs via GitHub Issues.
- Templates. Community members contribute new device templates regularly.
Contributions are welcome: new device templates, game plugins, bug fixes, documentation. Open a PR or start a conversation on Discord.
Distributed under the GPL-2.0 License. See LICENSE for more information.