Colete todas as imagens de uma página da web e mande direto para o Fotos no seu Mac

O que a extensão lê, e o que ela não lê

O escaneamento é a parte que merece precisão, porque uma extensão de navegador que lê páginas é exatamente o tipo de coisa da qual você deveria desconfiar.

• Ela roda em uma aba, quando você pede. A extensão pede ao Safari acesso à aba ativa, a possibilidade de rodar o escaneamento naquela aba, e um canal até o app no seu Mac. Nada acontece até você abrir o pop-up e pressionar Escanear. O Safari afirma a mesma coisa, com as palavras dele, no painel de Extensões: a página da aba atual, quando você usa a extensão.
• Ela coleta endereços, não imagens. O que atravessa do Safari para o app é uma lista de URLs de imagem, o endereço da página e o título dela. O download é feito depois, pelo app, direto do site.
• Ela não tem para onde mandar nada. Não há conta no Emerald Tools, não há servidor operado pelo desenvolvedor, e não há analytics no app nem na extensão. A fila entre a extensão e o app é um armazenamento de preferências compartilhado dentro do seu próprio Mac.
• As miniaturas são desenhadas localmente. As pré-visualizações do pop-up são feitas a partir das imagens que a página já carregou, reduzidas a 128 pixels no lado maior dentro do navegador. Elas não são buscadas em nenhum outro lugar e não são guardadas.

Como o escaneamento encontra imagens que um clique direito não alcança

Uma página moderna raramente contém todas as suas imagens ao mesmo tempo. Galerias montam e desmontam imagens conforme você rola, layouts responsivos descrevem vários tamanhos da mesma figura e deixam o navegador escolher, e imagens decorativas muitas vezes nem são imagens do ponto de vista do documento — são fundos aplicados em CSS.

O escaneamento é construído em torno disso. Ele desce a página uma tela por vez, até o equivalente a trinta telas, e faz um inventário a cada passo, e não só no fim. Isso importa para listas com janelamento, em que uma imagem só existe enquanto está perto da área visível: quando você rola de volta, ela já sumiu de novo. Qualquer coisa que role para os lados é percorrida do mesmo jeito, até vinte larguras. Terminada a caminhada, o escaneamento espera as imagens ainda em trânsito concluírem, faz um último inventário e restaura a sua posição de rolagem.

Junto com as imagens que a página desenhou, ele lê os endereços que a página apenas menciona: as alternativas de um srcset, os atributos de carregamento tardio que guardam o endereço real até um script trocá-lo, os fundos declarados em CSS, a og:image destinada às pré-visualizações sociais, e a marcação de reserva dentro de um bloco noscript. Essas referências costumam chegar sem dimensões, então a extensão busca cada uma delas uma vez, com um limite de dois segundos, para medi-la e fazer uma pré-visualização. O que não puder ser medido continua sendo oferecido a você — uma imagem sobre a qual o escaneamento ficou em dúvida é pior escondida do que exibida.

Da página para o Fotos, em uma rodada

Pressionar Coletar entrega a sua seleção e encerra o trabalho do pop-up. Do lado do Mac, o app abre o Coletor, pula direto para a pergunta que só você pode responder — para onde isso vai — e preenche o nome do álbum novo com o título da página, que é quase sempre o rótulo que você teria digitado.

O download que vem em seguida é deliberadamente sem pressa. Três arquivos por vez por padrão, meio segundo entre um terminar e o próximo começar, até três novas tentativas por arquivo com dois, quatro e oito segundos entre elas, e um cabeçalho Referer nomeando a página de onde as imagens vieram, porque um bom número de sites entrega imagens apenas a requisições que pareçam vir das páginas deles. Um 404 não é repetido; não há nada ali pelo que esperar. A rodada inteira é escrita em um registro na tela conforme acontece, uma linha por arquivo, com o tamanho e o formato que ele acabou sendo.

Os formatos são decididos pelo arquivo, não pelo endereço. Os primeiros bytes de cada download o identificam como WebP, PNG, JPEG ou GIF, e ele é salvo com a extensão correspondente — então um arquivo servido por uma URL terminada em .jpg vai chegar como .webp se for isso que ele é, e o Fotos vai aceitá-lo em vez de engasgar com um arquivo mal rotulado. O que o app não conseguir identificar mantém a extensão do endereço.

Depois vem o tratamento do WebP animado. Ele é convertido em MP4, os originais são descartados, e se a conversão produziu vários clipes o app verifica se algum deles são pedaços consecutivos da mesma animação — comparando o último quadro de um com o primeiro quadro do seguinte — e junta os que combinam, guardando os pedaços para que a junção possa ser refeita. Esse é o único caso em que uma tela de revisão aparece antes da importação: miniaturas de tudo o que foi coletado, com os clipes convertidos marcados como tais, um clique direito para pré-visualizar no QuickTime Player, e um botão de importação que leva apenas o que continuar marcado. Quando nada precisou de conversão não há nada a revisar, e a importação corre sozinha. A conversão é uma ferramenta por direito próprio dentro do Emerald Tools, com ajustes próprios, e há um guia separado sobre converter WebP animado em MP4.

Quando um site reage

Coletar as imagens de uma página são mais requisições por minuto do que uma pessoa navegando faz, e alguns sites tratam isso como algo a ser barrado. O app fica atento a três sinais: um 403, um 503 e — o que pega as pessoas de surpresa — uma resposta 200 normal cujo tipo de conteúdo é HTML, que é o que uma verificação antirrobô devolve quando decide mostrar uma página de desafio no lugar da figura que você pediu.

Três dessas seguidas e a rodada pausa, em vez de moer o resto da lista e falhar em tudo. Você recebe uma notificação, o ícone no Dock pede atenção, e o app oferece abrir o site em uma folha para você entrar na conta ou resolver o desafio. Pressione Concluído e ele retoma com a sessão que você acabou de estabelecer; os arquivos recusados voltam para a fila em vez de serem dados como perdidos. Tudo o que já foi baixado permanece onde está.

Se você estiver coletando de um site que limita a taxa de forma agressiva, o ajuste de simultaneidade é a alavanca — o próprio app avisa que passar de cinco conexões pode provocar um limite — e reduzi-lo não custa nada além de tempo.

Especificações e limites

Tudo abaixo é o comportamento da versão atual, não um plano.

• Nome da extensão no Safari: Emerald Tools - Coletor de imagens, listada em Extensões nos ajustes do Safari.
• Permissões da extensão: a aba ativa, a possibilidade de rodar o escaneamento nela, e um canal até o app. Sem acesso permanente a outras abas e sem permissões de host.
• O que o escaneamento lê: elementos img e os atributos de carregamento tardio deles, opções de srcset em img e picture, imagens de fundo em CSS, og:image, e elementos img dentro de noscript.
• O que ele ignora: tudo o que não for um endereço http ou https, URIs de dados embutidos incluídos. Endereços duplicados são fundidos em uma única entrada.
• Profundidade do escaneamento: até trinta alturas de tela descendo a página, e até vinte larguras atravessando qualquer contêiner de rolagem horizontal.
• Miniaturas: geradas no navegador com 128 pixels no lado maior. As imagens que a página não dimensionou são buscadas de novo uma vez, com limite de dois segundos, para serem medidas.
• Filtro de tamanho: Larg mín e Alt mín em pixels; 0 desliga aquela dimensão. Imagens de tamanho desconhecido são mantidas.
• O que atravessa para o app: os endereços das imagens selecionadas, o endereço da página e o título da página. Não as imagens.
• Fila: mantida no seu Mac entre a extensão e o app, então coletar com o app fechado funciona; a fila é recolhida na abertura seguinte.
• Assistente: Destino, Coletar e Conversão. A etapa de Conversão desaparece quando a conversão automática está desligada.
• Destinos: um álbum novo, uma pasta nova com um álbum dentro, um álbum novo dentro de uma pasta existente, um álbum existente, ou a fototeca sem álbum.
• Download: três arquivos por vez por padrão, ajustável de um a dez; meio segundo entre um terminar e o próximo começar; um cabeçalho Referer nomeando a página de origem; tempo limite de 60 segundos por arquivo.
• Novas tentativas: três por padrão, ajustável de zero a dez, esperando dois, quatro e oito segundos. Um 404 não é repetido.
• Condições de pausa: três respostas consecutivas de 403, 503 ou HTML no lugar de imagem. Retomar recoloca na fila o que foi recusado.
• Tratamento de formatos: WebP, PNG, JPEG e GIF identificados pelos primeiros bytes do arquivo; a extensão salva segue o arquivo, não o endereço.
• Conversão: WebP animado para MP4, ligada por padrão. Imagens estáticas não são tocadas. Clipes consecutivos são unidos automaticamente, com os pedaços preservados.
• Importação: para o Fotos em lotes de cinquenta, repetidos um a um se um lote falhar, com um recurso a PNG para qualquer imagem estática que o Fotos não aceitar.
• Histórico: o título da página, o endereço, a contagem e o destino de cada rodada, guardados para as cinquenta rodadas mais recentes e por catorze dias, apagáveis a qualquer momento.
• Permissões: acesso à sua Fototeca, solicitado quando a importação começa. Nenhuma gravação de tela e nenhum acesso de acessibilidade são necessários para esta ferramenta.
• Transmissão: para o site de onde você coletou, e para nenhum outro lugar. Sem conta, sem analytics, sem servidor.
• Requisito de sistema: macOS 14.0 (Sonoma) ou posterior.