Joao Figueredo

O que é e como usar o software de João Figueredo

João Figueredo é um desenvolvedor brasileiro conhecido principalmente no meio de automação e scripting. Ele criou ferramentas que giram em torno de processamento de vídeo e manipulação de arquivos multimídia, com destaque para um player e vários utilitários de linha de comando que ganharam tração no Brasil por serem leves e open source. A gente vai falar aqui de como baixar, instalar e configurar as ferramentas dele de forma prática. Nada de introdução longa. Vamos direto.

João Figueredo — download e instalação

O repositório oficial fica no GitHub. O link é https://github.com/joaofigueredo . Lá você encontra os projetos separados por repositório, então não é um pacote único com tudo junto. Se você quer o player de vídeo, entra no repo figueredo-player. Se quer os utilitários de script, vai no figueredo-utils. A instalação básica é a mesma pra maioria dos projetos dele: clone o repositório, entre na pasta e rode o script de build. No Windows eu sempre uso PowerShell, no Linux faço pelo terminal mesmo.

No Windows: git clone https://github.com/joaofigueredo/figueredo-player.git
cd figueredo-player
.\build.ps1

No Linux: git clone https://github.com/joaofigueredo/figueredo-player.git
cd figueredo-player
./build.sh

Depois do build, o executável vai parar numa pasta dist ou bin, depende do projeto. Coloca essa pasta no seu PATH pra não precisar navegar até ela toda vez.

Uso prático do player do João Figueredo

O player dele é diferente da maioria. Ele não depende de codecs proprietários. Usa decoding por CPU com bibliotecas abertas. Isso significa que funciona bem em máquinas sem GPU dedicada, o que é raro encontrar hoje em dia. Os comandos principais são simples. Abre um arquivo:

figueredo-player arquivo.mp4 Play com timestamp específico:

figueredo-player arquivo.mkv --start 125.5 Sair sem fechar a janela (útil pra debugging):

figueredo-player arquivo.avi --no-auto-exit Ele também aceita stdin. Você pode encadear com outros utilitários. Isso é onde as ferramentas dele brilham mesmo — no pipe de dados.

Problemas que eu encontrei na prática e como resolvi

Em 2023, eu precisava rodar o figueredo-player num servidor Debian 11 sem interface gráfica, só pra validar arquivos de vídeo em lote. O player travava ao iniciar, retornando um erro vago sobre SDL2. A solução foi mais chata do que técnica. O problema era que o Debian 11 vinha com uma versão do SDL2 que tinha uma incompatibilidade com a biblioteca de rendering que o jogador usava por padrão. Eu tentei atualizar o SDL2, mas o repositório stable não tinha versão mais nova. A saída foi compilar o SDL2 do source eu mesmo, num diretório local, e apontar as variáveis de ambiente pra ele antes de rodar o player.

Antes de executar, eu configurava assim: export SDL2_LIB=/home/meu_usuario/libsdl2_custom/lib
export SDL2_INC=/home/meu_usuario/libsdl2_custom/include
figueredo-player --headless lista_arquivos.txt

Com isso, o player funcionou perfeitamente em modo headless. Rodava uns 40 arquivos de vídeo por minuto validando resolução, codec e duração. Levava cerca de 3 minutos pras 150 mídias que eu tinha na fila. Outro ponto: se você tentar rodar o figueredo-player com um arquivo de áudio flácido dentro de um container MKV muito grande (mais de 8 gigas), o player tende a travar nos primeiros segundos. O workaround que eu encontrei foi converter o arquivo pra MP4 com ffmpeg antes, usando o stream cópia, sem reencode. Fica rápido e o player lê normalmente. Isso economiza uns 20 segundos por arquivo que seria perdido em travamento e reinício manual.

Dicas avançadas que ninguém costuma mencionar

Muita gente não sabe, mas o figueredo-player suporta metadata customizado. Você pode passar um arquivo JSON com configurações de cor, aspect ratio e até overlays. O formato é esse: {"colorspace": "rec709", "overlay_text": "teste", "font_size": 24}

Passando pela linha de comando: figueredo-player video.mp4 --config overlay.json

Isso é útil pra quem precisa gerar thumbnails padronizados em massa. Eu usei pra criar uma galeria de vídeos corporativos com legendas fixas no canto inferior direito. O resultado ficou consistente em todos os arquivos. Outra coisa que passa despercebida: o jogador exporta logs detalhados se você ativar o flag --verbose. O log mostra o decoder usado, o tempo de fps real, e eventuais drops. Quando você tá diagnosticando problemas de performance, esse log é mais útil do que qualquer profiler gráfico.

Limitações e quandonasão usar

As ferramentas do João Figueredo são boas pro que se propõem, mas têm limitações claras. Elas não rodam em Android nem iOS. Se você precisa de compatibilidade mobile, esquece. O foco é desktop Linux e Windows. O suporte a HLS e DASH é muito limitado. Se você trabalha com streaming adaptativo, vai precisar de algo como VLC ou MPV. O player do Figueredo lê arquivos locais e fluxos RTMP simples, mas nada avançado de CDN.

Também não tem interface gráfica com controles visuais completos. Tudo é via teclado e linha de comando. Se você precisa de uma GUI com botões bonitos, não é essa a ferramenta. O MPV é uma alternativa melhor nesse caso, especialmente se você quer controles na tela. Outro ponto: a documentação é em português e às vezes incompleta. Se você tiver um problema específico que não está nos issues do GitHub, vai precisar ler o código-fonte pra entender o que acontece. Isso não é grave pra quem programa, mas pode frustrar usuários casuais.

Conclusão prática

Se você precisa de um player leve, open source, que rode bem em hardware modesto e aceite automação via linha de comando, o figueredo-player vale a pena. A instalação é direta, o uso básico é intuitivo, e os recursos avançados — como metadata JSON e logs verbose — aparecem quando você mais precisa deles. O custo principal é o tempo que você gasta lendo o repositório e os issues pra resolver problemas que a documentação não cobre. Se você não se importa com isso, começa a usar hoje mesmo.