jc2mouse v0.3.0-beta1 — Joy-Con 2 + Switch 2 Pro Bluetooth support, cleaner CLI, improved docs

jc2mouse v0.3.0-beta1

First public beta for the expanded Nintendo Switch 2 controller bring-up work.

This release takes jc2mouse beyond its original single Joy-Con 2 mouse concept and turns it into a more complete Linux-side controller tool for Nintendo Switch 2 hardware. In addition to the original Joy-Con 2 workflows, this build adds Nintendo Switch 2 Pro Controller support, improves combined Joy-Con handling, and cleans up the CLI and project structure for real-world use.

Highlights

• Added Nintendo Switch 2 Pro Controller support

  • Auto-detection through the main CLI
  • Standalone ns2pro driver module included
  • Full virtual gamepad mapping via uinput

• Improved Joy-Con 2 single-controller mode

  • Better cleanup and structure in driver.py
  • Side-aware tips and mode toggle guidance
  • Cleaner disconnect behavior on exit paths

• Improved combined Joy-Con mode

  • Left + Right can act as one full controller
  • Right-side mouse overlay still supported
  • Better retry flow and messaging during combined connection

• Refined CLI behavior and UX

  • Better auto-detection messaging
  • Controller-type aware output (jc2 vs ns2pro)
  • More consistent stop / disconnect guidance
  • Clearer handling of optional session mode

• Updated README and setup guidance

  • README now reflects the current workflow more accurately
  • Patched BlueZ session mode is documented as an optional fallback path rather than the default requirement
  • Setup instructions clarified for current Linux behavior

Notes

Current testing suggests that on newer Linux / BlueZ setups, stock Bluetooth behavior may already be good enough for many Nintendo Switch 2 controller use cases. Because of that, the patched BlueZ workflow is still included, but is now treated as an advanced fallback option rather than something every user must enable first.

That makes this release a good checkpoint before future work on:

• GUI frontend
• Easier launch / workflow simplification
• Better status / recovery prompts when optical bring-up fails
• Possible Windows equivalent implementation

Known rough edges

• Combined mode may still occasionally require a retry if pairing timing is off
• Optical bring-up retry output can still be noisy in some failure cases
• Session-mode fallback remains available but still needs additional validation on some systems

Pre-release

This build is already highly functional, but because it introduces a new device class (Switch 2 Pro Controller), revised session-mode assumptions, and broader detection behavior, it fits best as a pre-release before declaring a fully stable milestone.