============================================
 쇼츠 메이커 (ShortsMaker) — 맥 설치/사용법
============================================

여러 개의 '주저리 영상'을 넣으면,
가장 잘 말한 조각들만 골라 문맥 흐름대로 이어붙인
쇼츠용 FCPXML 을 만들어 줍니다. (파이널컷에서 마무리)

autocut(무음컷)의 형제 앱이라 설치 방법이 거의 같아요.


■ 1단계. Homebrew 설치 (이미 있으면 건너뛰기)
--------------------------------------------
'터미널' 앱을 열고 아래 한 줄 붙여넣고 엔터:

  /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"


■ 2단계. 필요한 프로그램 설치
--------------------------------------------
터미널에 아래를 차례로 붙여넣고 엔터:

  brew install python ffmpeg
  pip3 install --break-system-packages pywebview pyobjc anthropic faster-whisper

  ※ autocut 을 이미 깔았다면 위 패키지가 다 있어서 그냥 실행만 하면 돼요.


■ 3단계. 실행
--------------------------------------------
폴더 안의  "run-mac.command"  파일을 더블클릭.

  ※ 처음엔 "확인되지 않은 개발자" 경고가 뜰 수 있어요.
     그럴 땐 그 파일을 '우클릭 ▸ 열기' 로 한 번만 열면 그 뒤론 더블클릭됩니다.
  ※ "권한이 없다"고 하면 터미널에서 한 번:
        chmod +x run-mac.command


■ 사용법
--------------------------------------------
1) ⚙ 설정에서 Claude API 키 입력 → 저장 (최초 1회)
   (키 발급: console.anthropic.com → API Keys)
2) 주저리 찍은 영상 4~5개를 창에 드래그(또는 클릭해서 선택)
3) (선택) 대본·방향을 적어두면 그 순서·표현 기준으로 맞춰줘요
4) [분석 시작] — 음성인식 + AI 가 베스트 테이크 선별/정렬
   * 첫 실행은 음성인식 모델 다운로드로 몇 분 걸려요 (이후엔 빠름)
5) 검수 화면에서:
   - '최종 쇼츠' 목록의 순서를 ↑↓ 또는 끌어서 조정
   - 마음에 안 드는 컷은 ✕ 로 '버린 컷'으로
   - '버린 컷'에서 다시 쓰고 싶으면 + 넣기
   - 상단 제목 문구도 직접 수정 가능
6) [FCPXML 내보내기] → 저장
7) 파이널컷 ▸ 파일 ▸ 가져오기 ▸ XML… ▸ 저장한 .fcpxml 선택

* 영상이 맥에 있는 상태로 처리하면 파이널컷이 원본을 바로 찾아 들어옵니다.
* 결과물은 '원본 참조'라 화질 손상이 없고, 컷 지점은 파이널컷에서 자유롭게 다듬으면 됩니다.


■ 동작 원리(요약)
--------------------------------------------
- faster-whisper 로 모든 영상의 말을 타임코드와 함께 받아쓰고,
- Claude 가 더듬음·반복·미완성·NG 를 걸러 베스트 테이크만 고른 뒤
  하나의 쇼츠로서 매끄럽게 이어지는 순서로 재배치하고,
- 그 결과를 '여러 원본을 참조하는 멀티소스 FCPXML' 로 만들어요.


■ 윈도우용 파일 안내
--------------------------------------------
"run-win.bat" 은 윈도우 전용입니다(테스트용). 맥에선 무시하세요.
실제 프로그램은  app.py / core.py / brain.py / transcribe.py / ui 폴더  입니다.
