Skip to content

Repository files navigation

KeyFoley 图标

KeyFoley

让每一次敲击,都有恰到好处的声音和动作。
一个轻量、原生、注重隐私的 macOS 键盘反馈应用,
用可自由组合的按键音和一只会打字、懂快捷键的小猫回应你的每次敲击。

下载最新版本 · 参与开发

为键盘加一点手感

KeyFoley 在你按下键盘时低延迟播放声音,让普通键盘也能拥有更鲜明的敲击反馈。声音样本会在主题载入时一次性预加载,日常打字过程中不会反复读取磁盘。

内置七套风格:

  • 剪刀脚 — 清脆、轻巧,适合作为默认主题
  • 机械键盘 — 更低沉、更有段落感
  • 青轴 · ABS — 清晰响亮,带有典型青轴段落感
  • 黑轴 · PBT — 扎实克制,声音更厚实
  • 经典打字机 — 字母、空格和换行各有自己的声音
  • 桌面点击 — 自动铅笔、圆珠笔与笔帽的细小机械声
  • 铅笔笔记 — 像在纸上快速写下一行字

主题可以为普通键、空格、回车、删除、Esc、方向键和修饰键提供不同的声音样本,KeyFoley 会根据所选主题自动使用。

组合自己的声音主题

声音主题管理器可以直接浏览、试听内置主题和素材库。独立素材库收录了 300 多条机械键盘、界面反馈和小猫等音效,可以按分组挑选并添加到自定义主题;也可以复用内置主题的样本,或从本地导入 WAV、AIFF、MP3、M4A 等音频文件。

添加的素材会被复制到自定义主题中;本地文件还会被统一转换,因此之后移动原文件或升级 App 都不会影响已经创建的主题。长按连续发声可以排除任意多个指定按键,修饰键声音和音量也可以分别调整,并可通过自定义全局快捷键随时开关按键音。

会跟着你打字的键盘小猫

小猫的动作、状态和虚拟键帽会随着你的输入一起变化。

打字状态,一眼就能看见

小猫通过左右爪回应不同区域的按键,虚拟键盘也会按照实际物理键位同步高亮。普通输入时显示最近一秒的按键数;达到设置的速度后,小猫头顶会出现火苗。关闭按键音时,小猫旁会显示静音气泡。

KeyFoley 小猫依次展示普通打字速度、高速打字火苗和静音气泡

按住修饰键,发现更多键盘能力

Shift 会显示 ABC 换挡字符,Option 会显示可输入的特殊字符,Command 会标出常用快捷键,Control 则提供文本导航提示。组合修饰键时,键帽也会随之变化。

KeyFoley 依次展示 Shift、Option、Option 加 Shift、Command、Command 加 Shift 和 Control 六种修饰键提示

小猫可以独立于按键音开启,并提供四套键盘配色、四个屏幕角落、尺寸和不透明度设置;透明悬浮窗口不会拦截鼠标点击。

安静地待在后台

KeyFoley 不占用 Dock。关闭设置窗口后,它会继续在后台运行;从启动台、Spotlight 或 Finder 再次打开即可回到设置。是否登录时自动运行,由你在 macOS 登录项中手动决定。

隐私优先

KeyFoley 只观察物理按键和系统控制键事件,以驱动声音和可选的小猫动画:

  • 不读取输入的字符或文本
  • 不保存具体按键
  • 不包含网络请求、账号或分析统计
  • 按键测试记录只在你手动开启时保留于内存,关闭测试窗口后立即清空

更多细节见隐私说明

下载与安装

系统要求:macOS 13 或更高版本,支持 Apple Silicon 和 Intel Mac。

  1. Releases 下载最新的 KeyFoley-*.dmg
  2. 打开 DMG,将 KeyFoley 拖入“应用程序”。
  3. 首次打开 KeyFoley。

目前的 GitHub 版本使用 ad-hoc 签名,未经过 Apple 公证。如果 macOS 提示无法验证开发者:

  1. 先尝试打开一次 KeyFoley 并关闭警告。
  2. 打开“系统设置 → 隐私与安全性”。
  3. 向下滚动,在安全性区域点击“仍要打开”,然后再次确认。

macOS 会将 KeyFoley 记为例外,之后可以像普通应用一样直接打开。请只对从本仓库 Releases 下载、并且由你信任的构建执行此操作。具体机制可参考 Apple 的安全说明

授予输入监控权限

KeyFoley 需要“输入监控”权限才能观察全局按键。首次启动后,在设置窗口的“系统”页面请求权限,将 KeyFoley 加入并启用;按照系统提示重新打开应用后即可开始播放。

开发与自定义

KeyFoley 使用 Swift、SwiftUI、AppKit、Core Graphics Event Tap、IOKit HID 和 AVAudioEngine 构建,不要求安装完整的 Xcode IDE。

许可

除内置第三方音频外,KeyFoley 的源代码和原创资源采用 MIT License。FilmCow 音频保留其原始自定义许可,详情见第三方声音来源

About

为 macOS 带来细腻、可替换的键盘按键音

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages