Gemini SRT Translator CLI
Gemini SRT Translator, CLI на Python, переводит субтитры SRT и ASS через Gemini с таймкодами и ставит скилл для агентов.
- 362 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Текст субтитров отправляется во внешний сервис Google, нужен личный ключ API.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/gemini-srt-translatorОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Текст субтитров отправляется во внешний сервис Google, нужен личный ключ API.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Команда `gst translate` переводит субтитры SRT и ASS на выбранный язык через Google Gemini, сохраняя таймкоды и разметку. Инструмент умеет вытаскивать субтитры и звук из видео через FFmpeg, продолжать прерванный перевод с нужной строки и учитывать описание задачи вроде терминологии сериала. Отдельные команды `gst transcribe` и `gst extract` расшифровывают аудио и видео в субтитры и извлекают дорожки. Команда `gst skill install` кладет в проект скилл `subtitle-translator`: тогда переводит сам агент, а `gst agent` лишь отдает ему партии строк и собирает ответ без ключа API.
Для кого. Тем, кто переводит субтитры фильмов и сериалов и хочет делать это из терминала или поручить агенту.
Подходит, если
- Серию в SRT нужно перевести на французский с сохранением таймингов.
- Из MKV надо вытащить встроенные субтитры и перевести их.
- Перевод остановился на середине файла, и его продолжают с нужной строки.
- Агент переводит файл сам по партиям, а ключа API под рукой нет.
Не подходит, если
- Нужен перевод обычного текста или документов, а не субтитров.
- Файлы нельзя отправлять во внешний сервис Google.
- Требуется ручная построчная сверка, без которой автоматический перевод не пройдет.
Пример запроса к агенту
Переведи movie.srt на бразильский португальский, сохрани тайминги и учти, что это медицинский сериал.Ограничения
Для `gst translate` нужен ключ API Google AI Studio либо учетные данные Google Cloud: текст субтитров уходит в Gemini. Извлечение дорожек и звука из видео требует установленного FFmpeg. Если приходит много сообщений о перегрузке модели, README советует выключить потоковый режим. Качество перевода зависит от выбранной модели, а имена и жаргон лучше пояснить в описании задачи. Прогресс по строкам сохраняется, поэтому прерванную работу возобновляют.
Как отключить. Удалите скилл из `.agents/skills/subtitle-translator` или из каталога выбранной платформы и деинсталлируйте пакет `pip uninstall gemini-srt-translator`. Ключ из переменной `GEMINI_API_KEY` уберите отдельно.
Частые вопросы
Какие форматы поддерживаются?
Субтитры `.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` перевод делает агент, и ключ не нужен.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыChatGPT Subtitle Translator — CLI для длинных SRT: учитывает предыдущий перевод и продолжает работу после прерывания.
Скилл /watch: по ссылке или файлу достает кадры и субтитры, а при ключе Gemini передает видео целиком Google, чтобы агент отвечал на вопросы по ролику
Скилл расшифровывает видео, дает проверить субтитры в браузере и вшивает китайские и английские субтитры.
CLI и скиллы для кодового агента собирают черновой монтаж из ваших видео и сохраняют проект для дальнейшей правки
Скилл и CLI gwr снимают видимый водяной знак Gemini с локальных изображений и видео и сохраняют очищенные копии в указанную папку
VideoCaptioner расшифровывает речь, переводит субтитры и вшивает их в видео одной командой из Claude Code.
Коротко о README
Пакет работает и как библиотека: достаточно задать `gemini_api_key` в Python и вызвать перевод. Есть второй ключ для увеличения квоты и режим Google Cloud через учетные данные приложения.