Spaces:

RafaG
/

ViralCutterPRO

Sleeping

App Files Files Community

RafaG commited on 13 days ago

Commit

168efb3

verified ·

1 Parent(s): 80b326d

Update README.md

Browse files

Files changed (1) hide show

README.md +166 -154

README.md CHANGED Viewed

@@ -1,154 +1,166 @@
-# 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`.
----

+---
+title: ViralCutterPRO
+emoji: 📊
+colorFrom: indigo
+colorTo: green
+sdk: gradio
+sdk_version: 6.2.0
+app_file: 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`.
+---