설치와 권한

Keebye는 Apple Silicon Mac용으로는 서명과 공증을 마친 DMG로, 64-bit Windows 10 및 11용으로는 설치 파일(.exe 또는 .msi)로 배포됩니다. 이 문서는 컴퓨터에 필요한 것과 각 권한의 역할을 정리합니다.

요구 사항

• Mac: macOS 11.0 이상.
• Mac: Apple Silicon Mac. Mac 릴리스는 arm64 전용으로 빌드됩니다.
• Windows: 64-bit (x64) PC의 Windows 10 또는 11.
• 기본 음성 모델을 위한 여유 공간: 디스크에 약 670 MB, 다운로드는 한 번뿐입니다.

Windows에 설치하기

Keebye_<version>_x64-setup.exe를 실행하세요. MSI 패키지로 소프트웨어를 설치한다면 .msi를 쓰면 됩니다. 그러면 Keebye가 시스템 트레이에서 시작되고 Mac과 같은 온보딩 창을 엽니다.

온보딩 창

"Welcome to Keebye" 창에는 다섯 단계가 표시됩니다. "Finish unlocks once the model is downloaded and both permissions are granted."(모델 다운로드가 끝나고 두 권한이 모두 허용되면 Finish가 활성화됩니다.) Windows에서는 두 권한 단계가 모두 허용됨으로 표시되므로 Finish는 모델만 기다립니다. 업데이트 이후처럼 권한이 사라진 경우에는 같은 창이 복구 화면으로 다시 열립니다.

1. 1

   음성 모델 다운로드 — 약 670 MB, 한 번만. 아래 단계를 진행하는 동안 실행됩니다.

2. 2

   마이크 접근 — "Grant microphone access"를 누릅니다.

3. 3

   손쉬운 사용 접근 — Mac에서 "Open System Settings"를 누르고 Keebye를 켭니다.

4. 4

   푸시 투 토크 키 고르기 — Fn / Globe, 왼쪽 ⌘, 오른쪽 ⌘, 왼쪽 ⌥, 오른쪽 ⌥(Windows에서 대응하는 키는 "Keebye 시작하기"에 정리되어 있습니다).

5. 5

   시험해 보기 — 핫키를 누른 채 테스트 필드에 말해 봅니다.

마이크

Mac에서는 macOS가 이렇게 묻습니다: "Keebye listens to your microphone only while you hold your dictation hotkey, to turn your speech into text."(말을 텍스트로 바꾸기 위해 받아쓰기 핫키를 누르고 있는 동안에만 마이크를 사용합니다.) Keebye는 온보딩 2단계에서 이 권한을 요청합니다. Windows에서는 Keebye가 따로 묻지 않으며, 녹음이 시작될 때 Windows가 마이크 접근을 허용합니다.

손쉬운 사용(Mac)

Mac에서는 손쉬운 사용 권한이 있으면 Keebye가 핫키를 감지하고 어떤 앱에든 텍스트를 붙여넣을 수 있습니다. Keebye는 허용 여부를 1.5초마다 확인하고, 허용된 뒤에는 2초마다 핫키를 다시 등록하므로 재시작할 필요가 없습니다. Windows에는 이에 해당하는 권한이 필요 없습니다.

음성 인식(Mac)

Mac에서 "Native (Apple Speech)" 엔진을 선택할 때만 요청합니다. macOS에는 이렇게 표시됩니다: "Keebye uses on-device speech recognition to turn your dictation into text. Audio stays on your Mac."(온디바이스 음성 인식으로 받아쓰기를 텍스트로 바꿉니다. 오디오는 여러분의 Mac에 머무릅니다.) 허용되기 전까지 필에는 "Speech Recognition permission needed — enable Keebye under System Settings › Privacy & Security › Speech Recognition"이 표시됩니다.

업데이트

릴리스 빌드를 실행할 때마다 Keebye는 github.com/aiescu/keebye-releases에서 새 버전을 확인합니다. 새 버전이 있으면 다운로드해 조용히 설치하고 앱을 다시 시작합니다. 확인 창도, 이를 위한 메뉴 항목도 없습니다. 현재 업데이트 피드에는 Mac 빌드만 있으므로, Windows에서는 keebye.com에서 새 설치 파일을 내려받아 업데이트합니다.

모델이 저장되는 위치

모델은 Mac에서는 ~/Library/Application Support/com.keebye.app/models/, Windows에서는 %APPDATA%\com.keebye.app\models\에 있습니다. 다운로드는 이어받을 수 있고 SHA-256으로 검증하며 최대 다섯 번까지 다시 시도합니다. 자동으로 다운로드되는 것은 기본 모델뿐이고, 다른 엔진은 설정에서 "Download model"을 누를 때 다운로드됩니다.

• parakeet-v3 — 약 670 MB(설정에는 ~640 MB로 표시). 기본 모델입니다.
• parakeet-v3-fp32 — 약 2.55 GB(설정에는 ~2.4 GB로 표시).
• canary-v2 — 약 1.03 GB(설정에는 ~1 GB로 표시).
• llm/Qwen_Qwen3-1.7B-Q4_K_M.gguf — 약 1.28 GB. 선택형이며 로컬 LLM 다듬기에만 쓰입니다.