# rockbenben/subtitle-translator

> subtitle-translator is a browser-based batch tool for translating subtitle files, including .srt, .ass, .vtt and .lrc files, so a whole season can be translated in one pass. It strips the timing out of each file locally and sends only the dialogue text to the translation engine, so the timeline is never changed. The project is written mainly in TypeScript and built with Next.js.

Source: https://github.com/rockbenben/subtitle-translator
Indexed: commit 7ba3497 on 2026-11-20 by Repowise. Facts come from the source and git history, not from the maintainer.

## Facts

- Type: App
- Language: TypeScript
- Stars: 1,204 at index time
- License: MIT
- Code health: 5.8/10, Fair
- Last commit: 2026-11-17
- Contributors: 9

## How it works

Subtitle files are read in the browser, where the parsers separate timecodes, cue numbers and format headers from the dialogue text. The src/app/lib/translation/registry.ts file belongs to the translation library and is one of the project's hotspot files. The src/app/lib/translation/services/llm.ts file contains the code that sends dialogue to LLM providers, with optional surrounding lines as context. The src/app/hooks/useTranslationState.tsx file is a React hook that holds translation state for the interface, and src/app/[locale]/SubtitleTranslator.tsx is the main page component. The scripts/cli.ts file is the single entry point for running the same engine from a terminal, and the Dockerfile builds a container image for the project.

- scripts/cli.ts: entry point
- .github/workflows/desktop-build.yml: central file
- .github/workflows/docker.yml: central file
- Dockerfile: central file
- README.md: central file
Modules: src, root, scripts. 149 files, 14,165 lines, 929 symbols.

## Code health

- Score: 5.8/10 (Fair)
- Rank: #225 of 4,000+ indexed repos
- Hotspots: src/app/lib/translation/registry.ts, src/app/hooks/useTranslationState.tsx, src/app/lib/translation/services/llm.ts, src/app/[locale]/SubtitleTranslator.tsx, src/app/components/TranslationSettings.tsx
- Lowest file: src/app/lib/translation/pipeline.ts
- Dead code: 7 findings

## Maintenance

- Last commit 2026-11-17, first commit 2025-03-21, 339 commits
- 9 contributors, bus factor 1

## Security

- Security findings are shown to signed-in users at https://repowise.dev/repo/rockbenben/subtitle-translator/security

## More

- Page: https://repowise.dev/repo/rockbenben/subtitle-translator
- Ask this codebase: https://repowise.dev/repo/rockbenben/subtitle-translator/chat
- Docs: https://repowise.dev/repo/rockbenben/subtitle-translator/docs
- MCP (signs in with Repowise on first use):
    claude mcp add --transport http repowise https://api.repowise.dev/mcp/rockbenben/subtitle-translator
