Skip to content

jcpicco/ps4-stratocaster-mapper

Repository files navigation

🎸 PS4 Stratocaster → Xbox 360 Mapper

Tool that converts the HID input from a Fender Stratocaster PS4 guitar into a virtual Xbox 360 controller, allowing you to use it in PC games like Clone Hero, YARG, etc.

Features

  • Mapping of all 5 frets (green, red, yellow, blue, orange)
  • Strum bar (up/down) and D-Pad
  • Whammy bar (analog axis)
  • Menu buttons (Start, Select, Guide)
  • Automatic reconnection when disconnecting/reconnecting the guitar

Mapped Controls

PS4 Guitar Virtual Xbox 360
Green A
Red B
Yellow Y
Blue X
Orange LB (Left Shoulder)
Strum Up D-Pad Up
Strum Down D-Pad Down
Whammy Bar Right Thumb Y Axis
Start Start
Select Back
PS/Home Guide

Prerequisites

  • Windows 10/11
  • ViGEmBus Driver — Virtual controller emulator
  • HIDHide — Hides the guitar from the system to avoid double input

Step 1: Install ViGEmBus

ViGEmBus is the driver that allows creating a virtual Xbox 360 controller on your PC.

Warning

The ViGEmBus project was archived (End-of-Life) in November 2023. Version 1.22.0 still works but will not receive further updates.

  1. Go to the GitHub releases page: 👉 https://github.com/nefarius/ViGEmBus/releases
  2. Download ViGEmBus_1.22.0_x64_x86_arm64.exe
  3. Run the installer as Administrator
  4. Follow the installation wizard steps
  5. Verify the installation:
    • Open Device Manager
    • Expand System devices
    • You should see "Virtual Gamepad Emulation Bus" with no error icons

Important

After installing ViGEmBus, run the Legacinator tool to disable the auto-updater, as the original domain is no longer controlled by the developers.


Step 2: Install HIDHide

HIDHide acts as a "device firewall," hiding the PS4 guitar from games so that only the applications you choose can see it. This prevents double input (the real guitar + the virtual controller).

  1. Go to the GitHub releases page: 👉 https://github.com/nefarius/HidHide/releases
  2. Download HidHide_1.x.x_x64.msi (latest available version)
  3. Run the .msi installer and follow the steps
  4. ⚠️ Reboot your PC — This is mandatory to activate the filter driver

Configure HIDHide

After rebooting:

  1. Open HidHide Configuration Client from the Start menu
  2. "Applications" tab:
    • Click the + button and add this mapper's executable (PS4StratocasterMapper.exe)
    • If you use Clone Hero, YARG or another game, add its .exe as well
  3. "Devices" tab:
    • Find your Fender guitar in the list (VID 0738, PID 8261)
    • Check the box next to it (a red lock icon 🔒 should appear)
    • Enable the "Enable device hiding" checkbox at the bottom
  4. Reconnect the guitar for the changes to take effect

Step 3: Download and Run

  1. Go to the Releases page
  2. Download the latest PS4StratocasterMapper.exe
  3. Connect the PS4 guitar via Bluetooth

Note

The guitar's LED should be blue (not red). A red light means it's not properly paired — re-pair it via Windows Bluetooth settings.

  1. Run PS4StratocasterMapper.exe
  2. On the first run, the program will list all connected HID devices. Select your guitar from the list and the VID/PID will be saved to device.cfg — after selection you should see:
    === FENDER STRAT PS4 → XBOX 360 MAPPER ===
    [+] Guitar detected: ...
    [+] Virtual Xbox 360 controller connected.
    [🎸] Reading guitar input...
    
  3. On subsequent runs, the saved device is loaded automatically. To re-select a different device, run with --select:
    PS4StratocasterMapper.exe --select
    

Troubleshooting

Issue Solution
Guitar LED is red instead of blue The guitar is not paired. Go to Windows Bluetooth settings and re-pair it
[!] Could not open HID stream Close other applications using the guitar. If using HIDHide, make sure you've added the mapper to the whitelist
Guitar not detected Make sure the guitar is paired via Bluetooth. Try re-pairing it
Double input in games Install and configure HIDHide (Step 2)
ViGEmClient throws exception Reinstall ViGEmBus and reboot your PC
Program closes unexpectedly Run from terminal to see error messages

Technical Details

  • Device: Fender Stratocaster PS4 (VID 0x0738 / PID 0x8261)
  • HID Interface: col01 (the only one with MaxInputReportLength > 0)
  • Polling rate: ~250 Hz (4 ms)
  • NuGet Dependencies:

Building from Source

If you want to build the project yourself, you'll need the .NET 8.0 SDK.

git clone https://github.com/your-username/ps4-stratocaster-mapper.git
cd ps4-stratocaster-mapper
dotnet build PS4StratocasterMapper.sln
dotnet run --project PS4StratocasterMapper.csproj

License

MIT

About

Tool that converts the HID input from a Fender Stratocaster PS4 guitar into a virtual Xbox 360 controller, allowing you to use WHAMMY BAR in PC games like Clone Hero, YARG, etc.

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages