Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

JoyShockMapper

github.com

  • Free plan
  • Open source
  • Windows
  • Linux
  • Self-hosted
7.8 Club score Visit github.com

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.

Free/open-source JoyShockMapper

Free

JoyShockMapper

Free

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.