Support this project
XJoy is a free product that I work on in my free time, so any contributions are greatly appreciated.
- Install the ViGEm Bus Driver
- Install the Visual C++ Redistributable for Visual Studio 2017
- Download the latest zip from the releases page and extract it somewhere permanent like your Documents folder
- That's it!
- Pair each of your Joy-Cons with Windows (hold down the button on the side to put into pairing mode, then go to add bluetooth device in Windows)
- Ensure that both Joy-Cons show as "Connected" in your bluetooth devices page
- Run XJoy.exe
- Start playing games with your Joy-Cons. A virtual xbox controller should show up as soon as XJoy.exe starts running (you will hear the USB device inserted sound).
- To confirm that it is working, try pressing some buttons on your Joy-Cons. You should see the names of the buttons currently being pressed printed in the terminal.
- To exit, press [ENTER] in the terminal window. You can also simply close the window however this may not disconnect from the Joy-Cons and the virtual controller properly.
When you launch XJoy.exe, you should get output similar to this:
XJoy v0.1.0 initializing emulated Xbox 360 controller... => connected successfully => added target Xbox 360 Controller initializing threads... => created report mutex => left Joy-Con thread started => found left Joy-Con => successfully connected to left Joy-Con => right Joy-Con thread started => found right Joy-Con => successfully connected to right Joy-Con
Right now all buttons are hard-coded to their "default" xbox equivalents. If you wish to
customize these mappings, feel free to modify the
process_button method in XJoy.cpp. I
plan to add support for a configuration file and maybe a GUI in later versions. The default
mappings are shown below:
|Joy-Con Button||Xbox Button|
|Left Trigger||Left Trigger|
|Right Trigger||Right Trigger|
|Left Shoulder||Left Shoulder|
|Right Shoulder||Right Shoulder|
|Left 8-way Analog||Left Analog|
|Right 8-way Analog||Right Analog|
|Left Stick||Left Thumb|
|Right Stick||Right Thumb|
If you wish to build XJoy yourself, simply install the ViGEm Bus Driver as outlined in the installation steps, open the XJoy.sln file in Visual Studio 2017, and build. Everything should work out of the box but if it does not feel free to submit an issue.