Releases: nixihz/JoyHarness
Release list
Joy Harness v0.5.1
Joy Harness v0.5.1 for Apple Silicon Macs running macOS 13.0 or later.
What's New
- Automatically recovers controller pointer movement when the display-synchronized clock stalls or the display configuration changes.
- Makes controller pointer movement more responsive and coalesces redundant Joy-Con input refreshes to reduce paired-controller latency.
- Fixes first launch when the local runtime directory does not exist yet.
Install
- Download Joy-Harness-v0.5.1-macOS-arm64.dmg and its .sha256 file.
- Open the DMG and drag Joy Harness.app to Applications.
- Use the checksum file to verify the download when needed.
This build is signed with Developer ID Application and notarized by Apple.
The DMG contains the desktop app. Install from source with task install when Codex hooks, login startup, notify bridge, and the local CLI are also required.
Joy Harness v0.5.0
Joy Harness v0.5.0 for Apple Silicon Macs running macOS 13.0 or later.
What's New
- Made controller pointer motion display-synchronized and resilient to main-thread stalls, display changes, and short scheduling delays.
- Hardened local I/O, Codex process recovery, lifecycle cleanup, status freshness, controller mapping migrations, and RP2040 transport buffering.
- Fixed shortcut modifier keys remaining active after key release and affecting later controller-generated clicks.
- Added shared CI and release validation, protocol documentation, and substantially broader regression coverage.
See docs/CHANGELOG.md for full historical release notes.
Install
- Download Joy-Harness-v0.5.0-macOS-arm64.dmg and its .sha256 file.
- Open the DMG and drag Joy Harness.app to Applications.
- Use the checksum file to verify the download when needed.
This build is signed with Developer ID Application and notarized by Apple.
The DMG contains the desktop app. Install from source with task install when Codex hooks, login startup, notify bridge, and the local CLI are also required.
Joy Harness v0.4.0
Joy Harness v0.4.0 for Apple Silicon Macs running macOS 13.0 or later.
What's New
- Added full support for first-generation Nintendo Switch Joy-Con controllers, including single Joy-Con (L/R) in horizontal or vertical grip, combined Joy-Con pairs, Nintendo physical labels, and IOHID shoulder button disambiguation.
- Added Native Gamepad Mode (passthrough) with automatic switching for foreground game apps (such as JoyDSH) and PS / Home manual toggle.
- Added independent Normal, Fast, and Slow pointer sensitivity adjustments in Settings.
- Added multi-controller concurrent haptics and real-time controller button press feedback on the dashboard.
Install
- Download Joy-Harness-v0.4.0-macOS-arm64.dmg and its .sha256 file.
- Open the DMG and drag Joy Harness.app to Applications.
- Use the checksum file to verify the download when needed.
This build is signed with Developer ID Application and notarized by Apple.
The DMG contains the desktop app. Install from source with task install when Codex hooks, login startup, notify bridge, and the local CLI are also required.
Joy Harness v0.3.0
Joy Harness v0.3.0 for Apple Silicon Macs running macOS 13.0 or later.
What's New
- Added recordable keyboard shortcuts, including modifier combinations and optional mapping notes.
- Added native double-click and triple-click behavior for controller mouse buttons.
- Changed the DualSense / DualShock touchpad button default to left click while keeping push-to-talk available as a custom mapping.
Install
- Download Joy-Harness-v0.3.0-macOS-arm64.dmg and its .sha256 file.
- Open the DMG and drag Joy Harness.app to Applications.
- Use the checksum file to verify the download when needed.
This build is signed with Developer ID Application and notarized by Apple.
The DMG contains the desktop app. Install from source with task install when Codex hooks, login startup, notify bridge, and the local CLI are also required.
Joy Harness v0.2.5
Joy Harness v0.2.5 for Apple Silicon Macs running macOS 13.0 or later.
What's New
- Fixed controller pointer movement drifting past screen edges, which made the cursor take a long time to come back.
Install
- Download Joy-Harness-v0.2.5-macOS-arm64.dmg and its .sha256 file.
- Open the DMG and drag Joy Harness.app to Applications.
- Use the checksum file to verify the download when needed.
This build is signed with Developer ID Application and notarized by Apple.
The DMG contains the desktop app. Install from source with task install when Codex hooks, login startup, notify bridge, and the local CLI are also required.
Joy Harness v0.2.4
Joy Harness v0.2.4 for Apple Silicon Macs running macOS 13.0 or later.
What's New
- Added an
L3pointer speed boost and DualSense / DualShock touchpad precision pointer control. - Simplified the app lifecycle by removing the obsolete LaunchAgent; launch at login is managed from Settings.
- Refined the dashboard and Settings windows with compact native macOS title bars and cleaner selection states.
- Added Developer ID signing and Apple notarization to the GitHub Release workflow.
Install
- Download
Joy-Harness-v0.2.4-macOS-arm64.dmgand its.sha256file. - Verify the checksum when needed.
- Open the DMG and drag
Joy Harness.appto Applications.
This build is signed with Developer ID Application and notarized by Apple.
The DMG contains the desktop app. Install from source with task install when the local CLI or RP2040 firmware build and flashing tools are also required.
Joy Harness v0.2.3
Joy Harness v0.2.3 for Apple Silicon Macs running macOS 13.0 or later.
What's New
- Made
LT / L2 +right stick directions customizable; left/right default to browser back/forward (Command-[/Command-]). - Added an Open Application mapping action with a per-input app picker.
- Added Natural vs Traditional scroll direction for
LT / L2 +left stick scrolling in Settings. - Hold
L3temporarily boosts pointer speed to1.8x. - DualSense / DualShock touchpad sliding moves the pointer slowly for fine aiming without holding a modifier.
Install
- Download Joy-Harness-v0.2.3-macOS-arm64.dmg and its .sha256 file.
- Open the DMG and drag Joy Harness.app to Applications.
- Use the checksum file to verify the download when needed.
This build is not notarized. macOS may require approval in System Settings > Privacy & Security before first launch.
The DMG contains the desktop app. Install from source with task install when Codex hooks, login startup, notify bridge, and the local CLI are also required.
Joy Harness v0.2.2
Joy Harness v0.2.2 for Apple Silicon Macs running macOS 13.0 or later.
What's New
- Added clearer Settings entry points and a General pane with launch-at-login.
Install
- Download Joy-Harness-v0.2.2-macOS-arm64.dmg and its .sha256 file.
- Open the DMG and drag Joy Harness.app to Applications.
- Use the checksum file to verify the download when needed.
This build is not notarized. macOS may require approval in System Settings > Privacy & Security before first launch.
The DMG contains the desktop app. Install from source with task install when Codex hooks, login startup, notify bridge, and the local CLI are also required.
Joy Harness v0.2.1
Joy Harness v0.2.1 for Apple Silicon Macs running macOS 13.0 or later.
What's New
- Fixed a launch crash in downloaded Release builds caused by eagerly loading the SwiftPM resource bundle after the version had already been found in the app bundle.
Install
- Download the DMG and its
.sha256file. - Verify the checksum with
shasum -a 256 -c Joy-Harness-v0.2.1-macOS-arm64.dmg.sha256. - Open the DMG and drag
Joy Harness.appto Applications.
This build is ad-hoc signed and not notarized by Apple. macOS may require approval in System Settings > Privacy & Security before first launch.
Joy Harness v0.2.0
Joy Harness v0.2.0 for Apple Silicon Macs running macOS 13.0 or later.
What's New
- Added
LT + RTfor Enter,LT + L3/R3for copy/paste, and an Options/View shortcut for Lark screenshots. - Redesigned the dashboard into a compact three-column layout with consistent app version and connection health indicators.
- Centralized version metadata in the
VERSIONresource for the app, installer, and DMG. - Added graduated Xbox Impulse Trigger feedback and a resistance wall for the DualSense R2 adaptive trigger.
- Added Simplified Chinese and English interfaces with system-language and manual selection modes.
Install
- Download Joy-Harness-v0.2.0-macOS-arm64.dmg and its .sha256 file.
- Open the DMG and drag Joy Harness.app to Applications.
- Use the checksum file to verify the download when needed.
This build is not notarized. macOS may require approval in System Settings > Privacy & Security before first launch.
The DMG contains the desktop app. Install from source with task install when Codex hooks, login startup, notify bridge, and the local CLI are also required.