QJoyControl
Use Nintendo Switch JoyCons to control your Mac
Install / Use
/learn @erikmwerner/QJoyControlREADME
QJoyControl <img src="https://github.com/erikmwerner/QJoyControl/blob/master/img/Logo.png" align="left" width="64" height="64" title="">
QJoyControl lets you use Nintendo Switch JoyCons as input devices on your computer. It was originally made to use a JoyCon as a PowerPoint remote, but it accumulated a few extra features along the way. Currently, QJoyControl supports:
- JoyCons and Pro Controller
- Mouse control with analog sticks and gyroscope
- Adjustable mouse sensitivity
- Configurable button-to-key mapping
- Image capture with the IR Camera
- Rumble and player LED commands
It also works pretty well as a PowerPoint remote.
Setup
- Pair the JoyCon with your computer and connect to it with bluetooth
- To pair, press the pairing button on the JoyCon and go to Bluetooth Preferences on your Mac
- Open QJoyControl and select the JoyCon from the device list
- If nothing shows up, make sure the JoyCon is paired and connected and click Refresh to check again
- Click Connect to begin streaming input data
If MacOS does not ask to give QJoyControl permission to control your computer, you may need to go into System Preferences and do it manually before keyboard and mouse inputs will register with MacOS. To do this, go to System Preferences, Security & Privacy > Privacy > Accessibility. From there, click the lock icon in the bottom-left corner, enter you password to unlock, click the plus button, and select QJoyControl to add QJoyControl to the list of approved applications.
Compatibility
QJoyControl should work on MacOS 10.7 and later, although it has only been tested on MacOS 10.13 and 10.14. QJoyControl was written with Qt and hidapi for cross-platform support. It should eventually work on MacOS, Windows, and Linux, but at the moment only MacOS support is implemented.
Thanks
- All of the HID communication came from the hard work at JoyCon Reverse Engineering
- The IR camera features came from the excellent Joy-Con Toolkit
Disclaimer
This project is not endorsed by, affiliated with, maintained, authorized, or sponsored by Nintendo. All product and company names are the registered trademarks of their original owners. The use of any trade name or trademark is for identification and reference purposes only and does not imply any association with the trademark holder of their product brand.
Related Skills
node-connect
335.8kDiagnose OpenClaw node connection and pairing failures for Android, iOS, and macOS companion apps
frontend-design
82.7kCreate distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.
openai-whisper-api
335.8kTranscribe audio via OpenAI Audio Transcriptions API (Whisper).
commit-push-pr
82.7kCommit, push, and open a PR
