Klik PRO v1.3.9

Klik PRO v1.3.9

This is a small final polish update focused on making first-time setup clearer and easier to understand.

What is improved

• Clearer permission status — the Granted and Needs permission badges are now easier to see.
• Better Permissions layout — the Recheck button no longer crowds or overlaps the permission status.
• Updated screenshots — the GitHub previews now show the latest interface at a sharper resolution.

Your existing mouse shortcuts and settings are not changed by this update.

Which file should I download?

• Klik-PRO-v1.3.9-macos-universal.dmg — recommended for most people who prefer a normal drag-and-drop installation.
• install-klik-pro.sh — recommended if you are comfortable with Terminal and want the download authenticated and checked automatically before installation.
• Klik-PRO-v1.3.9-macos-universal.zip — contains the same app as the DMG and is provided as an alternative.

The .sha256 and .sig files are verification files used to confirm that a download is complete and authentic.

See the installation guide for step-by-step instructions.

Compatibility

• macOS 13 or later
• Apple Silicon and Intel Macs
• Open source under the MIT License

After the first launch, macOS will ask you to grant Accessibility access to Klik PRO Helper. This is the only permission Klik PRO requires for receiving extra mouse-button events.

Important macOS note

Klik PRO is open source and ad-hoc signed, but it is not Apple-notarized. macOS may therefore block a manual first launch. The signed Terminal installer verifies the release checksum and signature before installing and removing quarantine.

If Klik PRO is useful to you, consider starring the project or supporting continued development.

Klik PRO v1.3.8

Klik PRO v1.3.8 focuses on reliability, simpler background operation, and safer installation.

Highlights

• Save and apply work now runs away from the AppKit main thread, with visible Applying status and bounded helper timeouts instead of beachballing.
• Mouse mappings, the Klik PRO menu icon, and optional Quick Launch hotkeys now share one background helper and one LaunchAgent. Upgrades remove the obsolete second service automatically.
• Permissions adds a Recheck action for immediately refreshing Accessibility status.
• Special Feature linked-button locks are upright, red, and positioned beside their ChatGPT / Codex or Claude badge.
• A secure Terminal installer authenticates signed checksum manifests with the Klik PRO Ed25519 release key, verifies the DMG and nested app identities, and preserves rollback safety.

Installation

• Recommended GUI path: download the universal DMG and drag Klik PRO.app to Applications.
• Verified Terminal path: download and inspect install-klik-pro.sh, then run it. Never pipe a network response directly into a shell.
• The app is ad-hoc signed and is not Apple-notarized; manual installations still require the documented Gatekeeper approval and Accessibility permission.

Release-key fingerprint: SHA256:Evg4ITqpPJY/aIT48Zv9Cp3psQfo977uCz/35a2k79E

Klik PRO v1.3.7

Improved

• The Klik PRO wordmark is now larger and clearer on both Mappings and Settings.
• The Save button now changes to Klik PRO green with a black outline on hover, while remaining blue at rest.
• ChatGPT / Codex and Claude button selectors have clearer label-to-dropdown spacing.
• The Special Feature card is more compact, with less unused space and better-positioned support actions.
• Permissions, About, and Support cards now have more breathing room below their headings.
• Public screenshots have been refreshed to show the final v1.3.7 interface.

Install

Download the universal DMG, open it, and drag Klik PRO.app onto Applications. The ZIP contains the same universal Apple Silicon + Intel app as an alternative.

Klik PRO remains ad-hoc signed and is not notarized. Follow the included installation guide or the README for the first-launch Gatekeeper and Accessibility steps.

Verification

• Universal Apple Silicon and Intel binaries targeting macOS 13+
• Full routing, background-service, shortcut-isolation, and UI regression checks passed
• DMG mount, Applications shortcut, nested bundle signatures, packaged artwork, ZIP integrity, and checksums verified

Klik PRO v1.3.6

Fixed

• Fresh DMG and ZIP installations now create Klik PRO's two per-user background-service files automatically.
• Accessibility onboarding can start the real nested Klik PRO Helper and create the correct macOS permission entry without manual LaunchAgent copying or username editing.
• The Special Feature toggle now stays ON after activation instead of immediately switching back OFF when its menu service was not previously registered.
• Launch at login and permission repair also verify the required service setup before continuing.

Install

Download the universal DMG, open it, and drag Klik PRO.app onto Applications. The ZIP contains the same universal Apple Silicon + Intel app as an alternative.

Klik PRO remains ad-hoc signed and is not notarized. Follow the included installation guide or the README for the first-launch Gatekeeper and Accessibility steps.

Verification

• Universal Apple Silicon and Intel binaries targeting macOS 13+
• DMG mount, Applications shortcut, nested bundle signatures, packaged artwork, and checksums verified
• Automatic LaunchAgent installation covered by a real temporary-home regression test

Klik PRO v1.3.5

Klik PRO v1.3.5 adds a proper macOS disk image for a cleaner installation experience.

What changed

• Added a verified universal macOS DMG with a standard drag-to-Applications layout.
• Retained the universal ZIP as an alternative download.
• Added SHA-256 checksum files for both formats.
• Updated installation and build documentation for the new release format.

Install

DMG (recommended)

Download Klik-PRO-v1.3.5-macos-universal.dmg, open it, and drag Klik PRO.app onto the Applications shortcut.

ZIP (alternative)

Download Klik-PRO-v1.3.5-macos-universal.zip, extract it, and move Klik PRO.app to Applications.

Klik PRO is a universal Apple Silicon and Intel app for macOS 13 or later. It is ad-hoc signed but not notarized with an Apple Developer ID. If macOS blocks the first launch, click Done, then open System Settings → Privacy & Security and choose Open Anyway. Continue with the bundled INSTALL.md for LaunchAgent and Accessibility setup, or see the current installation guide.

The DMG and ZIP contain the same verified v1.3.5 app bundle and universal binaries.

SHA-256

• DMG: 6bf13afa6279bd7e5251abdfe2fcdae0c41975e4d5e2850e051dae0fd617508f
• ZIP: 74116043599696d6e287cf34e3ef56c5199f23d8e268269de6c1656f2aeb799a

Klik PRO v1.3.4

Highlights

• Added a compact first-launch welcome guide with live Accessibility status, ready-to-try defaults, guided setup, and a reliable Back to Welcome review flow.
• Added clear mouse-over feedback to Save, update, onboarding, and Close controls.
• Standardized the compact Klik PRO wordmark and raised green PRO badge across onboarding, Mappings, Settings, About, and the app icon.
• Improved spacing in the two-column Quick Launch controls and refreshed the README screenshots with the final v1.3.4 layout.
• Clarified installation, button naming, driver status, open-source support, trademark, and contribution documentation.

Clean-install verification

A fresh v1.3.4 installation was verified on macOS 26.5.2 (build 25F84):

• Klik PRO Helper was added automatically to Accessibility during guided onboarding.
• Middle, Gesture, Back, Forward, and thumb-wheel left/right events all routed correctly.
• Keyboard ⌘Tab remained native and was not intercepted.
• Both background services remained running with empty error logs.
• The universal archive, ad-hoc signatures, Intel/Apple Silicon binaries, and SHA-256 checksum were verified.

Install

DMG (recommended)

Download Klik-PRO-v1.3.4-macos-universal.dmg, open it, and drag Klik PRO.app onto the Applications shortcut.

ZIP (alternative)

Download Klik-PRO-v1.3.4-macos-universal.zip, extract it, and move Klik PRO.app to Applications.

Klik PRO is a universal Apple Silicon and Intel app for macOS 13 or later. It is ad-hoc signed but not notarized with an Apple Developer ID. If macOS blocks the first launch, click Done, then open System Settings → Privacy & Security and choose Open Anyway. Continue with the bundled INSTALL.md for LaunchAgent and Accessibility setup, or see the current installation guide.

The DMG was added on 2026-07-14 by repackaging this release's original checksum-verified ZIP. The app bundle and binaries are unchanged.

SHA-256

• DMG: 4da3475b18cf96d5d732195ce5ff41a4118f3e39a6e5d538e9759fe601d7c232
• ZIP: fefbb19797e2470ac42f54ce6642c2d7f713dd7f6e24667453f107466920d460

Klik PRO v1.3.3

Highlights

• Refined the two-column Mappings and Settings layouts, including clearer Permissions, About, support, and Quick Launch controls.
• Added Forward → ChatGPT / Codex and Back → Claude as the new Quick Launch defaults. Existing custom assignments are preserved, and None remains a persistent choice.
• Added Firefox and Firefox Developer Edition thumb-wheel tab switching and compatible native Back/Forward routing.
• Added reset buttons for shortcut fields and extended the red Unsaved changes indicator to every state-changing control.
• Added independent visibility controls for the main Klik PRO icon and Quick Launch icons while keeping configured shortcuts active.
• Added Settings, About, and Quit actions to the main menu-bar icon.

Accessibility and setup

• Settings now shows the only required permission—Accessibility—with live status plus Setup/Open, Reset, and Logs actions.
• The guided setup asks the nested Klik PRO Helper to register itself before opening the correct macOS pane.
• macOS may require Accessibility to be enabled again after installing this new ad-hoc-signed helper build. This final approval remains user-controlled.

Install

DMG (recommended)

Download Klik-PRO-v1.3.3-macos-universal.dmg, open it, and drag Klik PRO.app onto the Applications shortcut.

ZIP (alternative)

Download Klik-PRO-v1.3.3-macos-universal.zip, extract it, and move Klik PRO.app to Applications.

Klik PRO is a universal Apple Silicon and Intel app for macOS 13 or later. It is ad-hoc signed but not notarized with an Apple Developer ID. If macOS blocks the first launch, click Done, then open System Settings → Privacy & Security and choose Open Anyway. Continue with the bundled INSTALL.md for LaunchAgent and Accessibility setup, or see the current installation guide.

The DMG was added on 2026-07-14 by repackaging this release's original checksum-verified ZIP. The app bundle and binaries are unchanged.

SHA-256

• DMG: 613720d8ed1bb6e02a7f06ee5cafe2bf498475d2126e5381a95d8a92576b16b8
• ZIP: a519021dc48bea03fc61a8d6e393cad63c6180546404eea3ccecf44b5f02a110

Klik PRO v1.3.2

Highlights

• Restores the physical Gesture Button as a recordable control with its default ⇧⌘6 shortcut, while a device-scoped F20 sentinel leaves keyboard ⌘Tab unchanged for normal app switching.
• Sends default browser Back/Forward as native side-button events in Chromium-family browsers and Firefox, avoiding Claude for Chrome shortcut activation; Safari keeps its documented bracket fallback.
• Adds read-only detection of configured Chromium-extension shortcuts so browser-local collisions can show May Conflict.
• Adds a persistent Klik PRO menu-bar icon. Its two green button dots appear only while the Accessibility input tap is active.
• Makes the ChatGPT / Codex and Claude Special Feature flexible: each launcher can use None, Middle, Gesture, Forward, or Back without overwriting the button's normal mapping.
• Enables the Special Feature only when a valid ChatGPT / Codex or Claude desktop app is installed, with separate readiness feedback for missing apps and launcher wrappers.
• Lists Scroll Mode as Coming soon without intercepting its native Control-C firmware event.
• Introduces the approved opaque frosted-white mouse preview and centered app icon with an overlapping PRO badge and soft lower shadow.
• Adds a red Unsaved changes note for pending configuration edits, plus refined Special Feature spacing and updated tested-hardware/app documentation.

Upgrade notes

The input helper changed substantially. After replacing the app and LaunchAgents, macOS may require you to remove and re-add Klik PRO Helper under System Settings → Privacy & Security → Accessibility. Existing configuration is migrated and preserved.

Gesture isolation currently targets one supported device profile. Generic middle and forward/back controls were also checked across compatible multi-button mice. Scroll Mode remains native and unimplemented.

The optional ChatGPT / Codex and Claude quick-launch still requires its matching second-instance launcher wrapper. The installed desktop app and wrapper are validated separately.

Klik PRO is ad-hoc signed and not notarized. Gatekeeper therefore blocks a fresh download until you use Open Anyway in Privacy & Security or clear the quarantine attribute as described in INSTALL.md.

Install

DMG (recommended)

Download Klik-PRO-v1.3.2-macos-universal.dmg, open it, and drag Klik PRO.app onto the Applications shortcut.

ZIP (alternative)

Download Klik-PRO-v1.3.2-macos-universal.zip, extract it, and move Klik PRO.app to Applications.

Klik PRO is a universal Apple Silicon and Intel app for macOS 13 or later. It is ad-hoc signed but not notarized with an Apple Developer ID. If macOS blocks the first launch, click Done, then open System Settings → Privacy & Security and choose Open Anyway. Continue with the bundled INSTALL.md for LaunchAgent and Accessibility setup, or see the current installation guide.

The DMG was added on 2026-07-14 by repackaging this release's original checksum-verified ZIP. The app bundle and binaries are unchanged.

SHA-256

• DMG: 631289d813bf2971c1390a31188259dc4477b79896953d65f42bbfbcb6d92ce4
• ZIP: cfc9ead87aefb089732ee998457ff7afa5722cdcef175cb6bbe5b1c7b14063dc

Verification

The complete routing, Gesture isolation, menu-icon, launcher-assignment, installed-app gating, preview-fixture, and unsaved-state checks passed. Both binaries compile for Apple Silicon and Intel with a macOS 13 minimum. Deterministic artwork checks, clean archive inspection, exact resource comparisons, SHA-256 verification, and strict deep code-signature verification also passed.

The packaged v1.3.2 build was not installed or physically retested on the mouse before publication; the currently installed app remains v1.3.1.

Full changes from v1.3.1

Klik PRO v1.3.1

Highlights

• Restores the existing recognizable angled mouse artwork, app icon, and six device callouts.
• Fixes the swapped side-button routing: Mouse Button 4 now uses Back, and Mouse Button 5 uses Forward.
• Leaves Gesture and Scroll Mode firmware shortcuts native so Klik PRO never hijacks physical-keyboard Command-Tab or Control-C.
• Limits thumb-wheel tab switching to discrete mouse-wheel ticks so continuous trackpad swipes pass through.
• Removes unfinished Settings controls until those behaviors are implemented.
• Ships the first downloadable universal package for Apple Silicon and Intel, with a macOS 13 minimum.

Upgrade notes

If you manually swapped the Forward and Back assignments to compensate for v1.3.0, set them back to the intended shortcuts after updating. The input helper changed, so macOS may require you to remove and re-add Klik PRO Helper under System Settings > Privacy & Security > Accessibility.

Klik PRO is ad-hoc signed and not notarized. Gatekeeper therefore rejects a fresh download until you use Open Anyway in Privacy & Security or clear the quarantine attribute as described in INSTALL.md.

Install

DMG (recommended)

Download Klik-PRO-v1.3.1-macos-universal.dmg, open it, and drag Klik PRO.app onto the Applications shortcut.

ZIP (alternative)

Download Klik-PRO-v1.3.1-macos-universal.zip, extract it, and move Klik PRO.app to Applications.

Klik PRO is a universal Apple Silicon and Intel app for macOS 13 or later. It is ad-hoc signed but not notarized with an Apple Developer ID. If macOS blocks the first launch, click Done, then open System Settings → Privacy & Security and choose Open Anyway. Continue with the bundled INSTALL.md for LaunchAgent and Accessibility setup, or see the current installation guide.

The DMG was added on 2026-07-14 by repackaging this release's original checksum-verified ZIP. The app bundle and binaries are unchanged.

SHA-256

• DMG: 704ce694599366800f0573ae08cc27917a880ba0bdbf6174ffbf81ab609c818c
• ZIP: 8b8fae2a1892dd00dc51229acb63fb0ed94f01ec774fef95546c93f168b572a5

Verification

The routing tests, firmware-keyboard pass-through guard, dual-architecture builds, plist checks, deterministic artwork check, clean archive extraction, and deep code-signature verification all passed. Physical-device verification was not rerun for this build.

Full changes from v1.3.0

Klik PRO v1.3.0

New original artwork.

• The app icon and the in-app device diagram are now an original, generic mouse illustration — a clean flat/schematic drawing rather than a photoreal render of a specific commercial mouse. This better fits the "works on any multi-button mouse" spirit and avoids resembling any particular manufacturer's product.
• The generator (tools/draw-mouse.swift) is included, and the six device-diagram callouts were re-tuned to the new control positions.
• Removed the old photoreal image assets; docs updated.

No functional/mapping changes.

Full Changelog: v1.2.2...v1.3.0