skills.rest
reason-machines
reason-machinesOFFICIAL
Explore all skills by this author →
Website𝕏@reasonmachinesGitHub

clicklight-macos-click-highlighter

Configure and customize ClickLight, a Swift macOS menu bar app for real-time click highlighting.

4|Updated May 16, 2026
Search Tags:#macOS#swift#demo#screen recording#appkit#menu bar app#click highlighting
One-click install
npx skills add https://github.com/reason-machines/devtools-skills --skill clicklight-macos-click-highlighter-reason-machines
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: clicklight-macos-click-highlighter
Source: https://github.com/reason-machines/devtools-skills/tree/main/skills/clicklight-macos-click-highlighter
Command: npx skills add https://github.com/reason-machines/devtools-skills --skill clicklight-macos-click-highlighter-reason-machines

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Presenters, demo creators, and UX reviewers need audiences to see exactly where clicks happen on screen in real time, but screen recorders only add click effects in post-production. This Skill provides guidance for installing, configuring, customizing, and troubleshooting ClickLight, a native macOS menu bar app that renders live click highlights. ## Core Features & Use Cases - Real-Time Click Visualization: Renders distinct overlay effects for press, release, right-click, and drag events using CGEvent taps and a transparent NSWindow overlay. - Customization & Presets: Adjust click size, duration, intensity, and color via the settings UI, UserDefaults keys, or programmatic Preferences API, plus an optional laser pointer mode. - Build & Troubleshoot: Build from source with Swift Package Manager or Make, diagnose Accessibility permission issues, and fix overlay rendering problems. - Use Case: While recording a product demo with OBS Studio, run ClickLight so every click appears as an expanding colored ring, making your cursor actions visible to viewers without any post-production editing. ## Quick Start Install ClickLight via Homebrew, grant it Accessibility permission in System Settings, then relaunch it and use the menu bar Test Pulse option to verify click highlighting works.

Frequently Asked Questions about clicklight-macos-click-highlighter

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I highlight mouse clicks on macOS during a presentation?▼

Install ClickLight via Homebrew with brew install --cask aurorascharff/clicklight/clicklight, grant Accessibility permission, and relaunch. It renders expanding ring effects at every click location in real time, visible during live screen sharing.

How do I customize click highlight size and color in ClickLight?▼

Open Settings from the menu bar icon, or set values programmatically through Preferences.shared for clickSize, clickDuration, clickIntensity, and clickColor. You can also use defaults write com.yourname.ClickLight clickSize -float 70 from the command line.

Why is ClickLight not detecting my clicks on macOS?▼

ClickLight requires Accessibility permission to create a CGEvent tap for system-wide click detection. Enable it under System Settings → Privacy & Security → Accessibility, then fully quit and relaunch the app for the permission to take effect.

Does ClickLight work with OBS Studio and screen recording tools?▼

Yes, ClickLight's overlay effects are captured by OBS display capture, QuickTime screen recording, and Screen Studio. It provides live effects during recording while tools like Screen Studio can add post-production effects on top.

How do I build ClickLight from source with Swift?▼

Clone the GitHub repository, then run swift build -c release or use the provided Makefile with make build. Use make install to copy the app to /Applications and make run to launch it directly.

Does ClickLight support multiple monitors?▼

Yes, the overlay window unions the frames of all NSScreen displays to cover every monitor. It also listens for didChangeScreenParametersNotification to update the overlay when display configurations change.

Related Skills

Explore More Software Engineering Skills→
gavrielcgavrielc
30.7k

add-macos-statusbar

Installs a macOS menu bar indicator showing NanoClaw status with start, stop, and restart controls.

Community
Intermediate
cdubiel08cdubiel08
2

record-demo

Record screen and narration demos and attach them to GitHub issues.

Community
Intermediate
HKUDSHKUDS
48.8k

cli-anything-openscreen

Edit screen recordings with zoom, trim, speed, and annotations via a stateful CLI.

Official
Intermediate
AradotsoAradotso
4

clicklight-macos-click-highlighter

Highlight macOS mouse clicks with a Swift/AppKit overlay.

Official
Intermediate