USB4VC Configurator

Get USB4VC | Official Discord | Getting Started

You can define your own custom gamepad mappings with USB4VC Configurator. This guide shows you how.

This software is fairly new and experimental right now, so do let me know if you run into any issues!

Prepare USB Flashdrive

USB4VC Configurator will save all the configuration files into a USB flash drive, so you'll need one of those.

Make sure it is formatted in FAT32:

Download and Launch the App

Head here to download the latest release.

Extract the .zip file and launch the app by clicking usb4vc_config.exe:

"Untrusted App" Warnings

When trying to run the app, your system might complain about this software being untrusted. This is because I haven't had the code digitally signed, which costs hundreds of dollars a year.

Feel free to review the code, you can also run usb4vc_config.py directly with Python3.

For Windows 10, click More info and then Run anyway.

Using the App

Select flash drive

Press the Open... button and select the entire flash drive:

Make a profile

You can create multiple profiles for your USB gamepad. Each profile contains a different mapping.

Typically you make one for each game / OS.

Click New to create a new profile, enter a name, and select the desired protocol card and USB gamepad type.

(OPTIONAL) Find out event codes

Skip this step if you're using a supported controller (i.e. XBox and Playstation).

If you're using an UNSUPPORTED gamepad, you might want to find out what each button does first.

Select Show Event Codes on main menu:

Press a button on the controller, it will show:

Device Name
USB Vendor and Product ID
Event code name

Write down the EVENT CODE NAME for each button, you'll need them later.

Hold + button while pushing a gamepad button to exit.

Create a new mapping

Click New in Mappings section to create a new mapping.

Select the desired combination, and press Save this Mapping.

If using unsupported controllers, select the event code name you found out in Map From drop-down.

Currently the following combinations are allowed:

USB gamepad BUTTONS can be mapped to:

Keyboard Keys
Mouse Buttons
15-Pin Gamepad Buttons
15-Pin Gamepad Half Axes

USB gamepad AXES can be mapped to:

Keyboard Keys
Mouse Axes
15-Pin Gamepad Axes
15-Pin Gamepad Half Axes (Xbox analog triggers only)

When mapping USB gamepad axes to keyboard keys, make sure to select TWO keys for both direction.

When mapping analog triggers to keyboard keys, select the same key.

After creating your mappings, press Write Current Mappings to Flash Drive button:

Eject the flash drive, and plug it in the USB4VC.

Load Mappings on USB4VC

Select "Load Custom Config from USB" in the main menu. It will copy over the mappings.

The new profiles should appear in the Gamepad Protocol setting, use enter button to cycle through.

That's pretty much it! Hopefully it works!

Problems?

This software is fairly new and experimental right now, and there is no way for me to test every single combination of custom mappings. But of course, do let me know if you run into any issues!

Questions or Comments?

Feel free to ask in official Discord Chatroom, raise a Github issue, DM on Twitter, or email dekunukem gmail.com!

dekunukem / usb4vc-configurator Goto Github PK