Skip to content

Latest commit

 

History

17 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MacCleanScreen

Build

MacCleanScreen 是一个轻量、原生的 macOS 菜单栏清洁工具。它可以在擦拭 Mac 屏幕、键盘和触控板时临时拦截输入,避免误触快捷键、移动窗口或唤醒其他操作。

功能

  • 清洁屏幕:为所有显示器显示纯黑遮罩,同时锁定键盘、鼠标和触控板,方便观察灰尘与指纹。
  • 清洁键盘与触控板:保留当前桌面可见,显示清洁提示卡片并锁定输入。
  • 多显示器支持:自动覆盖当前连接的所有显示器。
  • 安全退出:在任一清洁模式中长按 Esc 3 秒即可恢复输入。
  • 原生轻量:使用 Swift、AppKit 和 Core Graphics 实现,无第三方依赖,清洁功能完全在本机运行。

系统要求

  • macOS 13 Ventura 或更高版本
  • 配备 Apple 芯片的 Mac(arm64)
  • 首次使用时授予“辅助功能”权限
  • 从源码构建时需要 Xcode Command Line Tools

安装

下载 ARM64 安装包

GitHub Releases 下载名称包含 arm64 的 DMG,打开后将 MacCleanScreen 拖入“应用程序”文件夹。

当前版本仅支持配备 Apple 芯片的 Mac。发布包使用临时签名,尚未经过 Apple Developer ID 公证;如果 macOS 阻止首次打开,请优先选择从源码自行构建并审查代码。

从源码构建

git clone https://github.com/lyu-arm/MacCleanScreen.git
cd MacCleanScreen
./scripts/build-app.sh
open dist/MacCleanScreen.app

构建完成后,可以将 dist/MacCleanScreen.app 拖入“应用程序”文件夹。建议先移动应用,再授予辅助功能权限。

MacCleanScreen 是菜单栏应用,启动后不会显示普通窗口,也不会出现在程序坞中。请在屏幕顶部菜单栏寻找带有闪光效果的矩形图标。

首次授权

为了在清洁模式期间阻止全局按键、快捷键、鼠标和触控板操作,MacCleanScreen 需要 macOS 的辅助功能权限。

  1. 启动 MacCleanScreen。
  2. 应用会自动请求辅助功能权限,并打开“隐私与安全性 → 辅助功能”。
  3. 打开 MacCleanScreen 旁边的开关。
  4. 返回菜单栏;授权成功后,权限提示会自动隐藏。
  5. 如果授权尚未生效,请退出并重新启动 MacCleanScreen。

清洁屏幕

  1. 点击菜单栏中的 MacCleanScreen 图标。
  2. 选择“清洁屏幕”。
  3. 所有显示器变为黑色后开始擦拭屏幕。
  4. 完成后长按 Esc 3 秒。
  5. 黑色遮罩消失,键盘、鼠标和触控板恢复使用。

纯黑背景可以让灰尘、油渍和指纹更加明显。请勿将清洁液直接喷到屏幕或键盘上。

清洁键盘与触控板

  1. 点击菜单栏中的 MacCleanScreen 图标。
  2. 选择“清洁键盘与触控板”。
  3. 出现提示卡片后开始擦拭键盘、触控板和机身表面。
  4. 完成后长按 Esc 3 秒恢复输入。

退出应用

在未进入清洁模式时,点击菜单栏图标并选择“退出 MacCleanScreen”。

如果正在清洁模式中,请先长按 Esc 3 秒退出清洁模式,再从菜单栏退出应用。

使用说明

  • MacCleanScreen 只会在用户主动进入清洁模式后临时拦截输入。
  • 长按 Esc 3 秒即可退出清洁模式并恢复键盘、鼠标和触控板。
  • 本工具用于避免清洁过程中的误触,不替代系统锁屏或安全防护功能。

隐私

MacCleanScreen 的清洁功能完全在本机运行,不收集或上传键盘、鼠标、触控板及设备数据,不包含遥测,也不需要账户。辅助功能权限只用于在清洁模式期间拦截输入事件。

许可

MIT License

About

A lightweight native macOS utility that locks input while cleaning the screen, keyboard, and trackpad.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages