Skip to content
Agentmart
Submit a tool

tvsub MCP

Control tvsub for Apple TV.app: subtitles, glossary-aware translation, overlay, styling, and sync.

Connector by launzi · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)
Write a review

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/launzi-tvsub-mcp

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

Control tvsub for Apple TV.app: subtitles, glossary-aware translation, overlay, styling, and sync.

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools
4 read · 6 write · 2 delete
Secrets
1 (API keys, tokens or passwords)
Install scripts
None found
Runs as
Python package

Tools by what they do 12

Read from the source code; the running server may list different tools.

Read 4 · Look things up without changing anything.

  • list_fonts
  • list_subtitles
  • now_playing
  • status

Write 6 · Create, change, send or run things.

  • calibrate_sync
  • mark_reviewed
  • set_style
  • start_overlay
  • stop_overlay
  • translate_subtitle

Delete 2 · Delete, drop, revoke or wipe things.

  • load_subtitle
  • set_glossary

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

  • ANTHROPIC_API_KEY

Network hosts it talks to 2

  • github.com · found in code
  • youngji.kim · found in code

Files it touches

  • ~/.claude.json
  • /opt/homebrew/bin/codex
  • Your home directory (~)
  • ~/.local/bin/claude
  • ~/.npm-global/bin/codex

Tools (12)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • calibrate_syncCalibrate sync anchor

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

  • list_fontsList installed fontsread-only

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

  • list_subtitlesList subtitle filesread-only

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

  • load_subtitleSelect subtitlecan change or delete data

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

  • mark_reviewedMark reviewed

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

  • now_playingRead current playbackread-only

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

  • set_glossarySet title glossarycan change or delete data

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

  • set_styleSet overlay style

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

  • start_overlayStart overlay

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

  • statusSummarize stateread-only

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

  • stop_overlayStop overlay

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

  • translate_subtitleTranslate subtitle

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

Compare and alternatives

    Featured in

    Signals

    Stars
    0
    Forks
    0
    Open issues
    0
    Weekly downloads
    237
    Last commit
    Oct 22, 2026 (6 days ago)
    Last release
    Oct 22, 2026 (6 days ago)
    Last package publish
    Oct 22, 2026 (6 days ago)

    From GitHub (fetched Oct 24, 2026) and the package registry.

    Details

    Registry name
    io.github.launzi/tvsub-mcp
    Version
    0.3.0
    Auth
    API key
    Packages
    pypi tvsub-mcp
    License
    MIT
    Repository
    github.com/launzi/tvsub-mcp
    Website
    youngji.kim/tvsub
    First seen
    Oct 24, 2026
    Last checked
    Oct 24, 2026
    Source
    Official MCP Registrygithub-graphql
    Cite this page

    tvsub MCP. Agent Mart. https://agentmart.dev/connectors/launzi-tvsub-mcp (last updated 2026-10-24)