telegram-streamer

Assista seus videos do Telegram diretamente no navegador

Funcionalidades

• Streaming direto — videos sao reproduzidos do Telegram sem download, com suporte a Range requests (seek/progressivo)
• Pre-carregamento — primeiros 2MB sao baixados ao passar o mouse, acelerando o playback
• Thumbnails — miniaturas geradas automaticamente dos videos
• Canais — suporta multiplos canais, incluindo links de convite (t.me/+hash)
• Tag groups — organize videos em grupos com nome (ex: “Iniciando com Next.js”, “App Router”)
• Filtros — filtre por grupo, por tag individual, ou busque por titulo
• Sessao compartilhada — reutiliza a sessao do Telegram-Downloader-Tools
• 2FA — suporte completo a autenticacao em duas etapas
• Cache — videos sao cacheados por 5 minutos, eliminando escaneamentos repetidos
• Retomar playback — lembra onde voce parou de assistir e retoma automaticamente
• Responsivo — layout adaptavel para desktop, tablet e mobile

Stack

• Backend: Python 3.14, FastAPI, Telethon, Uvicorn
• Frontend: HTML/CSS/JS vanilla (sem framework)
• Tema: Netflix dark

Instalacao

# Clonar o repositorio
git clone https://github.com/vinicius-dsr/telegram-streamer.git
cd telegram-streamer

# Criar e ativar venv
python3 -m venv .venv
source .venv/bin/activate

# Instalar dependencias
pip install -r requirements.txt

# Executar
python main.py

O servidor inicia em http://0.0.0.0:8000.

Configuracao

Na primeira execucao, voce precisara:

1. Obter API ID e API Hash em my.telegram.org
2. Informar seu numero de telefone
3. Inserir o codigo de verificacao recebido pelo Telegram

Os dados sao salvos em config.json.

Canais

Adicione canais pela tela de Configuracoes:

• Link direto: https://t.me/nome_do_canal
• Link de convite: https://t.me/+hash_do_convite
• Username: @nome_do_canal

Tags e Grupos

Formato de entrada (aceita espacos ou virgulas):

#F01 #F02 #F03 #F04

Grupos permitem organizar videos por secao com titulo, exibidos como dropdowns na tela principal.

Demonstração

Assista a um exemplo de uso abaixo. O video foi gravado durante uma sessão real de streaming.

▶ Clique aqui para assistir ao video demo

Estrutura

Telegram-Streamer/
├── main.py                 # Entrada do FastAPI
├── core/
│   ├── config_manager.py   # Gerenciamento de config.json
│   ├── telegram_client.py  # Wrapper do Telethon
│   └── video_service.py    # Logica de videos, streaming e cache
├── routes/
│   ├── api.py              # Endpoints REST
│   └── auth.py             # Endpoints de autenticacao
├── static/
│   ├── css/style.css       # Tema Netflix dark
│   └── js/
│       ├── api.js          # Cliente HTTP
│       ├── app.js          # Logica frontend
│       └── player.js       # Player de video
└── templates/
    └── index.html          # SPA principal

API

Endpoint	Metodo	Descricao
/api/auth/status	GET	Status da conexao
/api/auth/login	POST	Login com API ID/Hash
/api/auth/code	POST	Verificar codigo
/api/auth/2fa	POST	Verificar 2FA
/api/auth/reuse	POST	Reusar sessao do Downloader
/api/channels	GET	Listar canais
/api/channel	POST	Adicionar canal
/api/channel/{id}	PUT	Editar canal
/api/channel/{id}	DELETE	Remover canal
/api/videos	GET	Listar videos
/api/video/{id}	GET	Metadata de um video
/api/stream/{id}	GET	Streaming do video
/api/thumbnail/{id}	GET	Thumbnail do video
/api/tags	GET	Listar tags
/api/prefetch/{id}	GET	Pre-baixar inicio do video
/api/progress/{id}	GET	Obter posicao salva
/api/progress/{id}	POST	Salvar posicao atual

Gostou do projeto? Me pague um café