VideoFrameExtractor

Extrator inteligente de quadros de video com avaliacao de nitidez e qualidade perceptual BRISQUE.

Badges

Visão Geral

O VideoFrameExtractor foi desenvolvido com foco em robustez, alta disponibilidade e padrões seguros de engenharia de software.

Requisitos de Sistema

• Sistema Operacional: Microsoft Windows 10 / 11 ou Windows Server (x64)
• Ambiente de Execução: Python 3.11+ / PowerShell 5.1+
• Dependências de Sistema: Visual C++ Redistributable (para módulos compilados)

Instalação e Execução

Opção 1: Pacote Standalone / Instalador (Recomendado)

Faça o download do pacote de distribuição na aba Releases e execute o arquivo correspondente.

Opção 2: Execução a partir do Código-Fonte

1. Clone o repositório:

git clone https://github.com/GrandoJunior/VideoFrameExtractor.git
cd VideoFrameExtractor

2. Crie e ative o ambiente virtual:

python -m venv .venv
.\.venv\Scripts\Activate.ps1

3. Instale as dependências:

pip install -r requirements.txt

4. Configure as variáveis de ambiente baseando-se no arquivo .env.example:

Copy-Item .env.example .env

5. Execute a aplicação:

python main.py

Arquitetura e Segurança

• Zero Hardcoded Secrets: Todas as credenciais e parâmetros sensíveis são carregados via variáveis de ambiente.
• Clean Architecture: Desacoplamento entre regras de negócio, infraestrutura e interfaces de apresentação.

Metadados do Projeto

• Autor: Guido Grando (GrandoJunior)
• Tags: python, video-frame-extraction, brisque, image-quality, opencv, multimedia
• Versão: v1.0.0