맥 메뉴바에 사는 작은 도구 모음 앱입니다. 캡처·녹화·녹음·글자변환·통역·번역을 한 곳에서 해결합니다. AI 기능(음성인식·번역)은 인터넷·API 키 없이 컴퓨터 안에서 동작해요.
⚠️ macOS 전용 (Apple Silicon·Intel 모두 설치 가능). 현재 Windows·Linux는 지원하지 않습니다. → 지원 환경
📖 사용자 매뉴얼 보기 — 설치부터 기능별 사용법, 문제 해결까지
| 카테고리 | 기능 |
|---|---|
| 🎪 플로팅 팔레트 | 항상 위에 떠있는 메뉴 팔레트, 귀여운 3D 토끼 아이콘 |
| 📸 캡처 | 영역/전체/창 캡처, 캡처 후 편집(자르기·모자이크·화살표·박스·펜·글자), 폴더 열기 |
| 🎬 녹화·녹음 | 화면 녹화(화면+마이크), 음성 녹음, 녹음 → 글자(텍스트) 변환 |
| 🗣️ 통역·번역 | 통역(말→번역), 실시간 통역 창, 글 번역(한·영·일·중) |
| 🌐 웹 도구 | 자주 쓰는 웹 도구 바로가기 |
| 🧹 청소 | 바탕화면 파일 종류별 자동 정리 |
| ⚙️ 설정 | 로그인 시 자동 시작, 저장 폴더 변경 |
kit/
├─ app.py # 메뉴바 앱 본체
├─ palette.py # 플로팅 팔레트 윈도우 (PySide6)
├─ editor.py # 캡처 편집창 (PySide6)
├─ live_interpret.py # 실시간 통역 창 (PySide6)
├─ features/ # 기능별 모듈
│ ├─ capture.py # 캡처
│ ├─ cleanup.py # 바탕화면 청소
│ ├─ record.py # 화면 녹화
│ ├─ audio.py # 음성 녹음
│ ├─ denoise.py # 잡음 제거 (RNNoise)
│ ├─ transcribe.py # 음성 → 글자 (Whisper)
│ ├─ translate.py # 번역 (Argos, 오프라인)
│ ├─ config.py # 설정 저장 (저장 폴더 등)
│ └─ autostart.py # 로그인 시 자동 시작
├─ assets/ # 메뉴바 아이콘, 토끼 애니메이션
├─ docs/ # 사용자 매뉴얼 (GitHub Pages)
├─ bin/ffmpeg # 녹음 변환/잡음제거용 (download_assets.sh 로 받음)
├─ models/ # AI 모델·잡음제거 모델 (download_assets.sh 로 받음)
├─ scripts/
│ └─ download_assets.sh
├─ requirements.txt
└─ 실행.command # 더블클릭으로 앱 켜기
- 이 페이지 위쪽
Code→Download ZIP을 눌러 내려받고, 압축을 풉니다. - 풀린 폴더 안의
실행.command를 더블클릭합니다.- 처음 열 때 "확인되지 않은 개발자" 경고가 뜨면: 파일을 우클릭(또는 Ctrl+클릭) → 열기 → 열기. (macOS 15 이상은 시스템 설정 → 개인정보 보호 및 보안 맨 아래 → 그대로 열기)
- 처음 한 번은 파이썬 환경과 AI 모델(약 1GB)을 자동으로 설치합니다 — 인터넷 속도에 따라 몇 분에서 수십 분 걸려요. 끝나면 메뉴바(화면 맨 위)에 Kit 아이콘이 나타납니다.
다음부터는 더블클릭하면 바로 켜집니다. 끄려면: 메뉴 → 종료.
터미널로 설치하고 싶다면 (개발자용)
git clone https://github.com/commme/kit.git
cd kit
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
bash scripts/download_assets.sh # ffmpeg + AI 모델 다운로드
./실행.command- 캡처/화면 녹화: 캡처나 녹화를 한 번 시도한 뒤 → 시스템 설정 → 개인정보 보호 및 보안 → 화면 및 시스템 오디오 기록 목록에 나타난 항목(터미널 또는 Python)을 켜고, 앱을 재시작하세요.
- 녹음/통역: 첫 사용 시 마이크 권한 허용
- ✅ macOS 11(빅서) 이상 — Apple Silicon·Intel 모두.
- Apple Silicon에서 개발·테스트했습니다. Intel 맥은 설치 스크립트가 자동으로 Intel용 ffmpeg와 맥 버전에 맞는 화면 라이브러리(PySide6)를 골라 설치해요.
- 파이썬 3.9 이상 필요 — 낮으면 실행할 때 안내 메시지가 떠요.
- 실제 Intel 기기에서 전체 기능을 검증하진 못했으니, 오류가 나면 이슈로 알려주세요.
- 2013년 이전의 아주 오래된 Intel 기종은 음성인식·번역 엔진(ctranslate2)이 필요로 하는 CPU 명령어(AVX)가 없어 안 될 수 있습니다.
- ❌ Windows / Linux: 현재 미지원.
- 메뉴바·화면캡처·녹화·녹음 등이 macOS 전용 기술(rumps, screencapture, avfoundation 등)에 의존합니다.
- 음성인식(faster-whisper)·번역(ctranslate2)·이미지편집(Pillow) 로직은 크로스플랫폼이라, 윈도우판은 UI·캡처 계층만 새로 구현하면 가능합니다. (향후 과제)
- 번역 품질: 한↔영 좋음 · 한↔일 양호 · 한↔중 보통 (무료·오프라인 한계)
- 실시간 통역은 "완전 동시통역"이 아니라 몇 초 따라오는 거의 실시간입니다.
- Python 3.9 이상에서 개발·테스트했습니다.
- 모든 처리는 컴퓨터 안에서만 이뤄집니다. 녹음·캡처·번역 내용이 외부로 전송되지 않고, API 키·계정도 필요 없습니다.
- 인터넷 연결은 최초 설치 때 한 번(
download_assets.sh로 ffmpeg·AI 모델 다운로드)만 사용합니다. ffmpeg와 잡음제거 모델은 SHA256 체크섬으로 무결성을 확인합니다.