Awesome Gamepad Awesome

⚠️ After cloning, run:

git submodule update --init --recursive

Features

  • DS4Windows: DS4Windows is a gamepad input mapper and virtual XInput emulator designed to connect, use and customize your PS4/PS5 Controller on Windows 10/11 PC.
  • DualShock Tools: Debug, Calibrate & Test DualShock/DualSense gamepads.
  • Gamepad Tester: Simple HTML gamepad input tester.
  • Gamepad Viewer: Displays real-time gamepad inputs. (doubles as an input tester and debugger). [OBS Browser Overlay Compatible]
  • hidusbf: Driver/Program to overclock USB mice and HID devices.
  • XInput-test: Displays analytics for recorded XInput samples.

Prerequisites (optional)

Note

For dualshock-tools, gamepad-tester, gamepad-viewer ONLY

Instructions

Node:

  1. Run the command node app.js in the directory
  2. Visit http://127.0.0.1:8080 in your browser

Adding the gamepad-viewer Overlay to OBS Studio

Important

For the gamepad-viewer to work in the background while OBS is not in focus, you must launch OBS with this CLI argument!
CLI Argument: --disable-features=EnableWindowsGamingInputDataFetcher

  1. Ensure your controller is plugged in and visible

  2. Navigate to the directory using cd gamepad-viewer

  3. Start the app with either:

    • Node: node app.js (preferred)
    • Python: python -m http.server --bind 0.0.0.0 8080
  4. Go to http://127.0.0.1:8080 in your browser, focus the window & press a button on your controller

  5. Customize your controller scheme and copy the finalized URL

  6. Create a new browser source in OBS Studio and paste the link you just copied (i.e. http://127.0.0.1:8080/?color=white&triggers=meter&type=dualsense)

  7. Ensure these settings:

    • Shutdown source when not visible
    • Refresh browser when scene becomes available

    Page permissions: Full access to OBS (Start/Stop streaming without warning, etc.)

  8. Add the source, keep OBS Studio focused and press a button on your controller

  9. You're gamepad with the template should appear and display in real time

Tip

You can also add the local IPv4 address of the machine running the app to another OBS Studio browser source somewhere else on the network!
Example: http://192.168.0.141:8080/?color=white&triggers=meter&type=dualsense

Showcase

DS4Windows:

Click to expand


DualShock Tools:

Click to expand


Gamepad Tester:

Click to expand


Gamepad Viewer:

Click to expand


hidusbf:

Click to expand


XInput Tester:

Click to expand

Description
A collection of useful tools for monitoring and debugging Playstation & Native XInput controllers. Includes DS4Windows, DualShock/Sense Debugger, Polling Rate Optimizer, XInput Sampler, Self-Hosted Overlay for OBS Studio, and more!
Readme 16 MiB
Languages
JavaScript 99.9%