Releases: prioneto/ClickShift
Release list
ClickShift v1.3.0
ClickShift 1.3.0 redesigns the menu-bar dropdown and the Settings window so they look and feel like a native Mac app in both light and dark mode.
What’s new
Menu-bar dropdown
- A header with a live status badge: Connected, Searching, Waiting, Paused, or Action needed.
- Status rows for the right-hand Zwift Click v2 and your training app, with a spinner and wake-up hint while ClickShift searches.
- Button mappings shown as key caps, such as
+ → KandB → I, along with your last shift. - Menu-style Reconnect, Settings… (⌘,), and Quit ClickShift (⌘Q) rows.
- An Allow… button right in the dropdown when Accessibility access is missing.
Settings
- A native sidebar window that follows your Mac’s light or dark appearance.
- Standard macOS switches, pop-up menus, and a 1 / 2 / 3 gear-step control, grouped into clear sections.
- General opens with a connection status card with Reconnect, Stop, or Start.
- Permissions shows Accessibility and Bluetooth status at a glance and refreshes automatically when you return from System Settings.
- A new About page with version, privacy, source code, and diagnostics export.
The menu-bar icon, dropdown, and Settings now share one status model, so they always agree.
Default MyWhoosh controls
- Right Click
+→K→ shift up - Right Click
B→I→ shift down
Button assignments, keyboard shortcuts, and shifts per press can be changed under Settings → Controls.
Requirements
- macOS 13 Ventura or later
- Apple Silicon or Intel Mac
- Right-hand Zwift Click v2
- A training app that accepts keyboard shortcuts for shifting
Installation
- Download
ClickShift-v1.3.0-macOS-universal.zip. - If you are updating, quit ClickShift from its menu-bar dropdown first.
- Unzip the download and move
ClickShift.appto/Applications, replacing the old copy. - Open ClickShift. New users choose a training app and grant Bluetooth and Accessibility in the Setup Assistant.
The app is ad-hoc signed but not Apple-notarized. If macOS blocks the first launch, open System Settings → Privacy & Security, choose Open Anyway, and confirm.
After an update, macOS may ask for Accessibility again. If the dropdown shows Action needed, click Allow…. If that does not help, remove ClickShift from System Settings → Privacy & Security → Accessibility and add it again.
Verification
SHA-256:
bdbdba2ae8ea2e4412533188c3057119385b3c1e85259e6bbab403c8c4cf1585
ClickShift is unofficial and is not affiliated with Zwift, MyWhoosh, or the other supported training applications.
ClickShift v1.2.2
ClickShift 1.2.2
This patch improves reliability when your Mac sleeps and wakes.
What’s new
- Automatically restores the Zwift Click Bluetooth connection after macOS wakes.
- Restarts Bluetooth scanning and refreshes the selected riding app after wake.
- Keeps the menu-bar icon orange while Bluetooth is recovering instead of briefly showing an error.
- Prevents stale disconnect events from interrupting a newly restored Click connection.
- Pauses reconnection and keepalive work cleanly while the Mac is asleep.
Download
Download ClickShift-v1.2.2-macOS-universal.zip, unzip it, and move ClickShift.app to Applications.
Requires macOS 13 or later. Universal build for Apple Silicon and Intel Macs.
ClickShift is ad-hoc signed but not Apple-notarized. If macOS blocks the first launch, open System Settings → Privacy & Security and choose Open Anyway.
ClickShift v1.2.1
ClickShift v1.2.1
ClickShift 1.2.1 returns app selection to the user and keeps the interface focused on setup and shifting.
What changed
- Restored manual training-app selection in onboarding and Settings → General.
- Removed automatic training-app detection and automatic target switching.
- Removed the large “How ClickShift works” explanation panels from onboarding and Settings.
- Kept profiles for MyWhoosh, TrainingPeaks Virtual, ROUVY, and any custom macOS app that accepts keyboard shifting shortcuts.
- Expanded the README’s How it works section so the connection model remains fully documented without taking over the app interface.
- Clarified that the training app connects directly to and controls the trainer, while ClickShift connects only to the right-hand Zwift Click v2 and sends keyboard shortcuts.
- Kept Zwift out of the target list because Zwift supports the Click natively.
Default MyWhoosh controls
- Right Click
+→K→ shift up - Right Click
B→I→ shift down
Button assignments, keyboard shortcuts, and shifts per press can be changed under Settings → Controls.
Requirements
- macOS 13 Ventura or later
- Apple Silicon or Intel Mac
- Right-hand Zwift Click v2
- A training app that accepts keyboard shortcuts for shifting
Installation
- Download
ClickShift-v1.2.1-macOS-universal.zip. - Unzip it and move
ClickShift.appto/Applications. - Open ClickShift and choose your training app in the Setup Assistant.
- Allow Bluetooth access for the Click and Accessibility access for keyboard shortcuts.
- Connect your trainer directly inside your training app as usual.
The app is ad-hoc signed but not Apple-notarized. If macOS blocks the first launch, open System Settings → Privacy & Security, choose Open Anyway, and confirm.
Verification
SHA-256:
d994291aa4ec190a5d70f7c1b284880fa9ea299b2f4ed92f5c20b45675b62cf2
ClickShift is unofficial and is not affiliated with Zwift, MyWhoosh, or the other supported training applications.
ClickShift 1.1.0
ClickShift 1.1.0
ClickShift 1.1 makes setup easier, shifting safer, and the app feel at home on modern macOS.
What’s new
- Added a guided first-run setup for choosing a riding app, checking Bluetooth and Accessibility permissions, and finding the right-hand Zwift Click v2.
- Added a safety mode that sends shift keys only while the selected riding app is focused. It is enabled by default.
- Added configurable Click buttons and keyboard outputs for shift up and shift down.
- Added 1, 2, or 3 virtual gear shifts per button press.
- Added profiles for MyWhoosh, Zwift, IndieVelo, ROUVY, and custom applications.
- Improved remembered-controller reconnection and added clear guidance when the right Click needs to be woken.
- Added consistent session states for waiting, searching, connecting, connected, stopped, and permission problems.
- Added privacy-safe diagnostics export. Reports exclude accounts, ride data, and controller identifiers.
- Added optional notifications for meaningful connection and permission events.
- Added connection-aware menu-bar icon colors: gray while idle, orange while searching, green when connected, and red when attention is needed.
- Redesigned the menu-bar panel and Settings window with cleaner native macOS spacing and controls.
- Added a standard Settings command with the
Command-,keyboard shortcut.
Default MyWhoosh controls
- Right Click
+→K→ shift up - Right Click
B→I→ shift down
Button and key assignments can be changed under Settings → Controls.
Requirements
- macOS 13 Ventura or later
- Apple Silicon or Intel Mac
- Right-hand Zwift Click v2
- A riding application that supports keyboard shifting
Installation
- Download
ClickShift-v1.1.0-macOS-universal.zip. - Unzip it and move
ClickShift.appto/Applications. - Open ClickShift and complete the Setup Assistant.
- Allow Bluetooth and Accessibility access when prompted.
- Keep Open ClickShift when I log in enabled for automatic riding-app detection.
The app is ad-hoc signed but not Apple-notarized. If macOS blocks the first launch, open System Settings → Privacy & Security, choose Open Anyway, and confirm.
Verification
SHA-256:
d833f0e0b589acbff2060141b5bfb18d4c2349a0b0e4b6dc13e3d4477b52a641
ClickShift is unofficial and is not affiliated with Zwift, MyWhoosh, or the other supported riding applications.
ClickShift v1.0.0
ClickShift v1.0.0
The first public release of ClickShift: a small, free macOS menu-bar bridge between the right-hand Zwift Click v2 and MyWhoosh virtual shifting.
Features
+shifts up in MyWhooshBshifts down in MyWhoosh- Automatically activates when MyWhoosh opens
- Automatic Bluetooth reconnection
- Disconnects when MyWhoosh quits so the Click can sleep
- Optional launch at login
- Test-shift buttons and connection status in the menu bar
- Universal macOS build for Apple Silicon and Intel
- No telemetry, accounts, advertising, or network communication
Requirements
- macOS 13 Ventura or later
- Zwift Click v2 right controller
- MyWhoosh with Virtual Shifting enabled
Installation
- Download
ClickShift-v1.0.0-macOS-universal.zipbelow. - Unzip it and move
ClickShift.appto/Applications. - Open ClickShift and approve Bluetooth access.
- Use Enable Accessibility in its menu and enable it in System Settings → Privacy & Security → Accessibility.
- Open MyWhoosh and wake the right Click.
macOS security notice
This free build is ad-hoc signed but not Apple-notarized. On first launch, macOS may require you to try opening the app and then choose Open Anyway under System Settings → Privacy & Security. Only do this for a build downloaded from this repository. The complete source and build script are available for inspection. See Apple's security guidance for details.
Known limitations
- Only the right-hand Click v2 is used;
Bis reassigned to downshift. - MyWhoosh must retain its
I/Kshifting shortcuts. - A future Click firmware update could require a protocol update.
Download verification
SHA-256 for ClickShift-v1.0.0-macOS-universal.zip:
fca7ea6566fba94201fa5dac05203229af72c2ee2676d48b44c15afc17407d31