sdl-jstest (1)

NAME
sdl-jstest - A joystick test application for SDL

SYNOPSIS
sdl-jstest
[--help] [--version] [--list] [--test JOYNUM] [--event JOYNUM]

DESCRIPTION

\FC-h\F[], \FC--help\F[]
    Display help text and exit.

\FC--version\F[]
    Display the version number and exit.

\FC--list\F[]
    Search for available joysticks and list their properties.

\FC--test\F[] JOYNUM
    Display a graphical representation of the current joystick state.

\FC--event\F[] JOYNUM
    Display the events that are recieved from the joystick.

SDL CONFIGURATION
What SDL detects as axis, what is treated as a hat and what is handled 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 \FC"name numaxes numhats numballs"\F[] 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:

\FC$ export SDL_LINUX_JOYSTICK="'Xbox Gamepad (userspace driver)' 6 0 0"\F[]

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

A complete list of which environment variables SDL supports can be found at:

•

SEE ALSO
jstest(1), jstest-gtk(1), sdl2-jstest(1), xboxdrv(1)