Skip to content
samucamgPublic

About

DriveFlix is a serverless Jellyfin deployment running on Cloudflare Workers with media stored on Google Drive. Built to work seamlessly with all official Jellyfin apps, it delivers low-cost personal streaming without requiring a dedicated home server.

Resources

Stars

12 stars

Watchers

0 watching

Forks

Repository files navigation

🎬 DriveFlin — Serverless Jellyfin on Cloudflare Workers & Google Drive

Português (Brasil) English (US)

🇧🇷 Português  |  🇺🇸 English

DriveFlin Logo

Transform your Google Drive into a high-performance, serverless personal streaming service with 100% Jellyfin client compatibility.

Documentation Website Token Generator Cloudflare Workers Google Drive Cloudflare D1

🌐 Website e Documentação Oficial: driveflin.org


📌 Visão Geral / Overview

🌐 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.


📁 Estrutura do Repositório

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)

✨ Recursos Principais

  • ⚡ 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, .mp3 e .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_Backups do 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 a 206 Partial Content, cabeçalhos Range e 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.

🏗️ Arquitetura

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
Loading

🚀 Guia de Instalação e Deploy Visual na Cloudflare (Via Fork no GitHub)

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!


Passo 1: Fazer o Fork do Repositório

  1. No canto superior direito desta página no GitHub, clique no botão Fork.
  2. Selecione a sua conta pessoal e clique em Create fork.
  3. Pronto! Você agora tem a sua própria cópia do DriveFlin vinculada para atualizações futuras.

Passo 2: Criar o Banco D1 na Cloudflare (Leva 10 segundos)

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.

  1. Acesse o painel da Cloudflare: dash.cloudflare.com.
  2. No menu lateral esquerdo, vá em Storage & Databases (Armazenamento e bancos de dados) > D1 SQL Database.
  3. Clique em Create database (Criar banco de dados).
  4. Em Database name, digite exatamente: jellyfin_db_prod
  5. 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.


Passo 3: Conectar a Aplicação no Cloudflare Workers & Pages

  1. No menu lateral esquerdo da Cloudflare, vá em Workers & Pages.
  2. Clique no botão azul Create application no canto superior direito.
  3. Selecione a opção Connect GitHub (ou Import a repository).
  4. Em Select a repository:
    • Selecione a sua conta do GitHub.
    • Encontre e selecione o seu fork DriveFlin.
    • Clique em Next (Avançar).
  5. 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!
  6. A Cloudflare iniciará a compilação, detectará o arquivo wrangler.toml na raiz e conectará automaticamente o seu banco jellyfin_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.


Passo 4: Configurar as Credenciais e Segredos

Após a implantação, adicione a sua conexão do Google Drive e personalizações:

  1. No painel do seu Worker recém-criado (driveflin), vá em Settings (Configurações) > Variables and Secrets (Variáveis e Segredos).

  2. Clique em Add (Adicionar) e insira as variáveis necessárias:

    Variável / Segredo Tipo Descrição
    GDRIVE_CLIENT_ID Secret Client ID obtido no Google Cloud Console.
    GDRIVE_CLIENT_SECRET Secret Client Secret obtido no Google Cloud Console.
    GDRIVE_REFRESH_TOKEN Secret Refresh Token obtido em generator.driveflin.org.
    TMDB_API_KEY Secret (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_ID Secret (Opcional) ID do Drive Compartilhado (Shared/Team Drive).
    RCLONE_PASS Secret (Opcional) Senha caso seus arquivos usem Rclone Crypt.
    RCLONE_SALT Secret (Opcional) Salt caso seus arquivos usem Rclone Crypt.
  3. Clique em Save and Deploy (Salvar e implantar).


Passo 5: Acessar a Interface e Configurar suas Mídias

  1. Acesse o endereço do seu Worker fornecido pela Cloudflare:
    https://driveflin.seu-subdominio.workers.dev/web/index.html
  2. Login Inicial Automático:
    • Usuário: admin
    • Senha: admin (recomendado alterar depois dentro do próprio painel do Jellyfin em Usuários)
  3. Vá em Painel de Controle (ícone de usuário > Painel) > Bibliotecas.
  4. 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!

💻 Alternativa: Deploy via Linha de Comando (Wrangler CLI)

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

📖 Como Usar & Dicas do Dia a Dia

  1. Credenciais de Fábrica:
    • Usuário: admin
    • Senha: admin
    • Recomendamos alterar a senha a qualquer momento no menu de usuários do painel.
  2. 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.
  3. Gerar e Restaurar Backups:
    • Acesse Painel de Controle > Backups.
    • O sistema gera arquivos .json gravados tanto no Google Drive quanto no Cloudflare D1 para restauração com 1 clique.

⚖️ Propósito do Projeto, Uso Recomendado & Isenção (Disclaimer)

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.

⚠️ Limitações Importantes

  • 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 ffmpeg nem 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.

🔗 Links Úteis e Documentação Oficial


📄 Licença

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!

About

DriveFlix is a serverless Jellyfin deployment running on Cloudflare Workers with media stored on Google Drive. Built to work seamlessly with all official Jellyfin apps, it delivers low-cost personal streaming without requiring a dedicated home server.

Resources

Stars

12 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages