CONVERTALL / README.md
gamecontroll's picture
Add Hugging Face config to README.md
4e8b869
|
Raw History Blame Contribute Delete
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! 🔄