DSRemapper is an open source application to remap PC controllers with written scripts and with plugins support to extend its functionalities.
DSRemapper Wiki - Application progress and download links
| Table of content |
|---|
| 1. Inspiration |
| 2. What is DSRemapper? |
| 3. Program Versions Description |
| 4. How to Install it |
| 5. Documentation |
| 6. Thanks |
Aided with Google Translate (my native language is Spanish, I'm from Argentina)
I love playing games, especially simulators. Driven by this, I found InputMapper, an application that allowed me to get input from a PS4 controller (DualShock4 - DS4) and remap it into an Xbox360 controller. One feature that this application has is to read the DualShock4's accelerometer and gyroscope, and remap it as a joystick input. This was amazing, literally by tilting the controller, and with great reading accuracy, it was able to emulate a steering wheel, which I used in games like ETS2 (Euro Truck Simulator 2).
Unfortunately, the latest versions of InputMapper didn't work as I liked and basically it wasn't very easy to achieve the behavior I was looking for.
As a result, I started creating DSRemapper, an alternative/continuation, but with more freedom, at the cost that DSRemapper may not be for everyone.
If you want a simply application you may consider using InputMapper or DS4Windows
DSRemapper is an open source application to remap PC controllers with written scripts.
These scripts can be written in lua, which is the way I designed the program, or any other language or utility supported by a plugin. I focused on making the syntax easy for everyone. Although I understand that programming is not for everyone, but it shouldn't be difficult to modify or write a basic script to achieve what you want without too much trouble.
However, I plan to design an interface system that makes this procedure simpler for everyone, by generating a lua script. This would allow DSRemapper to reach more people and still give complete freedom to everyone who wants it.
Yes, DSRemapper is based on plugins, so if you want DSRemapper to do something new, and you have the ability to do it, this repository provides a sdk package to create:
- New Remapper Plugins, which are for read a file with the instructions of how to remap the physical device to a virtual one
- New Input Plugins, which recognize physical devices and translate it's input for remap it.
- New Output Plugins, which create virtual devices or emulate physical devices to give a certain behavior to the physical devices
(optional) if you want add a tag or append something as a reference to the plugin name so users can find them on github or other platforms.
It may be very obvious how the different versions work, but I wanted to give more details about what can happen in each version.
The program can suffer major changes from one version to another and be unstable. Some changes can be:
- The lua remapper syntax for controller remap can change
- Interface can be reworked (Again, there are three going)
- Renaming of classes, structs, enums, etc. of the Core Assembly for plugins
Still unstable, but there will be no more changes that modify the behavior of the program. Could happen that the lua remapper syntax changes slightly.
Stable but still not finished.
Full released app.
-
To run DSRemapper you need to install .NET 7.0 Desktop Runtime
-
After that, you have to download the lasted Release of the program, unzip and run.
-
If you want to use specific output plugins, you need to download the drivers to use it, if they are required.
Emulates Xbox 360 and DualShock 4 Controllers.
Official Website
Download Page
GitHub
Emulates standard DirectInput controllers. If you have enough knowledge you can make it do almost anything.
Although the application is supported on windows, and several of its plugins, the application is like a container for DSRemapper. The program's main assemblies should run without problems on other operating systems that support .NET 7.0 or higher (Linux, OSX or android and ios inclusive). However I have no plans to create interfaces for other operating systems, although this is entirely possible and is left to the future community of the program, if it exists.
Is in progress, when I have something to reference in here, I will put it.