sdl2-jstest is a simple program that lets you find out how many joysticks SDL2 detected on your system, how many axes, buttons, hats and balls they have each. It also lets you test the joysticks by displaying the events they send or by displaying their current button, axis, hat or ball state.
This version of sdl2-jstest has been modified and expanded for the Electron Mupen64Plus GUI with the following options being new:
-ls, --listsimple
-es, --eventsimple JOYNUM
-i, --identifier JOYNUM
-m, --mapping JOYNUM
The option to display a graphical representation of the current joystick state has been removed in favor of less dependencies.
sdl2-jstest requires the following packages to build:
-
Windows (MSYS2 MINGW64):
pacman -S --needed mingw-w64-x86_64-cmake mingw-w64-x86_64-SDL2 -
Ubuntu/Debian (apt):
sudo apt install -y cmake libsdl2-dev -
Fedora (dnf):
sudo dnf install cmake SDL2-devel -
Arch Linux (pacman):
sudo pacman -S --needed cmake sdl2 -
openSUSE Tumbleweed (zypper):
sudo zypper install SDL2-devel cmake
Optionally, put gamecontrollerdb.txt from SDL_GameControllerDB into the same folder as the binary to improve the joystick mapping function.
To compile type:
mkdir build
cd build
cmake ..
make
If needed, run cmake .. -G "MSYS Makefiles" or cmake .. -G "Unix Makefiles" instead of cmake .. to change the generator.
-h, --help Print this help
-v, --version Print version number
-l, --list Search for available joysticks and list their properties
-ls, --listsimple Search for available joysticks and list their index and name
-g, --gamecontroller JOYNUM Test game controller
-e, --event JOYNUM Display the events that are received from the joystick
-es, --eventsimple JOYNUM Display an event from the joystick and quit
-i, --identifier JOYNUM Print joystick GUID
-m, --mapping JOYNUM Print joystick mapping
-r, --rumble JOYNUM Test rumble effects on gamepad
sdl2-jstest -ls
sdl2-jstest -es 1