CleanLock

Temporary input lock for cleaning your MacBook.

CleanLock is a small native macOS menu bar utility that temporarily blocks keyboard input, mouse and trackpad input, scrolling, and gestures while you wipe your MacBook keyboard, trackpad, or screen.

It is not a system cleaner or file cleanup tool. CleanLock simply creates a safe temporary mode where your Mac does not react to accidental input, while the dark overlay makes dust, fingerprints, and smudges easier to see.

To exit, hold the left and right Command keys for 3 seconds.

---

Language

🇺🇸 English

🇷🇺 Русский

---

🇺🇸 English

What Is CleanLock

CleanLock is a small native macOS menu bar utility that temporarily blocks input so you can safely wipe your MacBook keyboard, trackpad, or screen.

The app blocks keyboard input, clicks, taps, drag events, scrolling, and trackpad gestures, hides the cursor, dims the screen, and exits the mode when you hold the left and right Command keys for 3 seconds.

CleanLock does not clean anything by itself. It simply prevents macOS from reacting to accidental input while you clean your MacBook manually.

Installation

1. Open the Releases page.
2. Download CleanLock.zip.
3. Unzip the archive.
4. Drag CleanLock.app into the Applications folder.
5. If macOS says the app is damaged or cannot be opened, run this command in Terminal:

sudo xattr -r -c /Applications/CleanLock.app

Then launch CleanLock from Applications and complete onboarding.

The public build is not signed or notarized by Apple yet, so macOS may show a security warning on first launch.

Features

• Blocks keyboard input while cleaning.
• Blocks trackpad and mouse clicks, taps, drag events, scrolling, and trackpad gestures.
• Uses HID device seizure as an additional blocking layer for mouse and trackpad devices.
• Hides and freezes the cursor during cleaning mode.
• Shows a dark full-screen overlay so dust, fingerprints, and smudges are easier to see.
• Unlocks with Left Command + Right Command held for 3 seconds.
• Shows visual Command-key indicators and unlock progress.
• Includes an automatic safety timeout: 5, 10, or 20 minutes.
• Can dim all displays or only the main display.
• Runs as a native macOS menu bar app.
• Supports English and Russian, with a language selector in Settings.
• Works locally on your Mac.
• No network access, no analytics, no tracking, no key logging.

Demo

Watch the MP4 demo

Why

Cleaning a MacBook keyboard or trackpad usually means either shutting the Mac down or fighting accidental key presses, clicks, app switches, and random shortcuts.

CleanLock gives you a quick temporary cleaning mode:

1. Turn it on from the menu bar.
2. Clean your keyboard, trackpad, or screen.
3. Hold both Command keys to unlock.

That is the whole idea. No extra modes, no clutter, no background nonsense.

How It Works

CleanLock uses macOS event taps, IOHIDManager, and CoreGraphics to temporarily intercept input, seize pointer devices, and hide the cursor while cleaning mode is active.

During cleaning mode:

• keyboard input is blocked;
• clicks, taps, drag events, and scrolling are blocked;
• mouse and trackpad devices are additionally blocked at the HID level if macOS allows exclusive device seizure;
• the cursor is hidden and disconnected from physical mouse/trackpad movement;
• the screen is dimmed with a dark overlay;
• unlock is triggered by holding both Command keys for 3 seconds.

If the unlock gesture does not work, CleanLock exits automatically after the configured safety timeout.

Privacy

CleanLock is built to stay local and quiet.

• CleanLock does not record keystrokes.
• CleanLock does not store input.
• CleanLock does not send data anywhere.
• CleanLock does not use the internet.
• CleanLock does not use analytics.
• CleanLock does not track users.
• CleanLock only listens for input while cleaning mode is active.

The app needs input-related permissions only to block input during cleaning mode and detect the unlock gesture.

Required Permissions

macOS requires explicit permission for apps that monitor or intercept input.

CleanLock asks for:

Accessibility

Used to temporarily block keyboard and pointer events during cleaning mode.

Input Monitoring

Used to detect the left and right Command keys for unlocking.

You can review or revoke these permissions anytime in:

System Settings -> Privacy & Security -> Accessibility
System Settings -> Privacy & Security -> Input Monitoring

How To Use

1. Launch CleanLock.
2. Complete onboarding.
3. Grant the required macOS permissions.
4. Pass the unlock test by holding left and right Command.
5. Click the CleanLock icon in the menu bar.
6. Choose Start Cleaning Mode.
7. Clean your keyboard, trackpad, or screen.
8. Hold left and right Command for 3 seconds to exit cleaning mode.

If the unlock gesture does not work, CleanLock exits automatically after the configured safety timeout.

Language

CleanLock supports English and Russian.

On first launch, the app uses Russian if your macOS system language is Russian. For all other system languages, CleanLock starts in English. You can switch the language anytime in Settings.

External Keyboards

CleanLock uses the left and right Command keys as the unlock gesture.

Some external keyboards do not have a right Command key or report modifier keys differently. If the gesture is unavailable, the safety timeout will still return control automatically.

Limitations

• The power button is not blocked.
• CleanLock is intended as a convenience utility, not a security lock.
• On external keyboards without a right Command key, manual unlock may be unavailable, so auto-unlock is always enabled.
• Behavior on some external devices can depend on macOS drivers and device vendors.

Requirements

• macOS 13.0 or later
• Apple Silicon or Intel Mac

Build From Source

Xcode 15 or later is recommended for building from source.

Clone the repository and open the Xcode project:

git clone https://github.com/fromtimo/CleanLock.git
cd CleanLock
open CleanLock.xcodeproj

Then select the CleanLock scheme and run the app from Xcode.

The first launch will show onboarding and guide you through the required macOS permissions.

Tech Stack

• Swift
• SwiftUI
• AppKit
• CGEventTap
• IOHIDManager
• CoreGraphics
• ServiceManagement
• UserDefaults

Project Status

CleanLock is a focused macOS utility. It is usable, intentionally small, and built around one job: making it less annoying to clean a MacBook without triggering random input.

Issues and pull requests are welcome.

Feedback

If you tried CleanLock and want to share thoughts, ideas, or issues, please fill out this short feedback form.

License

CleanLock is released under the MIT License. See LICENSE.

---

🇷🇺 Русский

Что такое CleanLock

CleanLock - маленькая нативная macOS-утилита для меню-бара, которая временно блокирует ввод, чтобы ты мог спокойно протереть клавиатуру, трекпад или экран MacBook.

Приложение блокирует клавиатуру, клики, тапы, drag-события, скролл и жесты трекпада, скрывает курсор, затемняет экран и выходит из режима по удержанию левой и правой Command в течение 3 секунд.

CleanLock ничего не чистит сам. Он просто не дает macOS реагировать на случайные нажатия, пока ты чистишь MacBook руками.

Установка

1. Открой страницу Releases.
2. Скачай CleanLock.zip.
3. Распакуй архив.
4. Перетащи CleanLock.app в папку Applications.
5. Если macOS пишет, что приложение повреждено или не может быть открыто, выполни в Terminal:

sudo xattr -r -c /Applications/CleanLock.app

После этого запусти CleanLock из Applications и пройди onboarding.

Публичная сборка пока не подписана и не notarized Apple, поэтому macOS может показать предупреждение безопасности при первом запуске.

Возможности

• Блокирует ввод с клавиатуры во время очистки.
• Блокирует клики, тапы, drag-события, скролл и жесты трекпада.
• Использует HID-захват мыши и трекпада как дополнительный уровень блокировки.
• Скрывает и замораживает курсор на время режима очистки.
• Показывает темный полноэкранный overlay, чтобы пыль, отпечатки и разводы были заметнее.
• Выходит из режима по удержанию Left Command + Right Command в течение 3 секунд.
• Показывает визуальные индикаторы Command-клавиш и прогресс выхода.
• Имеет страховочный таймер автоотключения: 5, 10 или 20 минут.
• Может затемнять все экраны или только главный экран.
• Работает как нативное macOS-приложение в меню-баре.
• Поддерживает русский и английский язык с выбором в настройках.
• Работает локально на Mac.
• Без интернета, аналитики, трекинга и записи нажатий.

Demo

Посмотреть MP4-демо

Зачем это нужно

Когда нужно протереть клавиатуру или трекпад MacBook, обычно приходится либо выключать Mac, либо терпеть случайные нажатия, клики, переключения приложений и странные системные шорткаты.

CleanLock дает простой режим очистки:

1. Включаешь режим через иконку в меню-баре.
2. Чистишь клавиатуру, трекпад или экран.
3. Удерживаешь две Command, чтобы выйти.

Все. Без лишних режимов, настроек и цифрового цирка.

Как это работает

CleanLock использует macOS event taps, IOHIDManager и CoreGraphics, чтобы временно перехватывать ввод, блокировать устройства указателя и скрывать курсор, пока активен режим очистки.

Во время режима очистки:

• клавиатура заблокирована;
• клики, тапы, drag-события и скролл заблокированы;
• мышь и трекпад дополнительно блокируются на HID-уровне, если macOS разрешила exclusive-захват устройства;
• курсор скрыт и отвязан от физического движения мыши/трекпада;
• экран затемняется темным overlay;
• выход происходит по удержанию двух Command в течение 3 секунд.

Если сочетание для выхода не сработает, CleanLock автоматически выключит режим очистки по страховочному таймеру.

Приватность

CleanLock работает локально и не собирает данные.

• CleanLock не записывает нажатия клавиш.
• CleanLock не сохраняет ввод.
• CleanLock не отправляет данные куда-либо.
• CleanLock не использует интернет.
• CleanLock не использует аналитику.
• CleanLock не отслеживает пользователей.
• CleanLock слушает ввод только во время активного режима очистки.

Разрешения нужны только для временной блокировки ввода и определения сочетания клавиш для выхода.

Необходимые разрешения

macOS требует явного разрешения для приложений, которые отслеживают или перехватывают ввод.

CleanLock запрашивает:

Универсальный доступ

Нужен для временной блокировки клавиатуры и событий указателя во время режима очистки.

Мониторинг ввода

Нужен для определения левой и правой Command при выходе из режима очистки.

Проверить или отозвать разрешения можно в:

Системные настройки -> Конфиденциальность и безопасность -> Универсальный доступ
Системные настройки -> Конфиденциальность и безопасность -> Мониторинг ввода

Как использовать

1. Запусти CleanLock.
2. Пройди onboarding.
3. Выдай необходимые разрешения macOS.
4. Пройди проверку выхода, удержав левую и правую Command.
5. Нажми на иконку CleanLock в меню-баре.
6. Выбери Включить режим очистки.
7. Почисти клавиатуру, трекпад или экран.
8. Удерживай левую и правую Command 3 секунды, чтобы выйти из режима очистки.

Если сочетание для выхода не сработает, CleanLock автоматически выйдет из режима по страховочному таймеру.

Язык

CleanLock поддерживает русский и английский язык.

При первом запуске приложение выбирает русский, если язык системы macOS - русский. Для всех остальных системных языков CleanLock запускается на английском. Язык можно изменить в настройках в любой момент.

Внешние клавиатуры

CleanLock использует левую и правую Command как сочетание для выхода.

На некоторых внешних клавиатурах может не быть правой Command, либо клавиатура может иначе передавать modifier-клавиши. Если ручной выход недоступен, страховочный таймер автоматически вернет управление.

Ограничения

• Кнопка питания не блокируется.
• CleanLock - это удобная утилита для очистки, а не защитная блокировка.
• На внешних клавиатурах без правой Command ручной выход может быть недоступен, поэтому автоотключение всегда включено.
• На отдельных внешних устройствах поведение может зависеть от драйверов macOS и производителя.

Требования

• macOS 13.0 или новее
• Apple Silicon или Intel Mac

Сборка из исходников

Для сборки из исходников рекомендуется Xcode 15 или новее.

Клонируй репозиторий и открой Xcode-проект:

git clone https://github.com/fromtimo/CleanLock.git
cd CleanLock
open CleanLock.xcodeproj

Затем выбери схему CleanLock и запусти приложение из Xcode.

При первом запуске CleanLock покажет onboarding и проведет через необходимые разрешения macOS.

Технологии

• Swift
• SwiftUI
• AppKit
• CGEventTap
• IOHIDManager
• CoreGraphics
• ServiceManagement
• UserDefaults

Статус проекта

CleanLock - сфокусированная macOS-утилита. Она намеренно маленькая и делает одну задачу: помогает спокойно почистить MacBook без случайного ввода.

Issues и pull requests приветствуются.

Обратная связь

Если ты попробовал CleanLock и хочешь поделиться впечатлениями, идеями или проблемами, заполни короткую форму обратной связи.

Лицензия

CleanLock распространяется под лицензией MIT. См. LICENSE.