Cogria-AI/HeadOrbit

어떤 프로젝트인가요?

핵심 기능

• 01머리 돌리기, 끄덕이기, 기울이기를 화면 흐리게 하기, 알림 표시 또는 키 입력으로 바꿉니다.
• 02제스처 동작을 전환 가능한 씬으로 묶으며, 기본 씬 세 가지를 제공합니다.
• 03방향별 트리거 각도, 키를 누르는 시간, 키를 조정할 수 있습니다.
• 04앞을 보는 위치를 자동으로 조정하며, 기준점이 계속 이동하지 않도록 조정 범위를 제한합니다.
• 05카메라를 사용하거나 Mac 밖으로 데이터를 전송하지 않고 메뉴 막대에서 실행됩니다.

활용 사례

• 누군가와 이야기하려고 고개를 돌리면 화면을 자동으로 흐리게 할 수 있습니다.
• 책상에서 일하다 자세가 구부정해지면 알림을 받을 수 있습니다.
• 손을 쓰지 않고 머리를 기울여 푸시 투 토크 음성 입력을 시작하고 멈출 수 있습니다.
• 손이 바쁠 때 머리 제스처로 키를 입력할 수 있습니다.

빠른 시작

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은(는) 무엇인가요?

AirPods 머리 추적 기능으로 화면을 흐리게 하고, 알림을 띄우며, 머리 움직임에 따라 키를 입력하는 macOS 메뉴 막대 앱입니다. 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