JoyShockMapper
github.com
- Free plan
- Open source
- Windows
- Linux
- Self-hosted
What JoyShockMapper is
JoyShockMapper turns supported game-controller input into keyboard, mouse, or virtual-controller events for playing PC games. It supports gyro controls and flick stick for aiming and turning. Buttons can be mapped to keyboard or mouse inputs, with options for tap and hold, chorded press, and simultaneous press. Sticks can control the mouse or trigger key presses, including scroll-wheel and flick-stick modes. The project describes support for DualSense, DualShock 4, JoyCons used in pairs, and Nintendo Switch Pro Controller. Commands can be loaded from text configuration files, and the download includes example gyro configurations. JoyShockMapper is free, with Windows releases and Linux builds. It is primarily developed for Windows, and Linux builds may not always work. Linux requires read and write access to /dev/uinput and the relevant /dev/hidraw device; focused-window detection works only on X11. Virtual Xbox and DS4 output requires separate ViGEm bus software.
Who it suits
It suits PC players who want to remap supported controllers, use gyro or flick-stick controls, or send input to a virtual controller. Linux users should be comfortable with its device permissions and platform limitations.
Good to know, and what to watch
- Free to use.
- Supports gyro controls and flick stick.
- Offers tap-and-hold and chorded button mappings.
- Includes example gyro configuration files.
- Can create virtual Xbox and DS4 controllers.
- Linux builds may not always work.
- Focused-window detection requires X11 on Linux.
- Virtual controller output requires separate ViGEm software.
Plans
Every plan and priceFree/open-source JoyShockMapper
JoyShockMapper
Free plan
The verdict
JoyShockMapper offers detailed controller remapping and gyro options for PC games. Its Linux caveats and additional requirement for virtual controller output are worth considering before setup.
What the maker publishes
- Additional software
- Using virtual controller output requires installing the latest ViGEm bus release linked by the project. source
- Analog triggers
- Analog triggers can have separate soft-pull and full-pull bindings; digital-trigger controllers cannot use this feature. source
- Binding modifiers
- The command system includes tap-and-hold, simultaneous, chorded, diagonal, double-press, and gyro-button bindings. source
- Bluetooth limitation
- The documentation says some Bluetooth adapters introduce lag with JoyCons or Pro Controllers, especially when multiple devices are connected. source
- Button mapping
- Controller buttons can be mapped to keyboard or mouse inputs, with options including tap and hold, chorded press, and simultaneous press. source
- Changelog development
- The changelog lists a 3.6.2 entry covering SDL3 migration, reconnect scripts, adaptive-trigger fixes, Linux FIFO command listening, and diagonal-handling improvements. source
- Configuration
- It can load commands from text configuration files, and its download includes example gyro configuration files. source
- Configuration model
- Users configure the program through text files and console commands, with sample files in the GyroConfigs directory. source
- Controllers
- The project describes support for DualSense, DualShock 4, JoyCons used in pairs, and Nintendo Switch Pro Controller. source
- Developer language and build
- The application is C++ and uses CMake, with platform-specific source directories. source
- Developer reference
- The repository describes older versions as reference implementations for reading controller input with JoyShockLibrary. source
- Digital bindings
- Buttons and stick directions can be mapped to keyboard keys, mouse buttons, scrolling, volume, and media controls. source
- Documentation depth
- The README contains command references, calibration procedures, configuration-file behavior, troubleshooting, and known issues. source
- Flick stick
- The right stick supports a flick-stick mode for rapid horizontal camera turns. source
- Flick-stick origin
- Wikipedia credits Julian Smart with designing flick stick in 2018 and says JoyShockMapper first implemented it publicly in early 2019. source
- Gyro aiming
- Gyroscope movement can control the mouse for precision aiming. source
- Gyro and flick stick
- It supports gyro controls and flick stick for aiming and turning in PC games. source
- Independent directory description
- SaaSHub describes the project as customizable, advanced, actively developed, and compatible with multiple controllers. source
- Independent project listing
- LibHunt lists JoyShockMapper as a C++ project for DualShock 4, JoyCon, and Pro Controller gyro aiming and flick stick. source
- Latest release
- Release v3.6.1 dated February 20 lists fixes for simultaneous-press crashes, command-action crashes, overlapping presses, and scroll-wheel stick mode. source
- License
- The repository includes a license file for the project. source
- License
- The repository is released under the MIT License with an as-is warranty disclaimer. source
- Limit: anti-cheat incompatibility
- A Reddit report says Valorant's anti-cheat blocks JoyShockMapper virtual mouse input, preventing use there. source
- Limit: missing flick-speed option
- Reddit feedback cites the lack of a slower-or-faster rotation control while holding flick stick. source
Checked against the maker's pages on 15 Oct 2026.