This repository has been archived by the owner. It is now read-only.
C Roff CMake
Switch branches/tags
Nothing to show
Clone or download
Grumbel Merge pull request #11 from bentley/master
Document all current flags
Latest commit 34042f6 Jan 14, 2018
Failed to load latest commit information.
debian Replaced with Jun 25, 2015
.travis.yml Updated travis.yml to clang-5.0 Oct 18, 2017
CMakeLists.txt Added instructions for cross-compilation to Win32. Oct 17, 2017
sdl-jstest.1 Fix typo: "recieved" -> "received". Jan 14, 2018
sdl-jstest.c Fix typo: "recieved" -> "received". Jan 14, 2018
sdl2-jstest.1 Fix typo: "recieved" -> "received". Jan 14, 2018
sdl2-jstest.c Fix typo: "recieved" -> "received". Jan 14, 2018


sdl-jstest and sdl2-jstest are simple programs that lets you find out how many joysticks SDL or SDL2 detected on your system, how many axes, buttons, hats and balls they have each. They also lets you test the joysticks by displaying the events they send or by displaying their current button, axis, hat or ball state. sdl-jstest is especially useful if you want to test your SDL_LINUX_JOYSTICK configuration.


sdl-jstest requires the following packages to build:

  • cmake
  • libsdl1.2-dev
  • libsdl2-dev
  • libncurses5-dev

For building the manpages:

  • docbook2x


To compile type:

mkdir build
cd build
cmake ..

To install (optional):

make install

The DESTDIR and PREFIX can be configured as follows:

make install DESTDIR=/tmp/pingus


Cross-compilation to Win32

MXE ( is needed. Follow its installation instructions, but you can build it with just the needed packages for sdl-jstest:

make gcc cmake sdl sdl2 ncurses pdcurses

This still takes quite a while.

After MXE installation finishes, for sdl-jstest compilation type:

mkdir build
cd build
i686-w64-mingw32.static-cmake ..


The SDL behaviour of what axis is treated as a hat and which as normal axis can be configured with the environment variable SDL_LINUX_JOYSTICK:


SDL_LINUX_JOYSTICK: Special joystick configuration string for linux. The format is "name numaxes numhats numballs" where name is the name string of the joystick (possibly in single quotes), and the rest are the number of axes, hats and balls respectively.

A simple example would be:

$ export SDL_LINUX_JOYSTICK="'Xbox Gamepad (userspace driver)' 6 0 0"

Which makes all axis be handled as normal axis and none as hat, as most games don't use hats.