Repolode
Enviar
McCloudS

McCloudS/subgen

Ferramenta auto-hospedada que gera legendas SRT ou LRC a partir de arquivos de mídia com o OpenAI Whisper, integrada ao Bazarr, Plex, Jellyfin, Emby e Tautulli.

Ver no GitHub
Estrelas
1,504
Forks
122
Issues abertas
5
Último commit
há 3 meses

O que é?

O Subgen transcreve arquivos de áudio e vídeo em legendas .srt ou .lrc. Ele pode manter o idioma falado original ou traduzir falas em outros idiomas para o inglês. Roda localmente na CPU ou em GPUs Nvidia (CUDA), usando stable-ts e faster-whisper nos bastidores.

Ele foi desenvolvido para preencher lacunas em bibliotecas de mídia que não têm legendas ou cujas legendas embutidas estão fora de sincronia. O Subgen pode atuar como provedor Whisper para o Bazarr ou receber webhooks do Plex, Jellyfin, Emby e Tautulli para gerar legendas quando uma mídia é adicionada ou reproduzida. Também pode analisar pastas configuradas e monitorá-las em busca de novos arquivos.

Ele também disponibiliza os endpoints compatíveis com a OpenAI /v1/audio/transcriptions e /v1/audio/translations, permitindo que outros clientes compatíveis com a API do Whisper o usem como backend. As configurações são controladas por variáveis de ambiente, incluindo regras para ignorar arquivos com base nas legendas e faixas de áudio existentes.

Recursos principais

  • 01Gera legendas SRT ou arquivos LRC para áudio sem vídeo.
  • 02Transcreve no idioma original ou traduz as falas para o inglês.
  • 03Roda na CPU ou em GPUs Nvidia via CUDA.
  • 04Integra-se ao Bazarr como provedor Whisper e ao Plex, Jellyfin, Emby e Tautulli por meio de webhooks.
  • 05Analisa e monitora pastas para gerar legendas para arquivos existentes ou novos.
  • 06Disponibiliza endpoints compatíveis com a OpenAI para transcrição e tradução.

Casos de uso

  • Adicionar legendas a uma biblioteca de mídia doméstica que não tem nenhuma.
  • Gerar legendas automaticamente para novos episódios adicionados ao Plex ou Jellyfin.
  • Disponibilizar um backend Whisper auto-hospedado para o Bazarr.
  • Gerar legendas para gravações pessoais de áudio ou vídeo por meio de uma API HTTP simples.

Início rápido

  1. 1

    Defina as variáveis de ambiente TRANSCRIBE_DEVICE e WHISPER_MODEL de acordo com seu hardware

  2. 2

    Execute o Subgen no Docker usando a imagem para CPU ou CUDA indicada no README

  3. 3

    No Bazarr, defina Whisper Provider Docker Endpoint como http://<your-ip>:9000

Antes de usar

  • A transcrição é muito mais rápida com uma GPU Nvidia, enquanto a execução apenas com CPU é lenta.
  • O suporte a GPU AMD (ROCm) não foi testado e pode não funcionar de forma alguma.
  • O modelo large-v3-turbo não oferece suporte à tradução.

Em coleções

Apps auto-hospedadosFerramentas de vídeo e áudio com IA

Tópicos

#whisper#subtitles#transcription#speech-to-text#self-hosted#plex#jellyfin#bazarr

Perguntas frequentes

O que é subgen?
Ferramenta auto-hospedada que gera legendas SRT ou LRC a partir de arquivos de mídia com o OpenAI Whisper, integrada ao Bazarr, Plex, Jellyfin, Emby e Tautulli. O Subgen transcreve arquivos de áudio e vídeo em legendas .srt ou .lrc. Ele pode manter o idioma falado original ou traduzir falas em outros idiomas para o inglês. Roda localmente na CPU ou em GPUs Nvidia (CUDA), usando stable-ts e faster-whisper nos bastidores.
subgen é gratuito? Qual é a licença?
subgen é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
subgen ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de subgen foi em 7 de ago. de 2026.
Para que posso usar subgen?
Adicionar legendas a uma biblioteca de mídia doméstica que não tem nenhuma. Gerar legendas automaticamente para novos episódios adicionados ao Plex ou Jellyfin. Disponibilizar um backend Whisper auto-hospedado para o Bazarr. Gerar legendas para gravações pessoais de áudio ou vídeo por meio de uma API HTTP simples.
Como instalar subgen?
Defina as variáveis de ambiente TRANSCRIBE_DEVICE e WHISPER_MODEL de acordo com seu hardware Execute o Subgen no Docker usando a imagem para CPU ou CUDA indicada no README No Bazarr, defina Whisper Provider Docker Endpoint como http://<your-ip>:9000
Onde consigo subgen?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/McCloudS/subgen

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados