Documentação Aparato (v2.0)

O Aparato é uma plataforma modular de código aberto projetada para artistas e tecnólogos criativos. Esta documentação cobre os recursos exclusivos desenvolvidos para a versão 2.0.

Nota: Esta documentação refere-se à versão mais recente (2.0.8). Verifique o Changelog para histórico de atualizações.

Módulo de Vídeo

Um sistema completo de gerenciamento de playback e projeção multi-tela.

Múltiplas Telas

Gerencie janelas de saída independentes para diferentes projetores ou monitores.

Preview Dedicado

Visualize o conteúdo em tempo real na interface com controles de transporte (Play, Pause, Stop).

Transições

Suporte a Cut, Fade e Crossfade entre clips, com duração configurável por tela.

NDI Receiver

Recepção de vídeo via rede com alta performance usando o protocolo NDI®.

Recursos Principais

Renderização OpenGL: Pipeline gráfica otimizada garantindo 60fps estáveis.
Baixa Latência: Callbacks diretos reduzem o atraso para menos de 16ms (1 frame).
Auto-Discovery: Detecta automaticamente fontes NDI na rede local.
Modos de Exibição: Windowed (janela redimensionável) ou Fullscreen (exclusivo).

Requer a instalação do NDI Tools (NDI Runtime v4 ou v5). O Aparato detecta a instalação automaticamente.

Firmata (ESP32)

Controle físico robusto usando microcontroladores ESP32.

Diferenciais do Aparato

Diferente da implementação padrão, nosso módulo Firmata foi reescrito para estabilidade industrial:

WDT-Safe Firmware

Firmware customizado que previne reinicializações do Watchdog Timer (WDT) comuns no ESP32.

40 Pinos GPIO

Acesso a todos os pinos digitais (0-39), não apenas os 14 padrão do Arduino.

Auto-Upload

Grave o firmware diretamente pela USB sem precisar da IDE do Arduino. Inclui proteção para pinos de Flash (6-11).

System Config 24/7

Conjunto de ferramentas para preparar computadores para instalações permanentes (museus, galerias).

Funcionalidades

Energia: Desabilita Sleep, Hibernação de Disco e Display Sleep.
Rede: Watchdog que reinicia a interface de rede se a conexão cair.
Manutenção: Limpeza automática de cache e arquivos temporários.
Segurança: Desativação de Firewall e Notificações do Sistema para evitar interrupções.

Monitoramento OS

Mantenha a saúde do sistema sob controle.

Hardware

Temperatura de CPU/GPU, Uso de Disco e Consumo de Energia USB.

Watchdog de Processos

Monitora softwares críticos (ex: Resolume, TouchDesigner) e os reinicia se fecharem inesperadamente.

Application Launcher & Automation

Automação poderosa para iniciar aplicações e controlar softwares externos.

Comandos Disponíveis

Launch Application

Inicia qualquer aplicativo com opções de delay e argumentos. No módulo Resolume, inclui presets automáticos para:

Monitor de Saída 1 e 2
Advanced Output
Disparar Coluna 1

Send Key-Stroke

Envia atalhos de teclado para janelas específicas, mesmo se não estiverem em foco (macOS).

Ex: "Ctrl+S" para salvar, "F11" para tela cheia.

Importante (macOS): Para que o envio de teclas e automação funcionem, você deve conceder permissões de Acessibilidade ao Aparato em Configurações do Sistema > Privacidade e Segurança. O aplicativo solicitará essa permissão automaticamente se necessário.

Notificações Telegram

Receba alertas em tempo real no seu celular.

Crash Reports: Stack trace completo enviado se o Aparato fechar inesperadamente.
Alertas de Sistema: Notificações de disco cheio, alta temperatura ou queda de rede.

Interface & Clock

Novo painel de relógio integrado para controle de tempo em apresentações.

Relógio em tempo real de alta precisão.
Data formatada (padrão PT-BR).
Integração visual com o tema escuro do Aparato.