README.md

---
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://dcbadge.vercel.app/api/server/aihubbrasil) ](https://discord.gg/aihubbrasil) <br>
[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**
![WebUi Home](https://github.com/user-attachments/assets/923f260d-222b-40cc-9ab6-7114d6cefd1c)
*Tela Principal: Ajustes de IA, legendas e visualização de logs*

![WebUI Library](https://github.com/user-attachments/assets/3d9fd063-7e81-4e14-bba6-c66618a1635f)
*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:<br> [![Open In Colab](https://img.shields.io/badge/Colab-F9AB00?style=for-the-badge&logo=googlecolab&color=525252)](https://colab.research.google.com/drive/1gcxImzBt0ObWLfW3ThEcwqKhasB4WpgX?usp=sharing)
HF [![Hugging Face Spaces](https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-Spaces-blue)]()
-->

- Entre no link e siga os passos na ordem: [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/drive/1UZKzeqjIeEyvq9nPx7s_4mU6xlkZQn_R?usp=sharing#scrollTo=pa36OeArowme) <br>

## **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`.

---