Repolode
EgalitarianMonkey

EgalitarianMonkey/hometube

Interface web em Streamlit baseada no yt-dlp para baixar vídeos avulsos ou playlists e organizá-los em pastas que o Plex, o Jellyfin ou o Emby possam indexar.

Alternativa open source a:4K Video Downloader

Estrelas
1,526
Forks
100
Issues abertas
6
Último commit
ontem

O que é?

O HomeTube é um app web auto-hospedado para baixar vídeos do YouTube e de outros sites compatíveis com o yt-dlp e, em seguida, mover os arquivos prontos para pastas monitoradas por um servidor de mídia como Plex, Jellyfin ou Emby. Basta colar uma URL e escolher uma pasta de destino: o app cuida da seleção do formato, da nomeação e da organização dos arquivos. Também é possível criar novas pastas de destino pela interface.

Os downloads selecionam os melhores formatos de vídeo e áudio disponíveis, com a opção de usar um segundo perfil como alternativa ou escolher um formato manualmente. A integração com SponsorBlock pode marcar ou pular trechos de patrocínio no YouTube. As playlists são acompanhadas pelo ID do vídeo, permitindo sincronizar reordenações, renomeações e itens removidos com uma pasta local. Se quiser, os vídeos removidos podem ser movidos para uma pasta de arquivo em vez de excluídos.

O HomeTube pode ser executado em um container Docker ou instalado localmente com Python, e é configurado por variáveis de ambiente. Oferece autenticação pelo navegador ou por arquivo de cookies para conteúdo restrito, argumentos personalizados do yt-dlp, corte opcional de clipes, incorporação de legendas e conversão de formatos, além de atualizar a biblioteca do Jellyfin após cada download.

Recursos principais

  • 01Baixa vídeos avulsos e playlists de sites compatíveis com o yt-dlp, selecionando os formatos de melhor qualidade
  • 02Move os arquivos concluídos para pastas que o Plex, o Jellyfin ou o Emby possam indexar, com nomeação automática
  • 03Integra o SponsorBlock para marcar ou pular trechos de patrocínio no YouTube
  • 04Sincroniza playlists pelo ID do vídeo, detecta renomeações e permite arquivar itens removidos
  • 05Oferece autenticação pelo navegador ou por arquivo de cookies e aceita argumentos personalizados do yt-dlp
  • 06Permite cortar clipes, incorporar legendas e converter formatos

Casos de uso

  • Montar uma biblioteca de vídeos offline e sem anúncios em um servidor de mídia doméstico
  • Manter uma cópia local de uma playlist do YouTube sincronizada com a original
  • Baixar vídeos educativos ou tutoriais e organizá-los em pastas para a família assistir
  • Executar um downloader auto-hospedado compartilhado em um homelab com Docker

Início rápido

  1. 1

    Leia o guia de implantação e faça a implantação com Docker Compose

Antes de usar

  • Licenciado sob AGPL-3.0, uma licença copyleft que exige que obras derivadas sejam compartilhadas nos mesmos termos.
  • Para que os downloads sejam confiáveis, é necessário configurar a autenticação por cookies, algo que o README recomenda fortemente.
  • O README é voltado para hospedagem própria, então você precisa manter seu próprio servidor, geralmente com Docker.

Tópicos

Perguntas frequentes

O que é hometube?
Interface web em Streamlit baseada no yt-dlp para baixar vídeos avulsos ou playlists e organizá-los em pastas que o Plex, o Jellyfin ou o Emby possam indexar. O HomeTube é um app web auto-hospedado para baixar vídeos do YouTube e de outros sites compatíveis com o yt-dlp e, em seguida, mover os arquivos prontos para pastas monitoradas por um servidor de mídia como Plex, Jellyfin ou Emby. Basta colar uma URL e escolher uma pasta de destino: o app cuida da seleção do formato, da nomeação e da organização dos arquivos. Também é possível criar novas pastas de destino pela interface.
hometube é gratuito? Qual é a licença?
hometube é open source sob a licença AGPL-3.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
hometube ainda é mantido?
Manutenção ativa. O último commit de hometube foi em 19 de out. de 2026.
Para que posso usar hometube?
Montar uma biblioteca de vídeos offline e sem anúncios em um servidor de mídia doméstico Manter uma cópia local de uma playlist do YouTube sincronizada com a original Baixar vídeos educativos ou tutoriais e organizá-los em pastas para a família assistir Executar um downloader auto-hospedado compartilhado em um homelab com Docker
Como instalar hometube?
Leia o guia de implantação e faça a implantação com Docker Compose
Onde consigo hometube?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/EgalitarianMonkey/hometube

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

Projetos relacionados