Skip to content

nodswal/XOutput

 
 

Repository files navigation

Build XOutput Github All Releases Download XOutput Donate Quality Gate Status Discord

XOutput

If you have an older or not supported game controller (gamepad, wheel, joystick, etc.), but XBox 360 controllers are supported you can use this software and enjoy gaming with your controller.

XOutput is a software that can convert DirectInput into XInput. DirectInput data is read and sent to a virtual XInput (Xbox 360 Controller) device. XInput is the new standard game controller input on windows, and DirectInput can no longer be used with Universal Windows Platform software, but with this tool you can use DirectInput devices as well.

General information

If you have any questions or feature requests feel free to create Github Issue.

Any contribution is welcome, open your Pull request.

To join the discussion or just say hi, there is a discord channel.

This version is currently under development. Please use 3.x version for stable features

Version State Support
4.x Under development (no releases yet) Active development with new features
3.x Stable Bugfixes only
2.x Old version (superseeded by 3.x) Expired at Mar 7 2018
1.x Old version (superseeded by 3.x) Expired at Mar 7 2018

How to install

Install emulation software

Install one of the two libraries. ViGEm (preferred) or SCPToolkit (unsupported, legacy)

a) Install VIGEm framework (recommended)

b) Install ScpToolkit and all of its dependencies described here

Install dependencies

Install:

Download XOutput

How to upgrade

Download the application:

  • Download the latest stable release
  • Unzip to the same directory as before
  • If there are errors, remove the existing conf directory

How it works

Component Implementation Description
Device emualation ViGEm External software that emulates XBox and DS4 controllers
Device emualation SCP toolkit Legacy external software that emulates XBox controllers
Backend XOutput.Server Server that collects data from clients and sends to the emulation software
Client XOutput.App Desktop application that collects data from the devices and sends to the backend
Client Web controller Web application that allows to emulate a device
Client Web client Web application that uses the Gamepad API

HidGuardian (exclusive mode)

Affected devices and whitelist can be managed by the application, but it needs administrator priviledges.

  1. Enable HidGuardian initialization in the settings.
  2. Restart the application as administrator.
  3. Add device to affected devices in the input settings.
  4. Reconnect device or reboot PC

Add affected device manually (use this method only, if you want to hide non recognized HID devices):

  1. Run regedit and go to HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\HidGuardian\Parameters
  2. Create multi-string value with the name AffectedDevices
  3. Open Device Manager, find your input device and open properties
  4. Go to details, select Hardware ID and copy string that looks like HID\VID_046D&PID_C219&REV_0200 and HID\VID_046D&PID_C219
  5. Paste the values into HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\HidGuardian\Parameters
  6. Reconnect devices or reboot PC

Manage process whitelist manually (use this method only, if you want to use HidGuardian for other applications):

  1. Start XOutput (or any other application)
  2. Open Task Manager, find your application, then go to details.
  3. Remember the value of the PID column.
  4. Run regedit and go to HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\HidGuardian\Parameters\Whitelist
  5. Create subkey with the PID you found before.

Developer Information

The 4.x version backend is built with .NET 5, you will need to download it.

Action Required dependency
Running the server application ASP.NET Core Runtime
Running the reader application .NET Desktop Runtime
Building the application SDK

However these runtimes and SDKs are cross platform the application is only compatible with Windows.

Server application

The server application is responsible for:

  • collecting input from various sources
  • mapping these sources
  • emulating devices
  • configuring all the above

It is recommended to create a Windows task from the server, so it can start at computer startup (with Administrator priviledges without UAC). Help can be found in the bin directory.

Server application might write the registry, therefore it needs administrator prividledges. Alternatively it can be started without admin access, but then when it tries to write the registry it will prompt UAC.

Webapp

The web application required Node 16 to build it, you can download it. It can be found in the web directory.

Reader application

The reader application is a GUI Windows application which can read input values.

Interface Devices Requirements
Windows API Mouse and keyboard None
Raw input Mouse, keyboard and joysticks USB device with drivers
Direct input Joysticks DirectX compatible devices with drivers
XInput Joysticks XInput compatible devices

Client project

The client project enabled developers to create a new type of input. It can be used to integrate with the server application.

About

DirectInput to XInput wrapper

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C# 79.0%
  • TypeScript 19.1%
  • JavaScript 1.4%
  • SCSS 0.4%
  • PowerShell 0.1%
  • Batchfile 0.0%