Skip to content

MANUAL_INSTALL.md

Latest commit

 

History

History
57 lines (38 loc) · 1.3 KB

MANUAL_INSTALL.md

File metadata and controls

57 lines (38 loc) · 1.3 KB
Raw

Manual Install

Use this if you want to build ClickLight from source and install the app yourself instead of using Homebrew.

Build And Copy

From the project root:

chmod +x build-app.sh
./build-app.sh
mkdir -p "$HOME/Applications"
cp -R ClickLight.app "$HOME/Applications/ClickLight.app"
open "$HOME/Applications/ClickLight.app"

You can also drag ClickLight.app into /Applications in Finder.

Accessibility Permission

ClickLight needs Accessibility permission to detect clicks outside its own menu-bar app.

After launching ClickLight, open:

System Settings -> Privacy & Security -> Accessibility

Enable ClickLight, then quit ClickLight from the menu bar and reopen it.

Verify

Click the ClickLight menu-bar item and choose:

Test Pulse at Pointer

If you see a pulse, the overlay is working. If normal clicks still do not show pulses, check that Accessibility permission is enabled for the same copy of ClickLight.app that you launched.

Rebuild After Changes

After changing source files:

./build-app.sh
pkill -x ClickLight
cp -R ClickLight.app "$HOME/Applications/ClickLight.app"
open "$HOME/Applications/ClickLight.app"

Remove Manual Install

rm -rf "$HOME/Applications/ClickLight.app"
defaults delete com.aurorascharff.ClickLight