Skip to content
commmePublic

About

맥 메뉴바 비서 앱 Kit — 캡처·녹화·녹음·통역·번역을 오프라인으로

Resources

Stars

13 stars

Watchers

0 watching

Forks

Repository files navigation

Kit — 개인용 맥 도구 모음

맥 메뉴바에 사는 작은 도구 모음 앱입니다. 캡처·녹화·녹음·글자변환·통역·번역을 한 곳에서 해결합니다. 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        # 더블클릭으로 앱 켜기

설치 & 실행 — 더블클릭 한 번이면 끝

  1. 이 페이지 위쪽 Code → Download ZIP 을 눌러 내려받고, 압축을 풉니다.
  2. 풀린 폴더 안의 실행.command 를 더블클릭합니다.
    • 처음 열 때 "확인되지 않은 개발자" 경고가 뜨면: 파일을 우클릭(또는 Ctrl+클릭) → 열기 → 열기. (macOS 15 이상은 시스템 설정 → 개인정보 보호 및 보안 맨 아래 → 그대로 열기)
  3. 처음 한 번은 파이썬 환경과 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 체크섬으로 무결성을 확인합니다.

About

맥 메뉴바 비서 앱 Kit — 캡처·녹화·녹음·통역·번역을 오프라인으로

Resources

Stars

13 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages