Gemini SRT Translator CLI
Gemini SRT Translator, CLI на Python, переводит субтитры SRT и ASS через Gemini с таймкодами и ставит скилл для агентов.
- 362 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Текст субтитров отправляется во внешний сервис Google, нужен личный ключ API.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add cli/gemini-srt-translatorDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Текст субтитров отправляется во внешний сервис Google, нужен личный ключ API.
This is third-party code. Review the repository files before installing.
What it does
Команда `gst translate` переводит субтитры SRT и ASS на выбранный язык через Google Gemini, сохраняя таймкоды и разметку. Инструмент умеет вытаскивать субтитры и звук из видео через FFmpeg, продолжать прерванный перевод с нужной строки и учитывать описание задачи вроде терминологии сериала. Отдельные команды `gst transcribe` и `gst extract` расшифровывают аудио и видео в субтитры и извлекают дорожки. Команда `gst skill install` кладет в проект скилл `subtitle-translator`: тогда переводит сам агент, а `gst agent` лишь отдает ему партии строк и собирает ответ без ключа API.
Who it is for. Тем, кто переводит субтитры фильмов и сериалов и хочет делать это из терминала или поручить агенту.
Good fit when
- Серию в SRT нужно перевести на французский с сохранением таймингов.
- Из MKV надо вытащить встроенные субтитры и перевести их.
- Перевод остановился на середине файла, и его продолжают с нужной строки.
- Агент переводит файл сам по партиям, а ключа API под рукой нет.
Not a fit when
- Нужен перевод обычного текста или документов, а не субтитров.
- Файлы нельзя отправлять во внешний сервис Google.
- Требуется ручная построчная сверка, без которой автоматический перевод не пройдет.
Example request
Переведи movie.srt на бразильский португальский, сохрани тайминги и учти, что это медицинский сериал.Limitations
Для `gst translate` нужен ключ API Google AI Studio либо учетные данные Google Cloud: текст субтитров уходит в Gemini. Извлечение дорожек и звука из видео требует установленного FFmpeg. Если приходит много сообщений о перегрузке модели, README советует выключить потоковый режим. Качество перевода зависит от выбранной модели, а имена и жаргон лучше пояснить в описании задачи. Прогресс по строкам сохраняется, поэтому прерванную работу возобновляют.
How to disable. Удалите скилл из `.agents/skills/subtitle-translator` или из каталога выбранной платформы и деинсталлируйте пакет `pip uninstall gemini-srt-translator`. Ключ из переменной `GEMINI_API_KEY` уберите отдельно.
FAQ
Какие форматы поддерживаются?
Субтитры `.srt` и `.ass`, а также видео, из которого извлекаются встроенные дорожки через FFmpeg. Результат сохраняет исходный формат.
Как продолжить прерванный перевод?
Запустите ту же команду с флагом `--start-line` и номером строки. Например, `gst translate -i subtitle.srt -l French --start-line 20`.
На какие платформы ставится скилл?
`gst skill install --target` принимает `agents`, `antigravity`, `claude`, `codex` или `all`. Флаг `--global` кладет скилл в домашний каталог.
Можно ли расшифровать видео в субтитры?
Да. `gst transcribe -v video.mp4` создает SRT рядом с файлом. Для аудио используйте флаг `-a`.
Нужен ли ключ API?
Для `gst translate` нужен. Ключ задают переменной `GEMINI_API_KEY`, флагом `-k` или вводят по запросу. В режиме `gst agent` перевод делает агент, и ключ не нужен.
Discussion
No questions or reviews yet.
Related
CLI toolsChatGPT Subtitle Translator is a CLI for long SRT files, retaining earlier dialogue context and resuming interrupted work.
The /watch skill turns a link or file into frames and captions, or with a Gemini key hands the whole video to Google for the agent to answer from
A skill that transcribes video, lets you review captions in a browser and burns in Chinese and English captions.
A CLI and coding-agent skills assemble rough cuts from your footage and save editable projects for further review
A skill and the gwr CLI remove Gemini's visible watermark from local images and videos and save cleaned copies to a folder you choose
VideoCaptioner transcribes speech, translates subtitles and burns them into video with a single command from Claude Code.
README in short
Пакет работает и как библиотека: достаточно задать `gemini_api_key` в Python и вызвать перевод. Есть второй ключ для увеличения квоты и режим Google Cloud через учетные данные приложения.