zebian.

Projeto · online

ReelStills

Vejo muitos filmes e, de vez em quando, um plano faz-me carregar no pause. Queria guardar esse fotograma exato, em alta resolução, com um clique. Montei um botão dentro do meu Jellyfin e um site público onde esses frames vivem.

Página inicial do ReelStills, com um fotograma do Eternal Sunshine of the Spotless Mind em destaque no topo e uma grelha de stills por baixo.

Vejo muitos filmes. E há sempre aquele plano que me faz carregar no pause: a luz, o enquadramento, uma cor que fica. Durante anos a minha reação foi tirar uma fotografia ao ecrã com o telemóvel, que é exatamente a pior maneira de guardar um frame. Sai tremido, com reflexos da sala, na resolução errada, e quase nunca no instante certo.

O que eu queria era fácil de dizer e chato de fazer: estar a ver um filme no meu Jellyfin (o servidor de media que tenho em casa), carregar num botão, e ter o fotograma exato que estava no ecrã, em resolução total, guardado num sítio bonito. Sem screenshot, sem latência, sem apanhar o frame do lado.

Chama-se ReelStills, é grátis, e vive em reelstills.com.

O frame tem de ser o exato

Este foi o problema central, e o que tornou tudo possível. Tirar uma captura de ecrã, ou carregar num botão remoto, traz sempre meio segundo de atraso. Meio segundo num filme a 24 imagens por segundo são doze frames de diferença. Apanhas o ator a piscar o olho em vez do plano que querias.

A solução foi parar de pensar em “capturar o ecrã” e passar a pensar em “registar a posição”. O botão que injetei dentro do leitor do Jellyfin não fotografa nada: lê a posição exata da reprodução no instante do clique, ao milésimo de segundo, e manda só esse número para o servidor. O servidor, esse, vai ao ficheiro original do filme e corta o fotograma exato nessa posição com o ffmpeg, em resolução máxima e sem perdas.

Como o corte é feito a partir do ficheiro, e não do que está a passar no ecrã, o resultado é sempre o frame certo. Carrego no botão, e poucos segundos depois o still aparece no site, no filme certo, com os metadados todos. Não tenho de fazer mais nada.

O olho do HAL 9000, em 2001: A Space Odyssey, cortado diretamente do ficheiro do filme. É este o fotograma exato que estava no ecrã, em resolução total.

De um script a um sítio a sério

A primeira versão era um script que despejava o PNG numa pasta. Funcionava, mas uma pasta cheia de ficheiros não é uma galeria.

Por isso, peça a peça, foi crescendo: uma base de dados, os metadados ricos puxados da mesma fonte que o Jellyfin usa (título, ano, realizador, diretor de fotografia, sinopse), e um site feito em condições. Os stills passaram a estar organizados por filme, e nas séries por temporada e episódio. Cada fotograma tem direito à sua própria página, com a resolução, o rácio de aspeto, e um botão para descarregar em PNG ou JPEG, em vários tamanhos.

Há um site de referência que faz isto muito bem, o StillsLab. Estudei-o com calma e copiei descaradamente a linguagem visual: o fundo escuro, o amarelo, a grelha densa, os títulos grandes. Mas mantive as coisas que são minhas e que ele não tem: a precisão ao frame, a análise de cor, e umas tags que vou explicar a seguir.

As cores e as tags, que é onde fica giro

Cada still é analisado pelas suas cinco cores dominantes. Aquela barra de cores por baixo da imagem não é decoração: dá para navegar o site por cor. Apetece-me uma referência azul, ou em tons quentes, ou a preto e branco? Há uma página para cada.

Página de navegação por cor, com mosaicos grandes para vermelho, amarelo, azul, castanho, cinzento e preto.

E depois há as tags. Cada frame que entra passa por um modelo de visão (o Claude, da Anthropic) que olha para a imagem e descreve o que lá está: “close-up”, “low-key lighting”, “prison cell”, “two people”, “melancholic”, “film noir aesthetic”. Não sou eu a escrever isto, é a máquina a ver o fotograma. Cada tag vira uma página própria, e de repente o site tem centenas de portas de entrada: dá para cair no ReelStills à procura de “golden hour” ou “neon” e encontrar exatamente isso.

Página de tags do ReelStills, uma nuvem de etiquetas dimensionadas pela frequência: close-up, interior, dramatic lighting, low-key lighting, e muitas mais.

O que correu mal (que foi quase tudo, a certa altura)

Um making-of honesto conta os becos sem saída, não a versão polida. E houve becos.

Os botões invisíveis. O visualizador de imagem abria, mas os botões de fechar e de descarregar não apareciam. Demorei a perceber: estavam lá, só que escondidos por trás do cabeçalho do site. Era um daqueles problemas de camadas em que um elemento da página prende outro por baixo dele, por mais que eu lhe mandasse subir. A solução foi renderizar o visualizador fora da página, por cima de tudo.

O domínio que afinal estava ocupado. Eu queria o stillframes.com. A minha primeira verificação de disponibilidade mentiu-me, deu vários domínios como livres que afinal estavam registados há mais de vinte anos. Quase festejei um domínio que era de outra pessoa desde o ano 2000. A lição: confirmar os sinais de que está registado, não a ausência de sinais. Acabei no reelstills.com, que por acaso até é melhor.

O DNS, que é sempre o DNS. Mudei a gestão do domínio para a Cloudflare e o servidor antigo continuou, durante horas, a responder a meia internet com uma página de parking morta. Metade das pessoas via o site, a outra metade via um endereço que não existia. Para piorar, sobrava um registo de IPv6 a apontar para o vazio, e os browsers modernos tentam o IPv6 primeiro: davam erro logo à entrada. Passei um bom bocado no clássico “mas a mim funciona”.

O certificado teimoso. A interface que gere os proxies recusou-se a emitir o certificado de segurança. Lá o fiz à mão, por linha de comandos, e funcionou à primeira. Às vezes o botão bonito é que está estragado.

O botão que desaparecia em casa. Quando abro o meu Jellyfin pela rede privada (em vez do endereço público), o botão de captura sumia-se. O código do botão estava a ser procurado num caminho relativo, e pela rede privada esse caminho batia no próprio Jellyfin, que não o tem. Bastou passar a usar o endereço absoluto e abrir a permissão certa entre origens. Pormenor pequeno, tarde a apanhar.

Apaguei um sem querer, e voltou

A dada altura pus um botão para apagar stills (só eu o vejo). E, claro, apaguei um por engano. Mas como a captura é determinística, o instante exato fica gravado no próprio nome do ficheiro, bastou voltar a capturar nessa posição: frame idêntico, de volta em segundos. Apagar passou a ser reversível, desde que o filme continue na minha biblioteca. Há uma certa paz nisso.

O que fica

Está no ar, é público, e cresce sozinho conforme vou vendo coisas. Qualquer pessoa pode navegar e descarregar, sempre em resolução total. Tem analytics que corre no meu próprio servidor (não mando nada para ninguém), e foi construído a pensar nos motores de busca: cada filme, cada cor, cada tag é uma página que pode ser encontrada.

Não é uma startup, não tem plano de negócio, não vai escalar. É um sítio pessoal, feito por gosto, onde guardo os planos que me ficam na cabeça. Falta só dizer ao Google que existe.

Se vires um frame teu por lá, é porque também me parou.