Caps Lock Indicator

Tiny Caps Lock overlay for Linux, Windows, and macOS.

• Shows a square CAPS window when Caps Lock is ON
• Hides immediately when Caps Lock is OFF
• Top-left position on primary display

Ubuntu/Linux install from source

chmod +x install.sh
./install.sh

This installs:

• Binary: ~/.local/bin/capslock-indicator
• User service: ~/.config/systemd/user/capslock-indicator.service
• Autostart desktop file: ~/.config/autostart/capslock-indicator.desktop

Linux runtime commands

systemctl --user status capslock-indicator.service
systemctl --user restart capslock-indicator.service
systemctl --user stop capslock-indicator.service

Build downloadable binaries

chmod +x scripts/build_binary.sh
VERSION=0.1.0 ./scripts/build_binary.sh

Artifacts are emitted to dist/release/:

• Linux: capslock-indicator-<version>-linux-x86_64.tar.gz
• macOS: capslock-indicator-<version>-macos.zip
• Windows: capslock-indicator-<version>-windows-x86_64.zip

Build Debian package (.deb)

chmod +x scripts/build_deb.sh
VERSION=0.1.0 ./scripts/build_deb.sh

Output: dist/capslock-indicator_<version>_all.deb

Install locally:

sudo apt install ./dist/capslock-indicator_0.1.0_all.deb

Snap package

Snap config is in snap/snapcraft.yaml.

Build locally:

sudo snap install snapcraft --classic
cd snap
snapcraft

GitHub Releases automation

Tag push v* triggers .github/workflows/release.yml, which builds:

• Linux binary archive
• macOS binary archive
• Windows binary archive
• Debian .deb

All artifacts are attached to the GitHub Release automatically.

Publish to package managers

sudo apt install capslock-indicator from default Ubuntu repos requires official Debian/Ubuntu acceptance (not immediate).

Practical fast path:

1. Publish Snap to Snap Store (snapcraft upload <snap-file>) so users can run snap install capslock-indicator.
2. Publish .deb in a PPA (Launchpad) so users can install with apt.
3. Keep GitHub Release assets for one-click direct downloads across Linux/Windows/macOS.