whatisgithub

What is luce?

arinltte/luce — explained in plain English

Analysis updated 2026-05-18

31SwiftAudience · generalComplexity · 1/5Setup · easy

In one sentence

A macOS menu bar app that locks your keyboard so you can clean it without triggering keystrokes or system shortcuts.

Mindmap

mindmap
  root((LUCE))
    What it does
      Locks keyboard
      Safe cleaning
      Menu bar app
    Tech stack
      Swift
      No dependencies
    Key features
      Brightness safety check
      Crash safe unlock
      Color themes
    Install
      Drag to Applications
      macOS 14 required

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Lock your Mac keyboard completely while wiping crumbs and dust off the keys.

USE CASE 2

Prevent accidental system shortcuts or media key presses during cleaning.

USE CASE 3

Unlock instantly using the mouse or trackpad, which stay active the whole time.

USE CASE 4

Recover automatically if the app crashes, so the keyboard is never left locked.

What is it built with?

Swift

How does it compare?

arinltte/lucecybersealnull/cccompanionpylogmon/istart
Stars313131
LanguageSwiftSwiftSwift
Setup difficultyeasyhardmoderate
Complexity1/54/52/5
Audiencegeneraldevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires macOS 14 Sonoma or later and granting Accessibility permission.

So what is it?

LUCE is a small macOS menu bar app with a single job: let you clean your keyboard without accidentally pressing keys or triggering system shortcuts while you do it. Clicking "Lock Keyboard" in the menu bar blocks all keyboard input at the system level, including media keys for volume and brightness. Your mouse and trackpad still work, so you can click "Unlock" when you are done. The app is written in Swift with no third-party dependencies. It lives in the menu bar (the strip of icons at the top right of a Mac screen) and shows a small floating panel anchored to the top of the display when activated. The panel stays on top of other windows so the Unlock button is always reachable. A safety check runs before locking: LUCE reads the current screen brightness and refuses to lock if it is below 20%, because a dark screen would make the Unlock button hard to see. The app also installs a crash-safe handler so the keyboard is always restored even if the app quits unexpectedly. Visual customization includes four color themes for the panel background (Default, Rare Jade, Deep Ocean, and Floral) and a choice of menu bar icon from Apple's built-in SF Symbols set. An automatic update check in the About panel compares the installed version against the latest GitHub release. Installation is a standard drag-to-Applications from a downloaded disk image. macOS may block first launch because the app is not distributed through the App Store, the README includes a one-line Terminal command to clear that flag. The app requires macOS 14 (Sonoma) or later and requests Accessibility permission, which is needed to intercept keyboard events system-wide.

Copy-paste prompts

Prompt 1
Explain how LUCE locks the keyboard at the system level on macOS.
Prompt 2
Help me install LUCE and grant it the Accessibility permission it needs.
Prompt 3
Why does LUCE refuse to lock the keyboard when screen brightness is low?
Prompt 4
Show me how to change LUCE's panel color theme and menu bar icon.

Frequently asked questions

What is luce?

A macOS menu bar app that locks your keyboard so you can clean it without triggering keystrokes or system shortcuts.

What language is luce written in?

Mainly Swift. The stack also includes Swift.

How hard is luce to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is luce for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.