empathicqubit/BetterJoy
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Merge branch 'master' of https://github.com/Davidobot/BetterJoyForCemu

Browse source
This commit is contained in:
David Khachaturov 2020-04-18 22:36:54 +01:00
commit 6949bce7f7
1 changed files with 8 additions and 190 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

198
README.md
View file

@ -17,111 +17,10 @@ It's been quite a wild ride, with nearly 110k official download on GitHub and pr
### Screenshot ### Screenshot
![Example](https://user-images.githubusercontent.com/16619943/67919451-bf8e5680-fb76-11e9-995e-7193b87548e1.png) ![Example](https://user-images.githubusercontent.com/16619943/67919451-bf8e5680-fb76-11e9-995e-7193b87548e1.png)
# Changelog
### v6
* Added option from starting the application minimized to tray
* thanks [marco-calautti](https://github.com/marco-calautti)
* Fixed gyro drift on some controllers
* thanks [brakhane](https://github.com/brakhane)
* Added option to config to remove affected devices at application shutdown
* Should prevent any more issues of the controller being unusable after the program (even though this can be fixed if you read the README)
* Added battery level indicator by changing background colour of respective controller icon
* Fixed multi-joycon lag
* thanks [quark-zju](https://github.com/quark-zju)
* Allow for more than one pair of joycons to be joined up
* Fixed stick casting overflow
* thanks [idan-weizman](https://github.com/idan-weizman)
* Separated swap buttons into swapAB and swapXY; hid BetterJoy from Alt+Tab when minimised
* Added way to automatically enumerate options and enable to control them directly from the UI. Any further options can be supported.
* Click the arrow to open config panel.
* thanks [StarryTony](https://github.com/StarryTony)
* Fixed joycon LED bug and minimising behaviour.
* thanks [agustinmorantes](https://github.com/agustinmorantes)
* Added option to calibrate gyroscope for 3rd (and 1st) party controllers.
* Experimental - only supports pro controllers at the moment
* thanks [xqdoo00o](https://github.com/xqdoo00o)
* see _NonOriginalController_ option
* Fixed exception when pressing Add Controllers button
* thanks [spacechase0](https://github.com/spacechase0)
* Added the ability to toggle the HOME button ring LED on and off
* thanks [Houdini111](https://github.com/Houdini111)
* Perform null check on enumerate.serial_number. Caused by Mayflash Dolphinbar and nonOriginal selected
* thanks [Trozmagon](https://github.com/Trozmagon)
* Added a way to use single joycon in vertical mode
* with a single joycon attached, click on the icon to change its orientation
* Added Switch SNES controller support
* thanks [KurtYilmaz](https://github.com/KurtYilmaz)
* Added option to use gyro input as mouse input
* works quite well actually! It's a bit like playing Wii!
* with left-handed mode
* Improved start-up and shut-down time
* improves usability immensely
* Added option to disable motion server
* Fixed USB lag (hopefully)
* Added option to remap special buttons to keybindings
### v5
* Progressive scanning
* You can keep BetterJoy running and just connect controllers to your PC - it will detect them.
* UI rework
* Buttons for locating controllers through vibration
* Click on the joycon controller buttons to **toggle single/joint Joycon mode**.
* Improved rumble
* Added options to turn off HidGuardian and XInput emulation
* Allows BetterJoy to be used exclusively for gyro (for example when using Citra + Steam)
* Improved driver install batch files (thanks BetaLeaf)
* General system stability improvements to enhance the user's experience
### v4
* Implemented a GUI
* Added application icon
* Added HidGuardian support.
* Weird jittering / Windows / steam glitching shouldn't happen anymore
* Streamlined driver install process
* Installs HidGuardian as a Windows process - don't move the BetterJoy folder after installation without uninstalling first.
### v3
* Added XInput Support using ViGEm.
* No longer need to use "Also use for axes/buttons"
* System-wide compatibility (use your Joycons with Steam, or something)
* Requires ViGEm driver (provided in release)
* Rumble support
* Ability to rebind keys
* __v3a__
* Added more app settings
* Ability to disable rumble
* Option to swap A-B and X-Y (on request of Paul)
* CemuHook gets fed correct data about the kind of connection the controller is on
* __v3b__
* Fixed button swapping not working on Joycons
### v2
* Added Joycon support
* Exposes two CemuHook controllers - both have all the buttons, selecting one or the other will just pick whether to use the right or left Joycon for the motion controls
* Make sure both controllers are connected beforehand
* Further gyro fixes
* Code cleanup
### v1.51
* Added USB support
* Eliminated gyro shaking
* Improved bluetooth support
* It's no longer necessary to completely remove and then reconnect the pro controller from your bluetooth devices when you turn it off
* Pro controller reconnects to computer normally now
* Added 32-bit release (untested)
* Cleaned up code
* __v1.51__
* More gyro fixes (runs at max UDP now - as precise as one can get)
* Especially noticeable in USB mode
### v1
* Initial release
# How to use # How to use
1. Install drivers 1. Install drivers
1. Run *! Driver Install (Run as Admin).bat* 1. Run *! Driver Install (Run as Admin).bat*
2. Run BetterJoyForCemu.exe 2. Run BetterJoyForCemu.exe
1. If running for the first time, things might glitch out - just close BetterJoy normally and restart your computer for the drivers to take effect.
2. If not, see the __Problems__ section.
3. Connect your controllers. 3. Connect your controllers.
4. Start Cemu and ensure CemuHook has the controller selected. 4. Start Cemu and ensure CemuHook has the controller selected.
1. If using Joycons, CemuHook will detect two controllers - each will give all buttons, but choosing one over the other just chooses preference for which hand to use for gyro controls. 1. If using Joycons, CemuHook will detect two controllers - each will give all buttons, but choosing one over the other just chooses preference for which hand to use for gyro controls.
@ -131,100 +30,19 @@ It's been quite a wild ride, with nearly 110k official download on GitHub and pr
* As of version 3, you can use the pro controller and Joycons as normal xbox controllers on your PC - try it with Steam! * As of version 3, you can use the pro controller and Joycons as normal xbox controllers on your PC - try it with Steam!
# App Settings # More Info
Feel free to edit *BetterJoyForCemu.exe.config* before running the program to configure it to your liking. Check out the [wiki](https://github.com/Davidobot/BetterJoy/wiki)! There, you'll find all sorts of goodness such as the changelog, description of app settings, the FAQ and Problems page, and info on how to make BetterJoy work with Steam *better*.
For example, for use with [Citra and Steam simultaneously](https://community.citra-emu.org/t/improvements-to-motion-control/42125), you may consider turning off *UseHIDG* and *ShowAsXInput*.
Current settings are:
* IP address of CemuHook motion server *(default: 127.0.0.1)*
* Port number of CemuHook motion server *(default: 26760)*
* Use CemuHook motion server? *(default: true)*
* Rumble Period of motor in ms *(default: 300)*
* Frequency of low rumble in Hz *(default: 20)*
* Frequency of high rumble in Hz *(default: 400)*
* Rumble - en/disables rumble *(default: true)*
* Swap A-B *(default: false)*
* Swaps the A-B buttons to mimick the Xbox layout by button name, rather than physical layout
* Swap X-Y *(default: false)*
* Swaps the X-Y buttons to mimick the Xbox layout by button name, rather than physical layout
* PurgeWhitelist *(default: true)*
* Determines whether or not HidGuardian's process whitelist is purged on start-up
* UseHIDG *(default: true)*
* Determines whether or not to use HidGuardian (improves compatibility with other programs, like Steam, when set to "false")
* ShowAsXInput *(default: true)*
* Determines whether or not the program will expose detected controllers as Xbox 360 controllers
* PurgeAffectedDevices *(default: true)*
* Determines whether or not the program should purge the affected devices list upon exit
* Should prevent any more issues of the controller being unusable after the program
* NonOriginalController *(default: false)*
* When "true", click the "Calibrate" button once to calibrate the gyroscope on your connect pro controller
* GyroToJoyOrMouse *(default: none)*
* "mouse" allows you to use gyro input as mouse input. Press stick buttons to reset
* GyroMouseSensitivity *(default: 50)*
* GyroMouseLeftHanded *(default: false)*
* DragToggle *(default: false)*
# Problems
__Make sure you installed the drivers!!__
__Controller is not recognised after using the program__
Before uninstalling the drivers, navigate to http://localhost:26762/ and remove all the devices from the "Currently affected devices" list and then restart your computer.
__Make pro controller or Joycons visible to other programs again without uninstalled HidGuardian__
BetterJoy automatically adds Joycons and Pro Controllers to HidGuardian's blacklist upon start-up.
However, to manually remove the devices from the blacklist, one can navigate to this page: http://localhost:26762/
__Calibration Issues (ex: sticks don't have full range)__
Switch off "also use for axes/buttons" under motion settings and set the input deadzones to 0.
__Motion controls don't work/work badly__
While the program is running, turn off your controller (if USB - unplug, if BT - press the sync button) and then turn it back on (press any button).
__No Joycons detected__
If using Bluetooth - see the "How to properly disconnect the controller" section and follow the steps listed there. Then, reconnect the controller.
If using USB - try unplugging the controller and then plugging it back in, making sure to let Windows set it up before launching the program.
__Getting stuck at "Using USB" or "Using factory.."__
Close the program and then start it again. If it doesn't work, see the "No joycons detected" section and try that.
__CemuHook not recognising the controller__
Make sure that CemuHook settings are at their default state, which are -
```
serverIP = 127.0.0.1
serverPort = 26760
```
__Plugging controller into USB port does nothing__
Solution found courtresy of reddit user BFCE - go into Device Manager, go to the Universal Serial Bus Controllers, select the properties of the eXtreme (or other USB) controllers, and toggle the setting that allows you to disable the USB ports to save power when not in use. Even some desktops have this on by default.
___Note that for Joycons to work properly, you need a decent Bluetooth adapter that is comfortable with handling 3/4 connections at a time.___
Feel free to open a new issue if you have any comments or questions.
# Connecting and Disconnecting the Controller # Connecting and Disconnecting the Controller
## Bluetooth Mode ## Bluetooth Mode
Hold down the small button on the top of the controller for 5 seconds - this puts the controller into broadcasting mode. * Hold down the small button (sync) on the top of the controller for 5 seconds - this puts the controller into broadcasting mode.
* Search for it in your bluetooth settings and pair normally.
Search for it in your bluetooth settings and pair normally. * To disconnect the controller - press the sync button once. To reconnect - press any button on your controller.
To disconnect the controller - press down the button once. To reconnect - press any button on your controller.
## USB Mode ## USB Mode
Plug the controller into your computer. * Plug the controller into your computer.
## How to properly disconnect the controller ## Disconnecting \[Windows 10]
### Windows 10
1. Go into "Bluetooth and other devices settings" 1. Go into "Bluetooth and other devices settings"
1. Under the first category "Mouse, keyboard, & pen", there should be the pro controller. 1. Under the first category "Mouse, keyboard, & pen", there should be the pro controller.
1. Click on it and a "Remove" button will be revealed. 1. Click on it and a "Remove" button will be revealed.