Freedom251 › Controller Mapping Software
QJoyPad
What QJoyPad is
QJoyPad is a free Linux utility that converts gamepad or joystick input into keyboard presses and mouse actions for programs running in XWindows. It can let users control XWindows games without native joystick support, and the project also describes use with emulation software. Multiple controller layouts can be saved and switched from the interface, a command-line call, or a shell script. A joystick can move and click the mouse, with configurable axis sensitivity and movement behavior. Buttons can be assigned sticky presses or rapid fire, while axes support gradient behavior and throttle controls. QJoyPad detects Linux-supported joysticks and gamepads, including devices with more than two axes, when the Linux kernel recognizes the hardware and its driver is loaded. It can run in the system tray or without a tray icon; the --notray option provides a larger floating icon. The project is open source under GPL-2.0. Documented requirements are a Linux computer, XWindows, Qt 5, and kernel joystick support, with libudev optional. The GitHub fork documents a source installation using CMake and make. Support is directed through GitHub issues, with an email address for layout-file help.
Who it suits
QJoyPad suits Linux users who want to map controllers to keyboard or mouse actions in XWindows games, emulators, and other XWindows programs. It also fits users who need several switchable layouts or scripted profile changes.
What it does well
- Free and open source under GPL-2.0
- Maps controller input to keyboard and mouse actions
- Saves and switches multiple layouts
- Supports sticky buttons, rapid fire, gradients, and throttles
- Works with Linux-supported multi-axis controllers
- Layout switching works through commands and shell scripts
What to know first
- Works only on Linux and XWindows
- Does not work at the console or on Microsoft Windows
- Requires kernel joystick support, XWindows, and Qt 5
- Documented installation requires building from source
Limits
QJoyPad is limited to Linux and XWindows; it does not run at the console or on Microsoft Windows. The documented route is a source build, and the controller must be recognized by the Linux kernel with its driver loaded.
Plans
| Plan | Billed and limits | Price |
|---|---|---|
| Free (open source) | Completely free · GPLv2 · source code | Free |
As github.com lists them, read 10 Oct 2026. The maker's own page has the final word.
Getting started
- Use a Linux computer with a kernel-recognized joystick or gamepad
- Install XWindows and Qt 5; libudev is optional
- Obtain the QJoyPad source from its GitHub project
- Build it with CMake and make
- Create or select a controller layout in QJoyPad
Verdict
Choose QJoyPad for free controller remapping on Linux XWindows systems, especially when you need profiles, mouse control, or scripted switching. Its main reason to look elsewhere is platform scope: it does not support Microsoft Windows, consoles, or environments outside XWindows.
Questions
What does QJoyPad cost?
QJoyPad is free, with a listed price of $0. It is open source under GPLv2.
Which systems does QJoyPad support?
It supports Linux and works with XWindows programs. It does not work at the console or on Microsoft Windows.
What can QJoyPad map?
It converts joystick or gamepad input into keystrokes and mouse actions, including mouse movement and clicks.
Can I save controller profiles?
Yes. Multiple layouts can be saved and switched in the interface, from the command line, or through shell scripts.
What are the installation requirements?
Requirements include Linux, XWindows, Qt 5, and joystick support in the Linux kernel. libudev is optional, and the documented build uses CMake and make.
Where can I get support?
The repository directs bug reports and feature requests to GitHub issues. Documentation also provides an email address for layout-file help.
Facts from QJoyPad's own pages
- Button options
- Buttons can be configured for sticky presses and rapid fire, and axes support gradient behavior and throttle controls. · qjoypad.sourceforge.net, 10 Oct 2026
- Controller support
- QJoyPad detects Linux-supported joysticks and gamepads, including devices with more than two axes; the Linux kernel must recognize the device and have its driver loaded. · github.com, 10 Oct 2026
- Gaming use
- It lets users control XWindows games that do not have joystick support with a game controller. · qjoypad.sourceforge.net, 10 Oct 2026
- Installation
- The GitHub fork documents building from source with CMake and make, and provides no stated binary package offer on that page. · github.com, 10 Oct 2026
- Integrations
- The project describes use with XWindows programs and emulation software, and supports layout switching through command-line calls and shell scripts. · github.com, 10 Oct 2026
- Linux and XWindows limit
- QJoyPad is intended for Linux and works only in XWindows; it does not work at the console or on Microsoft Windows. · qjoypad.sourceforge.net, 10 Oct 2026
- Mouse control
- A joystick can move and click the mouse, with configurable axis sensitivity and movement behavior. · github.com, 10 Oct 2026
- Requirements
- The documented requirements include a Linux computer, joystick support in the Linux kernel, XWindows, and Qt 5; libudev is optional. · github.com, 10 Oct 2026
- Saved layouts
- Users can save multiple controller layouts and switch between them from the interface, command line, or a script. · github.com, 10 Oct 2026
- Security and compliance
- The GitHub repository lists a GPL-2.0 license; the opened project pages do not state security certifications or compliance claims. · github.com, 10 Oct 2026
- Support
- The repository directs users to GitHub issues for bug reports and feature requests, and the documentation also gives an email address for layout-file help. · github.com, 10 Oct 2026
- System tray
- QJoyPad can run in the system tray or without a tray icon, and supports a larger floating icon through the --notray option. · github.com, 10 Oct 2026
- What it does
- QJoyPad converts gamepad or joystick input into keystrokes or mouse actions for XWindows programs. · github.com, 10 Oct 2026
Where QJoyPad stands on Freedom251
- Controller Mapping Software#16 of 29