Spaces:
Sleeping
Sleeping
|
Download README.md from gamecontroll/CONVERTALL: direct link, hf CLI and curl.
- Browser
- Download file 7.22 kB
-
https://huggingface.co/spaces/gamecontroll/CONVERTALL/resolve/main/README.md
- Command line
-
hf download hf://spaces/gamecontroll/CONVERTALL/README.md
-
curl -L -o README.md https://huggingface.co/spaces/gamecontroll/CONVERTALL/resolve/main/README.md
7.22 kB
| title: ConvertAll | |
| emoji: 🚀 | |
| colorFrom: indigo | |
| colorTo: blue | |
| sdk: streamlit | |
| app_file: app.py | |
| pinned: false | |
| # Editor de Vídeo, Imagem e Áudio Local | |
| ## 📋 **Estrutura do Código** | |
| ### **1. Imports e Configuração** | |
| ```python | |
| import streamlit as st # Interface web | |
| import ffmpeg # Processamento de vídeo | |
| from PIL import Image # Processamento de imagem | |
| import tempfile # Arquivos temporários | |
| import os # Sistema operacional | |
| ``` | |
| ### **2. Anatomia das Funções** | |
| **Função de Processamento de Vídeo:** | |
| ```python | |
| def processar_video(input_path, output_path, largura=None, altura=None, crop=None, formato="mp4"): | |
| # 1. Verificar formato | |
| # 2. Montar comando/filtros | |
| # 3. Executar processamento | |
| # 4. Retornar True/False | |
| ``` | |
| **Função de Processamento de Imagem:** | |
| ```python | |
| def processar_imagem(img, largura=None, altura=None, manter_proporcao=True, formato="JPEG"): | |
| # 1. Aplicar transformações PIL | |
| # 2. Retornar imagem processada | |
| ``` | |
| --- | |
| ## 🛠️ **Como Adicionar Novos Formatos de Vídeo** | |
| ### **Passo 1: Adicionar na Interface** | |
| ```python | |
| # Localizar esta linha (aprox. linha 150) | |
| formato_saida = st.selectbox("Formato de saída", ["mp4", "avi", "mov", "gif"]) | |
| # Modificar para: | |
| formato_saida = st.selectbox("Formato de saída", ["mp4", "avi", "mov", "gif", "webm", "mkv"]) | |
| ``` | |
| ### **Passo 2: Adicionar Lógica de Processamento** | |
| ```python | |
| # Na função processar_video(), adicionar novo elif: | |
| elif formato == "webm": | |
| out = ffmpeg.output(stream, output_path, | |
| vcodec='libvpx-vp9', | |
| acodec='libvorbis', | |
| crf=30) | |
| elif formato == "mkv": | |
| out = ffmpeg.output(stream, output_path, | |
| vcodec='libx264', | |
| acodec='aac', | |
| crf=23) | |
| ``` | |
| ### **Passo 3: Atualizar Download** | |
| ```python | |
| # Atualizar mime type (aprox. linha 180) | |
| mime_mapping = { | |
| "mp4": "video/mp4", | |
| "avi": "video/x-msvideo", | |
| "mov": "video/quicktime", | |
| "webm": "video/webm", | |
| "mkv": "video/x-matroska", | |
| "gif": "image/gif" | |
| } | |
| mime_type = mime_mapping.get(formato_saida, f"video/{formato_saida}") | |
| ``` | |
| --- | |
| ## 🎨 **Como Adicionar Novos Filtros de Vídeo** | |
| ### **Exemplo: Adicionar Filtro de Velocidade** | |
| **1. Interface:** | |
| ```python | |
| # Adicionar após as configurações de redimensionamento | |
| velocidade = st.selectbox("Velocidade", ["Normal", "2x Mais Rápido", "0.5x Mais Lento"]) | |
| # Converter para valor | |
| speed_mapping = { | |
| "Normal": 1.0, | |
| "2x Mais Rápido": 2.0, | |
| "0.5x Mais Lento": 0.5 | |
| } | |
| speed_value = speed_mapping[velocidade] | |
| ``` | |
| **2. Processamento:** | |
| ```python | |
| # Na função processar_video(), adicionar filtro: | |
| if speed_value != 1.0: | |
| if formato == "gif": | |
| filtros.append(f'setpts={1/speed_value}*PTS') # Para GIF | |
| else: | |
| stream = ffmpeg.filter(stream, 'setpts', f'{1/speed_value}*PTS') # Para vídeo | |
| ``` | |
| ### **Exemplo: Adicionar Filtro de Brilho** | |
| ```python | |
| # Interface | |
| brilho = st.slider("Brilho", -1.0, 1.0, 0.0, 0.1) | |
| # Processamento | |
| if brilho != 0.0: | |
| if formato == "gif": | |
| filtros.append(f'eq=brightness={brilho}') | |
| else: | |
| stream = ffmpeg.filter(stream, 'eq', brightness=brilho) | |
| ``` | |
| --- | |
| ## 🖼️ **Como Adicionar Novos Filtros de Imagem** | |
| ### **Exemplo: Adicionar Filtro de Rotação** | |
| **1. Interface:** | |
| ```python | |
| rotacao = st.selectbox("Rotação", ["0°", "90°", "180°", "270°"]) | |
| ``` | |
| **2. Processamento:** | |
| ```python | |
| # Na função processar_imagem() | |
| rotation_mapping = {"0°": 0, "90°": 90, "180°": 180, "270°": 270} | |
| if rotacao != "0°": | |
| angle = rotation_mapping[rotacao] | |
| img = img.rotate(angle, expand=True) | |
| ``` | |
| ### **Exemplo: Adicionar Filtro de Blur** | |
| ```python | |
| # Interface | |
| blur_amount = st.slider("Blur", 0, 10, 0) | |
| # Import adicional no topo | |
| from PIL import ImageFilter | |
| # Processamento | |
| if blur_amount > 0: | |
| img = img.filter(ImageFilter.GaussianBlur(radius=blur_amount)) | |
| ``` | |
| --- | |
| ## 📦 **Como Adicionar Nova Aba** | |
| ### **Exemplo: Aba de "Conversão de Formatos"** | |
| **1. Adicionar na Interface:** | |
| ```python | |
| # Localizar esta linha (aprox. linha 20) | |
| tipo_edicao = st.sidebar.selectbox( | |
| "Tipo de Edição", | |
| ["📹 Vídeos", "🖼️ Imagens", "📦 Lote de Imagens"] | |
| ) | |
| # Modificar para: | |
| tipo_edicao = st.sidebar.selectbox( | |
| "Tipo de Edição", | |
| ["📹 Vídeos", "🖼️ Imagens", "📦 Lote de Imagens", "🔄 Conversão"] | |
| ) | |
| ``` | |
| **2. Adicionar Lógica da Aba:** | |
| ```python | |
| # Adicionar após as outras seções | |
| elif tipo_edicao == "🔄 Conversão": | |
| st.header("Conversão de Formatos") | |
| arquivo = st.file_uploader("Escolha um arquivo", type=['mp4', 'avi', 'mov', 'mkv']) | |
| if arquivo is not None: | |
| formato_destino = st.selectbox("Converter para:", ["mp4", "avi", "webm", "gif"]) | |
| if st.button("🔄 Converter"): | |
| # Lógica de conversão aqui | |
| pass | |
| ``` | |
| --- | |
| ## 📚 **Documentações Essenciais** | |
| ### **🎬 FFmpeg** | |
| - **Oficial:** https://ffmpeg.org/documentation.html | |
| - **Filtros:** https://ffmpeg.org/ffmpeg-filters.html | |
| - **Python FFmpeg:** https://github.com/kkroening/ffmpeg-python | |
| ### **🖼️ PIL/Pillow** | |
| - **Oficial:** https://pillow.readthedocs.io/ | |
| - **Filtros:** https://pillow.readthedocs.io/en/stable/reference/ImageFilter.html | |
| - **Transformações:** https://pillow.readthedocs.io/en/stable/handbook/tutorial.html | |
| ### **🌐 Streamlit** | |
| - **Oficial:** https://docs.streamlit.io/ | |
| - **Widgets:** https://docs.streamlit.io/library/api-reference/widgets | |
| - **Layout:** https://docs.streamlit.io/library/api-reference/layout | |
| --- | |
| ## 🔧 **Template para Adicionar Recursos** | |
| ### **1. Novo Filtro de Vídeo:** | |
| ```python | |
| # Interface (adicionar nas configurações) | |
| meu_filtro = st.checkbox("Ativar Meu Filtro") | |
| if meu_filtro: | |
| intensidade = st.slider("Intensidade", 0, 100, 50) | |
| # Processamento GIF | |
| if meu_filtro: | |
| filtros.append(f'meu_filtro_ffmpeg={intensidade/100}') | |
| # Processamento Vídeo Normal | |
| if meu_filtro: | |
| stream = ffmpeg.filter(stream, 'meu_filtro_ffmpeg', intensidade/100) | |
| ``` | |
| ### **2. Novo Filtro de Imagem:** | |
| ```python | |
| # Interface | |
| aplicar_filtro = st.checkbox("Aplicar Filtro") | |
| # Processamento (na função processar_imagem) | |
| if aplicar_filtro: | |
| # Usar métodos PIL aqui | |
| img = img.filter(ImageFilter.CONTOUR) | |
| ``` | |
| ### **3. Novo Formato:** | |
| ```python | |
| # 1. Adicionar na lista de formatos | |
| # 2. Adicionar lógica no elif formato == "novo_formato" | |
| # 3. Adicionar mime type | |
| # 4. Testar! | |
| ``` | |
| --- | |
| ## 🚀 **Próximos Passos Sugeridos** | |
| 1. **Começar Simples:** Adicione um novo preset de resolução | |
| 2. **Filtros Básicos:** Blur, brilho, contraste para imagens | |
| 3. **Formatos Novos:** WEBM, MKV para vídeos | |
| 4. **Funcionalidades:** Corte de tempo, fade in/out | |
| 5. **Interface:** Drag & drop, preview em tempo real | |
| ## 💡 **Dicas de Desenvolvimento** | |
| - **Sempre testar** cada mudança separadamente | |
| - **Usar try/except** para capturar erros | |
| - **Comentar código** novo que você adicionar | |
| - **Backup** antes de mudanças grandes | |
| - **Streamlit rerun** automaticamente ao salvar arquivo | |
| **Para recarregar após mudanças:** Salve o arquivo e a página atualiza sozinha! 🔄 |