ViralCutter - Fork com Notebooks Kaggle e Colab

Fork customizado com notebooks otimizados para Kaggle e Google Colab. Para o repositório original completo, veja abaixo.

Fork do ViralCutter - alternativa gratuita ao opus.pro e ao vidyo.ai para criar cortes automáticos de vídeos longos (podcasts, lives, etc.) em clipes virais para Reels/Shorts/TikTok usando IA.

🚀 Notebooks Disponíveis

🔵 Google Colab

Características:

• ✅ Instalação rápida (3-5 min)
• ✅ Upload automático para Google Drive
• ✅ Otimizado para GPUs T4 (Faster-Whisper integrado)
• ❌ Zoom inteligente removido (mais leve)

💡 Otimização T4: Usa faster-whisper com modelo quantizado para transcrição eficiente na GPU limitada do Colab.

Como usar:

1. Abra o notebook no Colab clicando aqui
2. Execute a célula principal
3. Aguarde a instalação
4. Clique no link gradio.live gerado
5. Processe seus vídeos - os cortes irão automaticamente para seu Drive!

🟠 Kaggle

Características:

• ✅ 30h/semana de GPU grátis
• ✅ Upload OAuth para sua conta Drive
• ✅ Suporte a datasets persistentes
• ✅ Documentação completa de configuração
• ✅ Faster-Whisper otimizado para T4

💡 Otimização T4: Ambos notebooks usam faster-whisper que é mais eficiente em memória. Recomendado usar modelo large-v2 quantizado para melhor performance na T4.

Como usar:

1. Configure os datasets primeiro (veja seção abaixo)
2. Abra o notebook no Kaggle clicando aqui
3. Execute a célula principal
4. Faça a autenticação OAuth quando solicitado
5. Clique no link gradio.live gerado

---

📦 Configurando Datasets no Kaggle

O notebook do Kaggle requer algumas credenciais. Siga o guia completo:

1️⃣ client_secret.json (Obrigatório)

Credenciais OAuth do Google Cloud para upload no Drive.

Passos:

1. Acesse Google Cloud Console
2. Crie um projeto ou use um existente
3. Vá em APIs & Services → Credentials
4. Create Credentials → OAuth 2.0 Client ID
5. Escolha Desktop App
6. Baixe o JSON
7. No Kaggle: Add Data → Upload → Faça upload
8. Nomeie o dataset como client-secret-json

2️⃣ cookie (Opcional)

Cookies para download de vídeos privados/restritos.

Passos:

1. Instale Get cookies.txt LOCAL
2. Acesse www.kaggle.com (logado)
3. Clique na extensão → Export
4. Salve como www.youtube.com_cookies.txt
5. No Kaggle: Add Data → Upload
6. Nomeie o dataset como cookie

3️⃣ credenciais-google (Obrigatório)

API Key do Gemini para análise com IA.

Passos:

1. Acesse Google AI Studio
2. Create API Key
3. Copie a chave
4. Crie arquivo gemini_api.txt com a chave
5. No Kaggle: Add Data → Upload
6. Nomeie o dataset como credenciais-google

4️⃣ google-drive-credentials (Opcional)

Token OAuth reutilizável (gerado na primeira execução).

Como reutilizar:

1. Execute o notebook uma vez
2. Após autenticação, baixe o arquivo .json gerado em /kaggle/working/
3. Crie dataset no Kaggle com este arquivo
4. Nomeie como google-drive-credentials

---

✨ Diferenças entre Colab e Kaggle

Característica	Colab	Kaggle
GPU Grátis	✅ 12h/dia	✅ 30h/semana
Configuração	Mais simples	Requer datasets
Upload Drive	Nativo	OAuth manual
Zoom IA	❌ Removido	✅ Disponível
Persistência	❌ Nenhuma	✅ Datasets

---

🎯 Recursos

• Detecção automática de momentos virais
• Transcrição com IA (WhisperX)
• Corte inteligente com análise semântica
• Legendas automáticas
• Processamento em batch

---

🔗 Links Úteis

• Licença (GPL v3): LICENSE
• Repositório Original: RafaelGodoyEbert/ViralCutter
• Discord (Suporte): discord.gg/tAdPHFAbud

---

📝 Créditos

Desenvolvido por Rafa.Godoy

• GitHub
• Twitter
• Instagram

Fork customizado para facilitar uso em Kaggle e Colab.

---

📄 Licença

Este projeto é licenciado sob a GNU General Public License v3, permitindo que você copie, distribua e modifique o software livremente, desde que mantenha a mesma licença. Leia a licença completa aqui.

ViralCutter

Alternativa open-source 100% gratuita, local e ilimitada ao Opus Clip
Transforme vídeos longos do YouTube em shorts virais otimizados para TikTok, Instagram Reels e YouTube Shorts – com IA de ponta, legendas dinâmicas, face tracking preciso e tradução automática. Tudo rodando na sua máquina.

English • Português

Por que ViralCutter é um "Game Changer"?

Esqueça assinaturas caras e limites de minutos. O ViralCutter oferece poder ilimitado no seu hardware.

Feature	ViralCutter (Open-Source)	Opus Clip / Klap / Munch (SaaS)
Preço	Gratuito e Ilimitado	$20–$100/mês + limites de min.
Privacidade	100% Local (Seus dados não saem do PC)	Upload para nuvem de terceiros
IA & LLM	Flexível: Gemini (Free), GPT-4, Local GGUF (Offline)	Apenas o que eles oferecem
Face Tracking	Split Screen (2 faces), Active Speaker (Exp.), Auto	Básico ou pago extra
Tradução	Sim (Traduza legendas p/ 10+ línguas)	Recursos limitados
Edição	Exporta XML para Premiere Pro (Beta)	Editor web limitado
Watermark	ZERO	Sim (nos planos free)

Resultados profissionais, privacidade total e custo zero.

Funcionalidades Principais 🚀

• 🤖 Corte Viral com IA: Identifica automaticamente os ganchos e momentos mais engajadores usando Gemini, GPT-4 ou LLMs Locais (Llama 3, DeepSeek, etc).
• 🗣️ Transcrição Ultra-Precisa: Baseado em WhisperX com aceleração via GPU para legendas perfeitas.
• 🎨 Legendas Dinâmicas: Estilo "Hormozi" com highlight palavra por palavra, cores vibrantes, emojis e total customização.
• 🎥 Direção de Câmera Automática:
  • Auto-Crop 9:16: Transforma horizontal em vertical mantendo o foco.
  • Split Screen Inteligente: Detecta 2 pessoas conversando e divide a tela automaticamente.
  • Active Speaker (Experimental): A câmera corta para quem está falando.
• 🌍 Tradução de Vídeo: Gere legendas traduzidas automaticamente (ex: Vídeo em Inglês -> Legenda em Português).
• 💾 Qualidade & Controle: Escolha a resolução (até 4K/Best), formate a saída e salve configurações de processamento.
• ⚡ Performance: Transcrição com "slicing" (processa 1x, corta N vezes) e suporte a instalação ultra-rápida via uv.
• 🖥️ Interface Moderna: WebUI em Gradio, Modo Escuro, Galeria de Projetos e Editor de Legendas integrado.

Interface Web (Inspirada no Opus Clip)

Painel de controle intuitivo com ajustes finos de IA e renderização.

Biblioteca: Galeria estilo OpusClip e controles intuitivos

Instalação Local (Super Rápida ⚡)

Pré-requisitos

• Python 3.10+
• FFmpeg instalado no sistema
• GPU NVIDIA (Altamente recomendada para velocidade e funcionalidades de IA local)

Passo a Passo

1. Instale as dependências Execute o script install_dependencies.bat. Ele usa o gerenciador uv para configurar tudo em segundos.

2. Configurar IA (Opcional)

   • Gemini (Recomendado/Free): Adicione sua chave em api_config.json.
   • Local (GGUF): Baixe seus modelos .gguf favoritos e coloque na pasta models/. O ViralCutter irá detectá-los automaticamente.

3. Rodar

   • Duplo clique em run_webui.bat para abrir a interface no navegador.
   • Ou use python main_improved.py para a versão CLI.

Exemplos de Saída

Clip viral com legendas highlight

000.A.Historia.Tragica.Do.Onibus.Espacial.Subtitled.mp4

Comparação direta: Opus Clip vs ViralCutter (mesmo vídeo de entrada)

Opuspro-Vs-Viralcutter.mp4

Modo Split Screen (2 faces)

000.Teste.Subtitled.mp4

Roadmap (TODO)

• Lançamento do código
• Demo permanente no Hugging Face Spaces
• Suporte a 2 pessoas (Split Screen)
• Legendas personalizadas e renderização (Burn)
• Otimização de performance (Código mais rápido)
• Modelos de IA 100% locais (Ollama/Llama/GGUF)
• Tradução automática de legendas
• Rastreamento dinâmico de rosto (O corte segue o movimento)
• Exportação de XML para Premiere Pro (Beta)
• Música de fundo automática (Auto-Duck)
• Upload direto para TikTok/YouTube/Instagram
• Mais formatos de enquadramento (além de 9:16)
• Watermark opcional

---

Contribua!

O ViralCutter é mantido pela comunidade. Junte-se a nós para democratizar a criação de conteúdo com IA!

• Discord: AI Hub Brasil
• Github: Dê uma ⭐ estrela se este projeto te ajudou!

Versão Atual: 0.8v Alpha ViralCutter: Porque clips virais não precisam custar uma fortuna. 🚀