Repolode
McCloudS

McCloudS/subgen

Самостоятельно размещаемый инструмент для создания субтитров SRT или LRC из медиафайлов с помощью OpenAI Whisper, интегрируемый с Bazarr, Plex, Jellyfin, Emby и Tautulli.

Звёзды
1,504
Форки
122
Открытые issues
5
Последний коммит
3 месяца назад

Что это?

Subgen преобразует аудио- и видеофайлы в субтитры формата .srt или .lrc. Он может сохранять исходный язык речи или переводить иностранную речь на английский. Инструмент работает локально на CPU или GPU Nvidia с CUDA, используя stable-ts и faster-whisper.

Subgen помогает заполнить пробелы в медиатеке, где нет субтитров или встроенные субтитры рассинхронизированы. Его можно использовать как провайдер Whisper для Bazarr или настроить на получение вебхуков от Plex, Jellyfin, Emby и Tautulli, чтобы создавать субтитры при добавлении или воспроизведении медиафайлов. Также можно сканировать указанные папки и отслеживать появление в них новых файлов.

Кроме того, Subgen предоставляет совместимые с OpenAI эндпоинты /v1/audio/transcriptions и /v1/audio/translations, поэтому другие клиенты, работающие с Whisper API, могут использовать его в качестве бэкенда. Настройки задаются через переменные окружения, в том числе правила пропуска файлов с учетом уже имеющихся субтитров и аудиодорожек.

Ключевые возможности

  • 01Создаёт субтитры SRT или файлы LRC для аудио без видео.
  • 02Расшифровывает речь на исходном языке или переводит её на английский.
  • 03Работает на CPU или GPU Nvidia с использованием CUDA.
  • 04Интегрируется с Bazarr как провайдер Whisper, а с Plex, Jellyfin, Emby и Tautulli — через вебхуки.
  • 05Сканирует папки и отслеживает их, создавая субтитры для существующих и новых файлов.
  • 06Предоставляет совместимые с OpenAI эндпоинты для транскрибации и перевода.

Сценарии использования

  • Добавление субтитров в домашнюю медиатеку, где их нет.
  • Автоматическое создание субтитров для новых эпизодов при добавлении в Plex или Jellyfin.
  • Развёртывание собственного бэкенда Whisper для Bazarr.
  • Создание субтитров для личных аудио- и видеозаписей через простой HTTP API.

Быстрый старт

  1. 1

    Настройте переменные окружения TRANSCRIBE_DEVICE и WHISPER_MODEL в соответствии с вашим оборудованием

  2. 2

    Запустите Subgen в Docker, используя образ для CPU или CUDA из README

  3. 3

    В Bazarr задайте для Whisper Provider Docker Endpoint значение http://<your-ip>:9000

Что важно знать

  • С видеокартой Nvidia транскрибация выполняется значительно быстрее, а при использовании только CPU — медленно.
  • Поддержка видеокарт AMD (ROCm) не тестировалась и может вообще не работать.
  • Модель large-v3-turbo не поддерживает перевод.

В подборках

Темы

Частые вопросы

Что такое subgen?
Самостоятельно размещаемый инструмент для создания субтитров SRT или LRC из медиафайлов с помощью OpenAI Whisper, интегрируемый с Bazarr, Plex, Jellyfin, Emby и Tautulli. Subgen преобразует аудио- и видеофайлы в субтитры формата .srt или .lrc. Он может сохранять исходный язык речи или переводить иностранную речь на английский. Инструмент работает локально на CPU или GPU Nvidia с CUDA, используя stable-ts и faster-whisper.
subgen можно использовать бесплатно? Какая у него лицензия?
subgen распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
subgen всё ещё поддерживается?
Обновлялся за последние 6 месяцев. Последний коммит в subgen — 7 авг. 2026 г..
Для чего можно использовать subgen?
Добавление субтитров в домашнюю медиатеку, где их нет. Автоматическое создание субтитров для новых эпизодов при добавлении в Plex или Jellyfin. Развёртывание собственного бэкенда Whisper для Bazarr. Создание субтитров для личных аудио- и видеозаписей через простой HTTP API.
Как установить subgen?
Настройте переменные окружения TRANSCRIBE_DEVICE и WHISPER_MODEL в соответствии с вашим оборудованием Запустите Subgen в Docker, используя образ для CPU или CUDA из README В Bazarr задайте для Whisper Provider Docker Endpoint значение http://<your-ip>:9000
Где скачать subgen?
Исходный код и инструкции по установке — на GitHub: https://github.com/McCloudS/subgen

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты

Локальное создание субтитров для любых видео с помощью Whisper: транскрибация, перевод, оформление и встраивание — в браузере, десктопном приложении или CLI, без загрузки видео.

1178TypeScriptAGPL-3.0Обновлён 10 часов назад