Cogria-AI/HeadOrbit

这是什么？

核心功能

• 01将转头、点头和歪头映射为屏幕模糊、提醒或按键操作。
• 02操作按场景分组，可整体开关，内置三个场景。
• 03每个方向的触发角度、保持时间和按键均可调整。
• 04支持自动校正前方姿势，并限制最大偏移量。
• 05仅驻留菜单栏，不使用摄像头，数据不离开本机。

适用场景

• 与人交谈时转头，屏幕自动模糊以保护隐私。
• 伏案工作时低头驼背，收到坐姿提醒。
• 通过歪头启停按键说话式语音输入，双手无需离开键盘。
• 双手忙碌时，用头部动作触发按键。

快速上手

1. 1

   用 Homebrew 安装 xcodegen

   brew install xcodegen
2. 2

   克隆仓库

   git clone https://github.com/Cogria-AI/HeadOrbit.git
3. 3

   进入项目目录并构建

   cd HeadOrbit ./build.sh
4. 4

   打开构建好的应用

   open build/Build/Products/Debug/HeadOrbit.app

使用前须知

• !仅支持 macOS 14 或更高版本，并且需要将支持头部追踪的 AirPods 或 Beats 连接到这台 Mac。
• !应用未经 Apple 公证，首次打开时 macOS 会阻止，需要手动绕过。
• !作者称其为实验性的周末项目，存在不少粗糙之处。
• !从源码构建需要 Xcode 15 或更高版本。

标签

常见问题

HeadOrbit 是什么？

一款 macOS 菜单栏应用，利用 AirPods 头部追踪，通过点头、转头和歪头触发屏幕模糊、坐姿提醒和按键操作。 HeadOrbit 通过支持头部追踪的 AirPods 或 Beats 耳机内置的运动传感器读取头部动作，把转头、点头和歪头转换为 Mac 上的操作，无需摄像头。每个手势方向都可以设置为模糊屏幕、显示坐姿提醒、按下一个键、按住一个键，或不做任何事。

HeadOrbit 可以免费使用吗？用的什么许可证？

HeadOrbit 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

HeadOrbit 还在维护吗？

活跃维护中。HeadOrbit 最近一次提交是在 2026年10月5日。

HeadOrbit 适合用来做什么？

与人交谈时转头，屏幕自动模糊以保护隐私。 伏案工作时低头驼背，收到坐姿提醒。 通过歪头启停按键说话式语音输入，双手无需离开键盘。 双手忙碌时，用头部动作触发按键。

HeadOrbit 怎么安装和运行？

用 Homebrew 安装 xcodegen: brew install xcodegen 克隆仓库: git clone https://github.com/Cogria-AI/HeadOrbit.git 进入项目目录并构建: cd HeadOrbit ./build.sh 打开构建好的应用: open build/Build/Products/Debug/HeadOrbit.app

在哪里获取 HeadOrbit？

源代码和安装说明在 GitHub 上：https://github.com/Cogria-AI/HeadOrbit