mdqinc / SDL_GameControllerDB

A community sourced database of game controller mappings to be used with SDL Game Controller functionality

1,667 stars

574 forks

3 issues

Python

Chat with Codebase Architecture Scan Security Audit Explain Codebase

AI Architecture Analysis

This repository is indexed by RepoMind. By analyzing mdqinc/SDL_GameControllerDB in our AI interface, you can instantly generate complete architecture diagrams, visualize control flows, and perform automated security audits across the entire codebase.

Our Agentic Context Augmented Generation (Agentic CAG) engine loads full source files into context on-demand, avoiding the fragmentation of traditional RAG systems. Ask questions about the architecture, dependencies, or specific features to see it in action.

Source files are only loaded when you start an analysis to optimize performance.

Click here to launch the interactive analysis workspace

Embed this Badge

Showcase RepoMind's analysis directly in your repository's README.

[![Analyzed by RepoMind](https://img.shields.io/badge/Analyzed%20by-RepoMind-4F46E5?style=for-the-badge)](https://repomind.in/repo/mdqinc/SDL_GameControllerDB)

Preview:

Repository Overview (README excerpt)

Crawler view

SDL_GameControllerDB A community sourced database of game controller mappings to be used with SDL2 and SDL3 Game Controller functionality. Usage Download gamecontrollerdb.txt, place it in your app's directory and load it. SDL2: SDL3: The database is compatible with SDL v2.0.10 and newer. Create New Mappings A mapping looks like this: It includes controller GUID ( ), a name ( ), button / axis mappings ( ) and a platform ( ). Please make sure to check that the name is a good description of the controller. If relevant, include the controller's name and model number. Mapping Guide Mapping Tools There are a few different tools that let you create mappings. SDL2 Gamepad Tool Third party cross-platform tool with GUI (Windows, macOS and Linux) *While convenient, this tool has fallen out of date as SDL has amended and added new features for gamepad support (see #478). Maps authored with this tool require maintainer scrutiny to ensure they will not break support for explicit mappings the SDL project provides.* SDL testcontroller (SDL3) and controllermap (SDL2) utilities are the official tools to create these mappings on all SDL supported platforms (Windows, Mac, Linux, iOS, Android, etc). Contributing First, please confirm for yourself • Your device is a gamepad • Your mapping best represents the Xbox layout per the mapping guide • An acceptable mapping is not already present in the DB, searching by platform and GUID • Adding the mapping to the db improves, and does not degrade, the experience of using the gamepad Contribute by opening a pull request, or creating an issue Resources SDL2 • Game Controller Support • SDL_GameControllerAddMappingsFromFile SDL3 • Gamepad Support • SDL_AddGamepadMappingsFromFile