mdqinc/SDL_GameControllerDB resource
A community sourced database of game controller mappings to be used with SDL Game Controller functionality observed · 2026-08-28
Health v2 · maintenance only
77/100
- Activity 99
- Release rhythm 35
- Longevity 100
Flags: no_releases
How is this computed?
round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10) — computed 2026-09-03. Adoption (stars, forks) is never an input.
- gap_med: n/a
- age_days: 4662
- days_rel: n/a
- days_push: 8
- n_releases_24m: 0
Adoption not part of the score
1756 stars · 607 forks observed · 2026-08-28
What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded
A community-sourced database of game controller mappings (gamecontrollerdb.txt) for SDL2 and SDL3's Game Controller API. It maps controller GUIDs to button and axis layouts across platforms so games can support many gamepads without per-device code.
Use cases
- add gamepad support to an SDL game without writing per-controller code
- fix a controller not being recognized in an SDL2 or SDL3 app
- load community controller mappings from a file at runtime
- find the correct mapping string for a specific gamepad model
- contribute a new controller mapping for an unsupported device
When to choose
- your game or emulator uses SDL's Game Controller API and needs broad gamepad compatibility
- you want a maintained, community-tested mapping file instead of hand-writing mappings
- you need mappings across Windows, macOS, Linux, iOS, and Android
When to avoid
- your engine or framework has its own input abstraction and doesn't use SDL
- you need raw joystick or force-feedback handling outside SDL's controller model
- you need runtime GUI mapping creation rather than a static database
Facets
dataset · maturity active
game-engine developer-tools gaming-tools cross-platform cross-platform windows sdl sdl2 sdl3 gamepad controller-mappings community-database game-development macos linux android ios
3 sources
- readme: https://github.com/mdqinc/SDL_GameControllerDB · fetched 2026-08-28 · ae240117078a
- homepage: http://libsdl.org · fetched 2026-08-29 · 604158a043bf
- site_page: https://libsdl.org/index.php · fetched 2026-08-29 · bd8a0122ed56
Member repositories
| Repository | Role | Health v2 |
|---|---|---|
| mdqinc/SDL_GameControllerDB | main | 77 |
For agents
markdown · JSON · MCP: product_card(name="mdqinc/SDL_GameControllerDB")
Data as of 2026-08-30T08:39:29.467469+00:00 · Report a problem