Spaces:

RafaG
/

ViralCutterPRO

Running

App Files Files Community

ViralCutterPRO / README.md

RafaG

Update README.md

c1d69ae verified 9 days ago

preview code

raw

history blame contribute delete

7.36 kB

metadata

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

English | Português

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 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:

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:

TODO📝

Release code
Huggingface SpaceDemo
Two face in the cut
Custom caption and burn
Make the code faster
More types of framing beyond 9:16
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

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

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):
```
pip install -r requirements.txt
```
(Nota: WhisperX e Torch podem exigir instalação específica para sua versão de CUDA).

Configure a API (Opcional mas Recomendado): Edite o arquivo api_config.json na pasta raiz:

{
    "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:

.\run_webui.bat

Modo Interativo (Simples)

Basta rodar o script e seguir as instruções na tela:

python main_improved.py

Modo CLI (Avançado)

Você pode passar todos os argumentos via linha de comando para automação:

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.