MediaRemote/JXA와 TV.app AppleScript 교차 검증으로 현재 제목, 콘텐츠 ID, 위치와 재생 상태를 조회합니다.

tvsub subtitles/ 라이브러리의 SRT/SMI/VTT 파일과 파싱 정보를 나열합니다.

콘텐츠에 사용할 자막을 선택합니다. 기존 싱크 앵커는 기본적으로 보존합니다.

Anthropic API, Claude 구독(Claude Code CLI), ChatGPT 구독(Codex CLI) 중 선택해 자막을 번역합니다. backend는 auto/api/claude/codex이며 타임코드·큐 수 검증, 캐시, provenance를 공통 적용합니다.

작품 자막 옆 <작품>.glossary.json을 생성·수정합니다.

번역 SRT의 provenance 상태를 user_reviewed로 갱신합니다.

tvsub NSPanel 오버레이를 선택 자막·스타일로 시작합니다. bottom_margin은 TV 영상 창 높이 기준이며 창을 찾지 못할 때만 설정 화면 기준으로 폴백합니다.

이 MCP 서버가 시작한 tvsub 오버레이 프로세스를 정상 종료합니다.

macOS CoreText 설치 폰트를 열거하고 목표 언어 샘플 글리프 지원 여부를 확인합니다.

폰트·크기·색·외곽선·TV 영상 창 하단 위치를 저장하고 실행 중 오버레이에 즉시 반영합니다. outline_width는 pt가 아니라 폰트 크기 대비 퍼센트입니다(5 = 5%). 4~7이 실용 범위이고, 10을 넘기면 글자 속까지 외곽선 색으로 덮여 읽기 어려워집니다. bottom_margin은 TV 영상 창 높이 대비 비율(0.075 = 7.5%)이며 창 취득 실패 때만 화면 기준입니다.

현재 대사와 일시정지 위치로 영화별 싱크 앵커를 기록하고 2점 scale+offset을 계산합니다. 권장 경로는 spoken_text(지금 들린 대사 일부)입니다. ⚠ subtitle_time은 자막 파일 원본 시각이며, tvsub CLI의 anchor --raw-sub-time과 같은 의미입니다. 화면에 보인 시각(보정 적용 후)을 넣는 anchor --sub-time과 다르므로, 이미 offset이 걸린 상태에서 화면 시각을 넣으면 앵커가 offset만큼 틀어집니다.

오버레이, 재생 항목, 선택 자막, 싱크 보정, 스타일과 창 기준 위치 추적 계약을 한 번에 요약합니다.