🇧🇷 Português | 🇺🇸 English
Transform your Google Drive into a high-performance, serverless personal streaming service with 100% Jellyfin client compatibility.
🌐 Website e Documentação Oficial: driveflin.org
🌐 Site e Documentação Completa: https://driveflin.org
🔑 Gerador Automático de Conexão Google Drive: https://generator.driveflin.org
📖 Guia Visual de Deploy: https://driveflin.org/deploy.php
DriveFlin é uma implementação completa e serverless do backend do Jellyfin, projetada para rodar nativamente sobre a infraestrutura global da Cloudflare (Workers + D1 SQL + Assets) consumindo arquivos de mídia diretamente do Google Drive (Pessoal ou Shared/Team Drives).
Com o DriveFlin, você tem todos os recursos do ecossistema Jellyfin — interface web moderna com tema Netflix (JellyFlix), busca inteligente de filmes e séries, metadados automáticos do TMDB, suporte a legendas e dual áudio, transmissão para Chromecast e recuperação de backups — com custo zero de servidor e alta disponibilidade mundial.
O repositório foi organizado de forma limpa, direta e padronizada para deploy imediato na Cloudflare Workers:
DriveFlin/ (Raiz do repositório)
├── src/
│ ├── index.ts (Worker Hono: rotas do Jellyfin API e streaming)
│ ├── gdrive.ts (Integração Google Drive API v3 com paginação)
│ ├── sync.ts (Sincronização de bibliotecas direta no D1)
│ ├── tmdb.ts (Busca de metadados, sinopses e capas TMDB)
│ ├── backup.ts (Rotinas de backup e restauração dupla)
│ ├── inject.ts (Injeção de scripts e customizações na Web UI)
│ └── oauth_page.ts (Página interna de autenticação OAuth)
├── public/ (Interface Web oficial do Jellyfin pronta para o Worker)
├── wrangler.toml (Configuração D1, Cron Triggers e Worker na raiz)
├── package.json (Dependências e scripts do Worker na raiz)
├── tsconfig.json (Configuração TypeScript para Workers)
├── schema.sql (Esquema do banco D1 com usuário padrão admin/admin)
├── README.md (Documentação completa e guia de instalação em Português)
├── README-en.md (Documentação e guia de instalação em Inglês)
└── LICENSE (Licença MIT)
- ⚡ 100% Serverless & Custo Zero: Não requer VPS, servidor dedicado nem Docker ligado 24/7. Executa no plano gratuito da Cloudflare.
- 📂 Integração Nativa com Google Drive: Streaming direto de arquivos
.mp4,.mkv,.avi,.mp3e.flac. - 🗂️ Navegação de Pastas no Painel: Ao criar ou editar uma biblioteca, navegue pelas pastas do Google Drive diretamente na janela do Jellyfin.
- 🎬 Metadados & Capas via TMDB: Identificação automática de títulos, sinopse, ano, classificação indicativa e busca remota com 1 clique.
- 👥 Agrupamento Automático de Versões: Múltiplos arquivos com o mesmo nome na biblioteca são unificados em um único cartaz com seleção de fontes de mídia (MediaSources).
- 💾 Sistema Duplo de Backup & Restauração:
- Exportação em 1 clique de todas as tabelas (Bibliotecas, Itens, Progresso e Configurações).
- Salva os backups na pasta
DriveFlin_Backupsdo seu Google Drive e na tabela interna do Cloudflare D1. - Restauração instantânea para fácil migração.
- 🎨 Interface Netflix Premium (JellyFlix): Jellyfin Web oficial pré-configurado com tema escuro estilo Netflix, fontes modernas e cartazes em alta definição.
- 📺 Transmissão para Chromecast & Smart TVs: Compatível com o app oficial do Jellyfin para Google Cast (
F007D354), suporte a206 Partial Content, cabeçalhosRangee CORS aberto. - 🔐 Descriptografia de Nomes via Rclone-Crypt: Suporte a nomes de arquivos ofuscados ou criptografados via Rclone no Google Drive.
- ⏰ Tarefas Agendadas Automáticas (Cron Trigger): Sincronização periódica a cada hora (
0 * * * *) para indexar novos arquivos adicionados ao Google Drive. - 🔑 Gerador de Conexão Google Drive Embutido: Obtenha seu Refresh Token de forma 100% segura e privada pelo generator.driveflin.org.
flowchart TD
User["👤 Usuário (Navegador / App / Chromecast)"]
subgraph Cloudflare["☁️ Cloudflare Edge Network"]
Worker["⚡ DriveFlin Worker (Hono Framework)"]
D1[("🗄️ Cloudflare D1 (SQLite Database)")]
Assets["📦 Jellyfin Web Frontend (Static Assets)"]
Cron["⏰ Cron Trigger (1h)"]
end
subgraph External["🌐 Serviços Externos"]
GDrive["📁 Google Drive API v3"]
TMDB["🎬 The Movie Database (TMDB API)"]
end
User -->|HTTP / HTTPS| Worker
User -->|Acessa Web UI| Assets
Cron -->|Dispara Sincronização| Worker
Worker <-->|Consulta & Grava Metadados| D1
Worker <-->|Streaming & Leitura de Pastas| GDrive
Worker <-->|Posters & Sinopses| TMDB
A instalação é 100% visual pelo navegador, sem necessidade de instalar ferramentas locais nem usar terminal.
Important
Por que fazer o Fork no GitHub é indispensável na fase Beta:
Como o DriveFlin é um projeto ativo e em evolução contínua, fazer o Fork mantém o seu repositório diretamente conectado ao projeto principal. Sempre que novas funcionalidades ou correções forem lançadas, basta você clicar no botão "Sync fork" no GitHub — e a Cloudflare atualizará o seu streaming automaticamente em segundos!
- No canto superior direito desta página no GitHub, clique no botão Fork.
- Selecione a sua conta pessoal e clique em Create fork.
- Pronto! Você agora tem a sua própria cópia do DriveFlin vinculada para atualizações futuras.
Note
O banco de dados serverless D1 guarda suas bibliotecas, metadados e histórico. Ele deve ser criado na sua conta da Cloudflare antes do primeiro deploy para que a compilação inicial encontre o banco.
- Acesse o painel da Cloudflare: dash.cloudflare.com.
- No menu lateral esquerdo, vá em Storage & Databases (Armazenamento e bancos de dados) > D1 SQL Database.
- Clique em Create database (Criar banco de dados).
- Em Database name, digite exatamente:
jellyfin_db_prod - Clique em Create.
Tip
Auto-Inicialização 100% Embutida:
Você NÃO precisa rodar SQL, comandos ou colar scripts! O próprio DriveFlin detecta o banco novo e cria todas as tabelas, índices e o usuário administrador padrão (admin / admin) automaticamente na primeira vez que você abrir o site.
- No menu lateral esquerdo da Cloudflare, vá em Workers & Pages.
- Clique no botão azul Create application no canto superior direito.
- Selecione a opção Connect GitHub (ou Import a repository).
- Em Select a repository:
- Selecione a sua conta do GitHub.
- Encontre e selecione o seu fork
DriveFlin. - Clique em Next (Avançar).
- Na tela Set up your application:
- Project name:
driveflin(ou o nome que preferir). - Deploy command:
npx wrangler deploy(já vem preenchido). - Clique no botão azul Deploy!
- Project name:
- A Cloudflare iniciará a compilação, detectará o arquivo
wrangler.tomlna raiz e conectará automaticamente o seu bancojellyfin_db_prod!
Note
E se der erro de banco não encontrado?
Se você clicou em Deploy antes de criar o banco, basta criá-lo com o nome jellyfin_db_prod em Storage & Databases > D1 SQL Database, e depois ir no seu Worker em Settings > Bindings > Add binding > D1 Database, nome da variável DB, selecionar jellyfin_db_prod e clicar em Retry deployment.
Após a implantação, adicione a sua conexão do Google Drive e personalizações:
-
No painel do seu Worker recém-criado (
driveflin), vá em Settings (Configurações) > Variables and Secrets (Variáveis e Segredos). -
Clique em Add (Adicionar) e insira as variáveis necessárias:
Variável / Segredo Tipo Descrição GDRIVE_CLIENT_IDSecret Client ID obtido no Google Cloud Console. GDRIVE_CLIENT_SECRETSecret Client Secret obtido no Google Cloud Console. GDRIVE_REFRESH_TOKENSecret Refresh Token obtido em generator.driveflin.org. TMDB_API_KEYSecret (Opcional) Sua chave pessoal do TheMovieDB. O DriveFlin já possui uma chave funcional embutida de fábrica, mas você pode usar a sua própria se preferir. GDRIVE_TEAM_DRIVE_IDSecret (Opcional) ID do Drive Compartilhado (Shared/Team Drive). RCLONE_PASSSecret (Opcional) Senha caso seus arquivos usem Rclone Crypt. RCLONE_SALTSecret (Opcional) Salt caso seus arquivos usem Rclone Crypt. -
Clique em Save and Deploy (Salvar e implantar).
- Acesse o endereço do seu Worker fornecido pela Cloudflare:
https://driveflin.seu-subdominio.workers.dev/web/index.html - Login Inicial Automático:
- Usuário:
admin - Senha:
admin(recomendado alterar depois dentro do próprio painel do Jellyfin em Usuários)
- Usuário:
- Vá em Painel de Controle (ícone de usuário > Painel) > Bibliotecas.
- Clique em + Adicionar Biblioteca de Mídia, selecione a categoria (Filmes, Séries ou Música) e selecione diretamente sua pasta do Google Drive pelo navegador visual!
Para desenvolvedores que preferem gerenciar tudo pelo terminal local:
# 1. Clonar o repositório
git clone https://github.com/samucamg/DriveFlin.git
cd DriveFlin
# 2. Instalar dependências
npm install
# 3. Criar banco D1 na Cloudflare
npx wrangler d1 create jellyfin_db_prod
# 4. Executar o schema inicial
npx wrangler d1 execute jellyfin_db_prod --remote --file=schema.sql
# 5. Configurar os segredos (incluindo TMDB_API_KEY)
npx wrangler secret put TMDB_API_KEY
npx wrangler secret put GDRIVE_CLIENT_ID
npx wrangler secret put GDRIVE_CLIENT_SECRET
npx wrangler secret put GDRIVE_REFRESH_TOKEN
# 6. Publicar o Worker
npx wrangler deploy- Credenciais de Fábrica:
- Usuário:
admin - Senha:
admin - Recomendamos alterar a senha a qualquer momento no menu de usuários do painel.
- Usuário:
- Identificação e Capas (TMDB):
- Se algum título não carregar a capa automaticamente, clique nos três pontinhos do cartaz > Identificar.
- Digite o nome do filme ou série. O DriveFlin salvará a capa em alta resolução e a sinopse em português de forma permanente.
- Gerar e Restaurar Backups:
- Acesse Painel de Controle > Backups.
- O sistema gera arquivos
.jsongravados tanto no Google Drive quanto no Cloudflare D1 para restauração com 1 clique.
Important
O DriveFlin foi desenvolvido exclusivamente para uso pessoal, acervos familiares e compartilhamento privado com amigos.
- 🏠 Foco em Uso Pessoal e Diário: O objetivo primordial do DriveFlin é oferecer uma alternativa serverless econômica, ágil e livre de manutenção para o consumo diário de mídia, eliminando a necessidade de manter computadores ou servidores dedicados ligados 24 horas por dia consumindo energia.
- 📚 Bibliotecas com Milhares de Filmes e Séries: Para acervos de grande porte (milhares de filmes, séries e dezenas de milhares de episódios), recomendamos utilizar o aplicativo desktop / servidor tradicional do Jellyfin Oficial (instalado em PC dedicado, NAS ou Docker). O servidor oficial conta com banco de dados local de alta capacidade, indexação multithread pesada e suporte a transcodificação dedicada por GPU/FFmpeg.
- 🚫 Não Indicado para Provedores e Fins Comerciais: O DriveFlin NÃO é indicado, projetado ou homologado para provedores de internet, revendedores de listas/contas, empresas ou qualquer atividade comercial de distribuição de streaming. Nesses cenários corporativos ou de grande volume de tráfego concorrente, recomendamos sempre e categoricamente a infraestrutura e a distribuição do projeto oficial do Jellyfin.
- ℹ️ Isenção de Vínculo: O DriveFlin é uma implementação independente e open-source compatível com as APIs abertas do ecossistema Jellyfin e Google Drive. Não possui vínculo, afiliação, patrocínio ou endosso da Jellyfin Foundation ou da Google LLC.
- Apenas Direct Play / Direct Stream: O ambiente serverless de borda (Cloudflare Workers / V8 Isolates) não possui suporte a execução de binários locais como
ffmpegnem placas de vídeo dedicadas. Portanto, não há transcodificação de vídeo em tempo real. A reprodução depende da capacidade do navegador ou dispositivo do usuário decodificar diretamente os formatos de mídia (H.264,AAC,MP3, etc.). - Plugins Jellyfin em C# (.NET): Plugins tradicionais compilados em DLLs .NET não são suportados, pois o backend roda inteiramente em TypeScript/JavaScript na V8.
- 🌐 Website e Documentação: https://driveflin.org
- 🚀 Tutorial Ilustrado de Deploy: https://driveflin.org/deploy.php
- 🔑 Gerador de Conexão OAuth Google Drive: https://generator.driveflin.org
- 📂 Organização de Bibliotecas e Pastas: https://driveflin.org/libraries.php
- ⚡ Comparativo Técnico e Serverless: https://driveflin.org/differences.php
- ❓ FAQ e Resolução de Problemas: https://driveflin.org/faq.php
- 👥 Comunidade e Colaboração: https://driveflin.org/community.php
Distribuído sob a licença MIT. Consulte LICENSE para mais detalhes.
Desenvolvido com carinho para a comunidade open-source. Se este projeto foi útil para você, deixe uma ⭐ no repositório!
