JoyShockMapper
JoyShockMapper converts supported game controller input into keyboard, mouse, or virtual controller events for PC games.
What JoyShockMapper is
JoyShockMapper converts supported game controller input into keyboard, mouse, or virtual controller events for PC games. It supports gyro aiming and flick stick, along with button mappings such as tap and hold, chorded press, and simultaneous press. Sticks can control the mouse or trigger key inputs, including scroll wheel and flick stick modes. The project lists support for DualSense, DualShock 4, paired JoyCons, and Nintendo Switch Pro Controller. JoyShockMapper is free for Windows and Linux, but development primarily targets Windows, and Linux builds may not always work. Linux users need read and write access to /dev/uinput and the relevant /dev/hidraw device; focused-window detection is available only on X11. Virtual Xbox or DS4 controller output requires separate ViGEm bus software. Commands can be loaded from text configuration files, and the download includes example gyro configurations. The releases page lists version 3.6.1 as the latest release.
Good
- Supports gyro controls and flick stick.
- Offers flexible button mapping options.
- Supports several named controller types.
- Loads commands from text configuration files.
Watch out
- Primarily developed for Windows.
- Linux builds may not always work.
- Linux focused-window detection works only on X11.
- Virtual controller output needs separate ViGEm software.
Who it suits
JoyShockMapper suits PC players who want to map supported controllers to keyboard, mouse, or virtual controller inputs. It may interest players who want gyro controls or flick stick aiming.
Verdict
JoyShockMapper provides controller remapping with gyro and flick stick options for PC games. Linux users should note the stated device access requirements and platform limitations.
Plans and prices
From JoyShockMapper's own pricing page, checked 15 Oct 2026.
| Plan | Price | What it gives you |
|---|---|---|
| Free/open-source JoyShockMapper | Free | downloadable executable · source available · Windows and Linux builds |
| JoyShockMapper | Free | Free download; Windows release; Linux can be built from source |
The facts
Each one read from JoyShockMapper's own pages, with the date it was checked.
What it does
- Additional software
- Using virtual controller output requires installing the latest ViGEm bus release linked by the project.checked 30 Sep 2026
- Analog triggers
- Analog triggers can have separate soft-pull and full-pull bindings; digital-trigger controllers cannot use this feature.checked 15 Oct 2026
- Binding modifiers
- The command system includes tap-and-hold, simultaneous, chorded, diagonal, double-press, and gyro-button bindings.checked 15 Oct 2026
- Bluetooth limitation
- The documentation says some Bluetooth adapters introduce lag with JoyCons or Pro Controllers, especially when multiple devices are connected.checked 15 Oct 2026
- 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.checked 15 Oct 2026
- Configuration
- It can load commands from text configuration files, and its download includes example gyro configuration files.checked 30 Sep 2026
- Configuration model
- Users configure the program through text files and console commands, with sample files in the GyroConfigs directory.checked 15 Oct 2026
- Controllers
- The project describes support for DualSense, DualShock 4, JoyCons used in pairs, and Nintendo Switch Pro Controller.checked 30 Sep 2026
- Developer language and build
- The application is C++ and uses CMake, with platform-specific source directories.checked 15 Oct 2026
- Developer reference
- The repository describes older versions as reference implementations for reading controller input with JoyShockLibrary.checked 15 Oct 2026
- Digital bindings
- Buttons and stick directions can be mapped to keyboard keys, mouse buttons, scrolling, volume, and media controls.checked 15 Oct 2026
- Documentation depth
- The README contains command references, calibration procedures, configuration-file behavior, troubleshooting, and known issues.checked 15 Oct 2026
- Flick stick
- The right stick supports a flick-stick mode for rapid horizontal camera turns.checked 15 Oct 2026
- Flick-stick origin
- Wikipedia credits Julian Smart with designing flick stick in 2018 and says JoyShockMapper first implemented it publicly in early 2019.checked 15 Oct 2026
- Gyro aiming
- Gyroscope movement can control the mouse for precision aiming.checked 15 Oct 2026
- Gyro and flick stick
- It supports gyro controls and flick stick for aiming and turning in PC games.checked 30 Sep 2026
- Independent directory description
- SaaSHub describes the project as customizable, advanced, actively developed, and compatible with multiple controllers.checked 15 Oct 2026
- Independent project listing
- LibHunt lists JoyShockMapper as a C++ project for DualShock 4, JoyCon, and Pro Controller gyro aiming and flick stick.checked 15 Oct 2026
- 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.checked 15 Oct 2026
- License
- The repository is released under the MIT License with an as-is warranty disclaimer.checked 15 Oct 2026
- Limit: anti-cheat incompatibility
- A Reddit report says Valorant's anti-cheat blocks JoyShockMapper virtual mouse input, preventing use there.checked 15 Oct 2026
- Limit: missing flick-speed option
- Reddit feedback cites the lack of a slower-or-faster rotation control while holding flick stick.checked 15 Oct 2026
- Limit: no graphical interface
- Reddit users repeatedly identify the lack of a GUI as a usability drawback because configurations are written in text files.checked 15 Oct 2026
Where it runs
- Button mapping
- Controller buttons can be mapped to keyboard or mouse inputs, with options including tap and hold, chorded press, and simultaneous press.checked 30 Sep 2026
The full review of JoyShockMapper
Overview
JoyShockMapper turns compatible game-controller inputs into keyboard, mouse, or virtual-controller events for PC games. It is best suited to players who want gyro or flick-stick aiming and detailed button mappings without paying for the software. Its breadth of mapping options is a strong fit for custom control setups, though Linux users face practical setup and reliability caveats.
Key features
Gyro controls and flick stick give players alternatives to conventional stick aiming, particularly for games where they want to aim or turn using controller motion or a quick stick movement. Supported controllers include DualSense, DualShock 4, JoyCons used in pairs, and Nintendo Switch Pro Controller.
Buttons can send keyboard or mouse inputs, with tap-and-hold, chorded, and simultaneous press options. Sticks can control the mouse or trigger key presses, including flick-stick and scroll-wheel modes. Per-app profiles, profile switching, and macro support add flexibility for users who want mappings tailored to different games.
For a setup that needs controller output rather than keyboard and mouse events, JoyShockMapper can connect to ViGEm bus software to create virtual Xbox or DS4 controllers. That output requires installing the latest ViGEm bus release. Commands can be loaded from text configuration files, and the download includes example gyro configurations; this gives users a route to customize their setup, but it favors those willing to work with configuration files.
Pricing
JoyShockMapper — free: The free download includes the Windows release, and Linux users can build it from source. There is no paid tier or free-trial period to weigh against the free plan. For a no-cost mapping tool with gyro and flick-stick support, it offers a substantial feature set; Linux users should factor in the extra build and device-access requirements.
Platforms
JoyShockMapper supports Windows and Linux, but Windows is its primary development platform. Linux builds may not always work because development moves quickly and there are few Linux maintainers. Linux users also need read and write access to /dev/uinput and the relevant /dev/hidraw device. Focused-window detection works only on X11, a constraint for users relying on other display systems.
Who it's for
Choose JoyShockMapper if you use one of its supported controllers and want gyro or flick-stick aiming, intricate button mappings, or virtual-controller output without a software fee. It is less suitable if you need dependable Linux support without device configuration, use a controller outside its stated supported set, or want to avoid text-based configuration for a customized setup.
Pros and cons
- Pro: Gyro and flick-stick controls offer distinct aiming and turning options for PC games.
- Pro: Tap-and-hold, chorded, and simultaneous button mappings support more involved control schemes.
- Pro: Free access includes per-app profiles, profile switching, macros, and virtual-controller output.
- Con: Linux is a secondary platform, with possible build failures and required access to input devices.
- Con: Focused-window detection is limited to X11, and virtual-controller output depends on separate ViGEm bus software.
Alternatives
AntiMicroX is another free option for Linux and Windows if you want a GPL v3 desktop application. Steam Input is worth considering if its Linux, macOS, Windows, and API platform coverage better fits your setup.
DS4Windows is a free Windows-only alternative for users who can meet its Windows 10-or-newer, .NET 8.0 Desktop Runtime, Visual C++ Redistributable, and ViGEmBus requirements. OmniControl has a free plan for controller reading, mapping, and tuning, with no time limit or account requirement; consider it if that scope fits your needs.
PadLink is an alternative to consider for its Android, iOS, macOS, and Windows platform support. ControllerBuddy is another free, open-source option for Linux and Windows. Joystick Gremlin is a free Windows alternative, while InputConfig is a free option for macOS.
Browse more options in Controller Mapping Software or Game Controller Mapper Software.
Verdict
JoyShockMapper is a strong choice for players who want free controller remapping with gyro, flick stick, and flexible button behavior. Its main trade-off is platform friction: Windows is the focus, while Linux requires device permissions and comes with less dependable build support. Choose it for its control options; look elsewhere if smooth Linux setup or broader platform coverage matters more.
Alternatives to JoyShockMapper
- 1
Avidemux
Free planOpen sourceWebLinuxmacOSWindows7.3Free plan - 2
OmniControl
Free planWindows7.3From $59.99 a year - 3
ControllerBuddy
Free planOpen sourceLinuxmacOSWindows7.2Free plan - 4
PadLink
Free planAndroidiOSmacOSWindows7.2$2.99 one-time - 5
reWASD
AndroidiOSWindows7.1$14.99 one-time - 6
Keysticks
Free planOpen sourceWindows7.0Free plan