Skip to content

v1.0.0 — First public release

Latest
Latest

Choose a tag to compare

View all tags
@mlstr0m mlstr0m released this 04 Jun 07:52
v1.0.0
2e1cd53
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

First standalone build of Switch2 Bridge — a Bluetooth LE bridge for the Nintendo Switch 2 Pro Controller on macOS that translates inputs into keyboard presses (Ryujinx-compatible by default).

What's in this release

  • 🎮 Full button mapping (A/B/X/Y, L/R, ZL/ZR, +/-, Home, Capture, LS/RS, GL/GR, D-Pad)
  • 🕹️ Both analog sticks (thresholded to 8 directions: WASD / IJKL)
  • 🔧 User-editable mappings at ~/Library/Application Support/Switch2Bridge/mappings.json — supports single-char and <up> / <space> / <cmd> style special keys
  • 🧭 Menubar app (🎮 idle → 🔍 searching → 🟢 connected) with Edit mappings… and Reload mappings items
  • 🩺 Diagnostics logged to ~/Library/Logs/Switch2Bridge/bridge.log
  • ✅ Prompts for Accessibility permission on first run (without it, the BLE side works but keypresses won't reach the emulator)
  • 🎨 App icon

Installation

  1. Download Switch2Bridge-v1.0.0.dmg
  2. Open it, drag Switch2 Bridge into Applications
  3. First launch: right-click → Open (Gatekeeper — see below)
  4. Grant Bluetooth and Accessibility when macOS prompts
  5. Click 🎮 in the menubar → Connect Controller (controller must be on, in pairing mode)

⚠️ Gatekeeper / "unidentified developer"

This build is not code-signed or notarized (no Apple Developer account). On first launch macOS will refuse to open it. Workaround:

  • Right-click the app → Open → confirm in the dialog, or
  • System Settings → Privacy & Security → scroll down → Open Anyway

Known limitations

  • LED control & rumble: not working (output BLE characteristic doesn't respond — likely needs a Joy-Con-style handshake, not yet reverse-engineered)
  • Motion/gyro: not implemented
  • Analog sticks are thresholded to 8 directions, no true analog (would need a virtual HID device via DriverKit)
  • Bundle built against Python 3.14 on macOS 26 / arm64 — should run on Intel and Apple Silicon Macs running macOS Ventura+, but only verified on the build machine

Requirements

  • macOS Ventura (13.0) or later
  • Nintendo Switch 2 Pro Controller (Product ID 0x2069)

🤖 Built with Claude Code — see commit history for the bug-fix and refactor PRs that landed before this release.

Assets 3
Loading