🎬 PyMedia Manager
PyMedia Manager é uma solução completa e self-hosted para organização, renomeação e transcodificação de bibliotecas de mídia. Projetado para transformar uma pasta de downloads caótica em uma biblioteca organizada para servidores de mídia (Jellyfin/Plex).
⚡ Otimização de Hardware: Este projeto foi ajustado especificamente para processadores Intel de 4ª Geração (Haswell), utilizando drivers
i965e FFmpeg viaVAAPInativo para máxima performance e estabilidade.
✨ Funcionalidades
1. 📂 Gerenciador de Arquivos
- Interface Visual: Navegue pelas pastas do servidor como em um sistema operacional.
- Ações: Mover, Excluir (lixeira), Renomear arquivos individualmente e Criar novas pastas.
- Preview: Visualização rápida de tamanho e data de modificação.
2. 🏷️ Renomeador de Séries (Regex Inteligente)
- Detecção Automática: Identifica padrões como
S01E01,1x01,S01 - EP01,Season 1 Episode 1. - Organização: Cria automaticamente a estrutura
Nome da Série > Temporada XX > Episódio YY.mkv. - Segurança: Tabela de pré-visualização ("De -> Para") antes de aplicar qualquer alteração.
3. ⚙️ Encoder (FFmpeg Persistente)
- Backend Desacoplado: O processo de conversão roda em uma thread de fundo. Você pode fechar o navegador ou atualizar a página (F5) que o progresso não é perdido.
- Intel Haswell Ready: Utiliza o driver legado
i965e inicialização explícita de VAAPI para evitar conflitos de driver. - Seleção de Faixas: Mantém vídeos em H.264, copia áudios (POR/ENG/JPN) e legendas (PT-BR) sem recompressão.
- Espelhamento: Replica a estrutura de pastas da origem para a pasta
finalizados.
🚀 Instalação e Deploy
Pré-requisitos
- Docker e Docker Compose.
- Hardware Intel com iGPU ativa (QuickSync).
- Drivers de vídeo instalados no host (
/dev/dri).
1. Clonar o Repositório
git clone http://seu-gitea-url/seu-usuario/pymediamanager.git
cd pymediamanager
2. Estrutura de Pastas Necessária
O projeto espera a seguinte estrutura. Crie as pastas se não existirem:
mkdir -p data
mkdir -p app/modules
# As pastas de mídia geralmente ficam fora, ex: /home/user/downloads
3. Configurar Permissões (Crítico ⚠️)
O Docker precisa de permissão total para ler, escrever, criar pastas e deletar arquivos no seu diretório de downloads.
# Permissão na pasta do projeto
sudo chmod -R 777 .
# Permissão na pasta de mídia do Host
sudo chmod -R 777 /home/seu-usuario/downloads
4. Arquivo docker-compose.yml
Crie ou verifique o arquivo na raiz do projeto:
version: "3.8"
services:
pymediamanager:
build: .
container_name: pymediamanager
privileged: true # Obrigatório para acesso total à GPU
restart: unless-stopped
# Acesso ao Hardware de Vídeo
devices:
- /dev/dri:/dev/dri
# Grupo de Vídeo (Verifique o ID com 'ls -ln /dev/dri/renderD128')
group_add:
- "993"
environment:
- TZ=America/Sao_Paulo
# O SEGREDO DO HASWELL: Força o driver antigo
- LIBVA_DRIVER_NAME=i965
volumes:
# Código Fonte
- ./app:/app
# Banco de Dados e Estados (Persistência)
- ./data:/app/data
# Mapeamento de Mídia (Host : Container)
- /home/creidsu/downloads:/downloads
ports:
- 8501:8501
5. Compilar e Rodar
Sempre que alterar o código ou o Dockerfile, use --build:
docker-compose up -d --build
Para ver os logs do FFmpeg em tempo real:
docker logs -f pymediamanager
🖥️ Como Usar
Acesse no navegador: http://IP-DO-SEU-SERVER:8501
Aba 1: Gerenciador
Use para limpar o "lixo" (arquivos .txt, .nfo, samples) ou mover pastas inteiras antes de processar.
Aba 2: Renomeador
- Selecione a pasta raiz da série (ex:
/downloads/MinhaSerie). - Clique em Analisar.
- Confira a tabela. Se o Regex pegou tudo certo, clique em Confirmar Renomeação.
Aba 3: Encoder
- Selecione a pasta organizada.
- Marque se deseja excluir os originais após o sucesso.
- Clique em Iniciar.
- O sistema criará o arquivo
encoder_status.json. A interface vai ler esse arquivo a cada 5 segundos. - Pode fechar a aba! O servidor continuará trabalhando.
🛠️ Solução de Problemas
1. Erro: Permission denied / Read-only file system
- O container não tem permissão na pasta do host.
- Solução: Rode
sudo chmod -R 777 /caminho/dos/downloads.
2. Erro no Log: Failed to initialise VAAPI connection: -1
- Conflito entre o driver novo (
iHD) e o hardware antigo. - Solução: O script
worker.pyjá possui uma funçãoprepare_driver_environment()que tenta apagar o driveriHDe forçar oi965. Verifique se a variávelLIBVA_DRIVER_NAME=i965está no docker-compose.
3. Docker não inicia (group 'render' not found)
- O ID do grupo de vídeo muda de sistema para sistema.
- Solução: No terminal do host, digite
ls -ln /dev/dri. Pegue o segundo número (ex: 993, 107) e coloque nogroup_adddodocker-compose.yml.
📦 Stack Tecnológica
- Linguagem: Python 3.10
- Frontend: Streamlit
- Engine de Vídeo: FFmpeg (via
subprocess) - Banco de Dados: SQLite + JSON (Estado)
- Container: Docker (Ubuntu Base)