---
title: ViralCutterPRO
emoji: ✂️
colorFrom: indigo
colorTo: green
sdk: gradio
sdk_version: 6.2.0
app_file: webui/app.py
pinned: false
license: gpl-3.0
---
# ViralCutter: Gerador de Vídeos Virais
[  ](https://discord.gg/aihubbrasil)
[English](https://github.com/RafaelGodoyEbert/ViralCutter/blob/main/README_en.md) | [Português](https://github.com/RafaelGodoyEbert/ViralCutter/blob/main/README.md)
## **Descrição**
ViralCutter é uma ferramenta inovadora para gerar vídeos virais a partir de conteúdo existente. Com técnicas avançadas de processamento de vídeo e áudio, o ViralCutter corta e edita segmentos de vídeo que são perfeitos para compartilhamento em redes sociais. Utilizando o modelo WhisperX para transcrição e geração de legendas automáticas, ele adapta os vídeos para o formato 9:16 (vertical), ideal para plataformas como TikTok e Instagram com Reels e Youtube com Shorts.
## **Novidades e Atualizações (Changelog)**
Confira as melhorias mais recentes:
- **Nova WebUI (Gradio)**: Interface gráfica moderna inspirada no OpusClip, facilitando o uso de todas as ferramentas.
- **Instalação Rápida (UV)**: Novo script `.bat` que utiliza o `uv` para instalar dependências de forma muito mais rápida.
- **Otimização de Performance**: "Slicing" de transcrição implementado. O vídeo é transcrito apenas uma vez, e os cortes reutilizam os dados, eliminando reprocessamento.
- **Suporte a IA Flexível**: Integração nativa com **Gemini API** e suporte experimental ao **G4F** (GPT-4 Free), além de modo Manual.
- **Configuração Externa**: Arquivos `api_config.json` e `prompt.txt` para fácil personalização sem mexer no código.
- **Correção de Rostos**: Fix no MediaPipe para rastreamento de rostos preciso sem depender de "Center Crop".
- **Melhorias em Legendas**: Posicionamento inteligente para vídeos com 2 faces (split screen) e correções de estilo.
*(Veja o [changelog.md](changelog.md) para detalhes completos)*
## **Interface**
*Tela Principal: Ajustes de IA, legendas e visualização de logs*
*Biblioteca: Galeria estilo OpusClip e controles intuitivos*
## **Funcionalidades**
- **Download de Vídeos**: Baixa vídeos do YouTube através de uma URL fornecida.
- **Transcrição de Áudio**: Converte áudio em texto utilizando o modelo WhisperX.
- **Identificação de Segmentos Virais**: Utiliza IA para detectar partes do vídeo com alto potencial de viralização.
- **Corte e Ajuste de Formato**: Corta os segmentos selecionados e ajusta a proporção para 9:16.
- **Recorte Inteligente**: Mantém o falante em foco (Face Tracking) ou utiliza modo Split Screen (2-Faces) automático.
- **Mesclagem de Áudio e Vídeo**: Combina o áudio transcrito com os clipes de vídeo processados.
- **Exportação em Lote**: Gera um arquivo ZIP com todos os vídeos virais criados, facilitando o download e compartilhamento.
- **Legenda personalizada**: Você cria uma legenda personalizada com cores, highlight, sem highlight ou palavra por palavra, tendo uma ampla possibilidade de edição.
## **Como Usar**
- Entre no link e siga os passos na ordem: [](https://colab.research.google.com/drive/1UZKzeqjIeEyvq9nPx7s_4mU6xlkZQn_R?usp=sharing#scrollTo=pa36OeArowme)
## **Limitações**
- A qualidade dos vídeos gerados pode variar com base na qualidade do vídeo original.
- O tempo de processamento depende fortemente da sua GPU.
- O modelo **G4F** pode ser instável ou ter limites de requisição. Use **Gemini** para maior estabilidade mas precisa de api_key.
## Inspiração:
Este projeto foi inspirado nos seguintes repositórios:
* [Reels Clips Automator](https://github.com/eddieoz/reels-clips-automator)
* [YoutubeVideoToAIPoweredShorts](https://github.com/Fitsbit/YoutubeVideoToAIPoweredShorts)
## TODO📝
- [x] Release code
- [ ] Huggingface SpaceDemo
- [x] Two face in the cut
- [x] Custom caption and burn
- [x] Make the code faster
- [ ] More types of framing beyond 9:16
- [x] The cut follows the face as it moves
- [ ] Automatic translation
- [ ] Satisfactory video on the side
- [ ] Background music
- [ ] watermark at user's choice
- [ ] Upload directly to YouTube channel
## Exemplos
### Exmplo de vídeo viral ``com highlight ativo`` [comprimido pra caber no github]
https://github.com/user-attachments/assets/dd9a7039-e0f3-427a-a6e1-f50ab5029082
### Exemplo Opus Clip vs ViralCutter [comprimido pra caber no github]
https://github.com/user-attachments/assets/12916792-dc0e-4f63-a76b-5698946f50f4
### Exemplo 2 faces [comprimido pra caber no github]
https://github.com/user-attachments/assets/ca7ebb9c-52ba-4171-a513-625bef690a2b
## **Instalação e Uso Local**
### Pré-requisitos
- Python 3.10+
- FFmpeg instalado e no PATH do sistema.
- GPU NVIDIA recomendada (com CUDA instalado) para o WhisperX.
### Configuração
1. **Instale as dependências**:
**Opção A (Recomendada - Rápida)**:
Execute o arquivo `install_dependencies.bat`. Ele usará o `uv` para instalar tudo rapidamente.
**Opção B (Manual)**:
```bash
pip install -r requirements.txt
```
*(Nota: WhisperX e Torch podem exigir instalação específica para sua versão de CUDA)*.
2. **Configure a API (Opcional mas Recomendado)**:
Edite o arquivo `api_config.json` na pasta raiz:
```json
{
"selected_api": "gemini",
"gemini": {
"api_key": "SUA_CHAVE_AQUI"
}
}
```
### Executando
#### Interface Gráfica (WebUI)
Para usar a nova interface visual:
Dê um duplo clique em `run_webui.bat` ou execute:
```bash
.\run_webui.bat
```
#### Modo Interativo (Simples)
Basta rodar o script e seguir as instruções na tela:
```bash
python main_improved.py
```
#### Modo CLI (Avançado)
Você pode passar todos os argumentos via linha de comando para automação:
```bash
python main_improved.py --url "https://youtu.be/EXEMPLO" --segments 3 --ai-backend gemini --model large-v3-turbo
```
**Argumentos Principais:**
- `--url`: URL do vídeo do YouTube.
- `--segments`: Número de cortes a gerar.
- `--ai-backend`: `gemini` (Recomendado), `g4f` ou `manual`.
- `--viral`: Ativa modo de busca viral automática.
- `--face-mode`: `auto`, `1` (uma cara), ou `2` (duas caras/split).
- `--workflow`: `1` (Completo) ou `2` (Apenas Corte, sem legendas/crop).
---
## **Contribuições**
Quer ajudar a tornar o ViralCutter ainda melhor? Se você tiver sugestões ou quiser contribuir com o código, fique à vontade para abrir uma issue ou enviar um pull request no nosso repositório do GitHub.
## **Versão**
`0.7v Alpha`
Uma alternativa gratuita ao `opus.pro` e ao `vidyo.ai`.
---