Hazel Contents Contain Não Funciona: Por Que Acontece e Como Resolver

Se a condição Contents Contain do Hazel não está funcionando, olhe primeiro para o que ela realmente lê antes de procurar em qualquer outro lugar: não o arquivo, mas o índice que o Spotlight fez dele. Quando o Spotlight ainda não indexou alguma coisa — um arquivo novo, um arquivo sincronizado de um serviço de nuvem, uma pasta excluída da busca — a condição não encontra nada, mesmo com o texto parado bem ali dentro do documento. O próprio fórum de suporte da Noodlesoft dá a correção direto: troque a regra para Contents Contain Match, que lê o arquivo em si e ignora o Spotlight por completo. É mais lento. A Noodlesoft fala isso abertamente. Mais lento e certo vale mais que rápido e errado.

Essa correção resolve a maioria dos casos em menos de um minuto. O resto deste artigo cobre por que o problema acontece, mais três coisas que vale a pena checar se só trocar a condição não resolver de vez, e onde a correspondência de conteúdo do Hazel ainda ganha de qualquer alternativa, File Arbor incluso.

Por Que o Contents Contain do Hazel Para de Corresponder?

O Hazel tem duas condições separadas para checar o que existe dentro de um arquivo, e elas funcionam de formas completamente diferentes. O Contents Contain pergunta ao Spotlight se uma palavra aparece em um arquivo — ele nunca abre o arquivo em si. O Contents Contain Match abre o arquivo e procura o texto diretamente.

Esse é um design razoável. O índice do Spotlight é rápido, e na maior parte do tempo é preciso. O problema é o intervalo entre "o arquivo existe" e "o Spotlight terminou de indexar o arquivo". Um arquivo que caiu em uma pasta monitorada há poucos segundos pode ainda não estar pesquisável. Um arquivo sincronizado do iCloud Drive, Dropbox ou OneDrive pode ficar sem indexação por minutos, principalmente no meio de um download ou em um cliente de sincronização em versão beta. Um arquivo em um disco externo, em um compartilhamento de rede, ou em qualquer coisa coberta pelas exclusões de Privacidade do Spotlight do macOS simplesmente não aparece em uma busca do Spotlight — o que significa que o Contents Contain também não vai vê-lo, não importa quantas vezes a regra rode.

Nada disso é um bug na sua regra. A regra está checando um índice, e o índice é a coisa que está atrasada. O Hazel roda a regra corretamente toda vez; ele só recebe um "não" do Spotlight quando a resposta honesta seria "ainda não".

A Solução Real: Mude Para Contents Contain Match

Abra a regra, encontre a condição de conteúdo e mude o menu de Contents Contain para Contents Contain Match. Essa é a correção inteira para a maioria das pessoas, e é a que o fórum da Noodlesoft recomenda sempre que alguém relata uma falha de correspondência que acaba sendo um intervalo de indexação.

O Contents Contain Match não pergunta nada ao Spotlight. Ele abre o arquivo, extrai o texto e procura no momento em que a regra roda. Não existe índice para ficar atrasado, nenhuma lista de exclusão para atrapalhar, nenhuma espera por um processo em segundo plano se atualizar. O custo é velocidade — ler um arquivo diretamente demora mais que consultar uma tabela — mas para a maioria dos volumes de uma pasta Downloads ou Documents, essa diferença não é algo que você vai notar.

Se você mantém dezenas de regras que usam Contents Contain, não precisa reconstruí-las do zero. Abra cada uma, troque o único menu suspenso e salve. É repetitivo para uma biblioteca grande de regras, mas é uma edição mecânica, não um redesenho.

Três Verificações Antes de Reconstruir Todas as Regras

Trocar para Contents Contain Match resolve o sintoma. Se você quer entender por que o Spotlight perdeu o arquivo, ou prefere manter a condição mais rápida onde for seguro, essas três verificações cobrem o resto das causas reais.

1. Reindexe a pasta específica. Procure por uma palavra do arquivo usando o Spotlight ou uma janela do Finder. Se o arquivo não aparecer, o Spotlight realmente ainda não o indexou. A Apple documenta uma correção pontual: adicione a pasta à lista de Privacidade do Spotlight, espere alguns segundos e remova-a de novo. O Spotlight trata a remoção como um sinal para reindexar aquela pasta do zero, o que é mais rápido do que reindexar um volume inteiro.
2. Confira a própria lista de exclusões de Privacidade. Abra Ajustes do Sistema → Spotlight → Privacidade da Busca (Preferências do Sistema → Spotlight → Privacidade em versões mais antigas do macOS) e confirme que a pasta monitorada — e qualquer pasta pai, disco externo ou volume de rede onde ela está — não está excluída. Uma pasta pode acabar aqui por acidente, principalmente depois de restaurar um backup ou migrar para um Mac novo.
3. Confirme que o arquivo tem mesmo uma camada de texto. Abra o PDF na Pré-visualização e tente arrastar o cursor sobre uma linha de texto. Se nada for destacado, não há camada de texto para procurar — o documento é uma imagem escaneada ou uma foto — e nenhuma das duas condições do Hazel vai corresponder a ele sem OCR, o que é um recurso separado, coberto a seguir.

O Que o Hazel 6 Consegue Fazer Que o File Arbor Não Consegue?

Vale dizer isso de forma direta, porque é a resposta honesta: se seus arquivos são majoritariamente PDFs criptografados, o Hazel é a ferramenta melhor para esse trabalho, e nada abaixo muda isso.

O Hazel 6 adicionou reconhecimento de texto na hora — a própria documentação da Noodlesoft descreve como OCR que roda em imagens e em PDFs que ainda não têm uma camada de texto, antes de uma regra tentar a correspondência. Isso significa que uma fatura escaneada ou a foto de um recibo tirada pelo celular, algo sem nenhum texto extraível de verdade, ainda pode corresponder a uma regra do Hazel. O Hazel 6 também adicionou a possibilidade de informar uma senha para um PDF criptografado, então um documento bloqueado não simplesmente falha em silêncio.

Antes da 1.3.0, o File Arbor não fazia nenhuma das duas coisas. Desde então, uma regra Pro configurada para ler também documentos digitalizados roda OCR em PDFs digitalizados e em imagens JPEG, PNG e TIFF, lendo a primeira e a última página de cada um. PDFs protegidos por senha continuam fora de alcance — não existe opção de senha — e essa é uma lacuna real, não uma nota de rodapé menor. É o motivo mais claro para um usuário de Mac com documentos criptografados continuar no Hazel em vez de trocar.

Contents Contain vs. Contents Contain Match em Resumo

Onde o File Arbor Se Encaixa — e Onde Não Se Encaixa

Se o que te trouxe até aqui foi querer o mesmo tipo de regra de conteúdo sem precisar pensar em uma dependência do Spotlight, esse é o único ponto em que o File Arbor fica mais perto do Contents Contain Match do que do Contents Contain. A condição conteúdo contém dele — um recurso do plano Pro — lê o texto de um arquivo diretamente, sem nenhum índice de busca no meio, nos dois sistemas operacionais em que roda. Uma regra que corresponde a joao também corresponde a João, já que a comparação ignora maiúsculas e acentos, e ela roda do mesmo jeito no Windows e no macOS. Ele lê PDFs com camada de texto, arquivos DOCX e texto simples e, desde a 1.3.0, PDFs digitalizados e fotos quando a regra está configurada para lê-los, mas a mesma lista de lacunas vale aqui como em qualquer outro lugar onde a correspondência de conteúdo aparece: sem planilhas, sem cabeçalhos, rodapés ou notas de rodapé de DOCX, e sem PDFs criptografados.

Essa última parte é a diferença que realmente vale a pena nomear. As condições de conteúdo do Hazel são só para macOS. As do File Arbor são multiplataforma — a mesma regra, monitorando uma pasta, no Windows ou no Mac, a partir de um único aplicativo. Para um fluxo de trabalho só de Mac, isso não é motivo para trocar; o Hazel já faz o que você precisa, e faz mais ainda quando PDFs criptografados entram em cena. Só importa se você também mantém regras em uma máquina Windows e quer que elas correspondam.

Também vale ser preciso sobre o que as condições de conteúdo do File Arbor fazem: elas escolhem uma pasta de destino, nada além disso. Puxar texto de um documento para um nome de arquivo novo é um recurso Pro separado, adicionado na 1.3.0: você clica uma vez em um valor, como a data de uma fatura, em um documento de exemplo, e a regra monta o nome do arquivo e as pastas a partir dele; o Hazel consegue fazer isso também, com um token de correspondência capturado. Para um panorama mais amplo do que a organização por conteúdo consegue e não consegue fazer entre as ferramentas, veja nosso guia de como organizar arquivos por conteúdo.

Qual Correção Você Deve Tentar Primeiro?

"Minha regra correspondia ontem e parou de corresponder hoje, mesma pasta, mesmos arquivos." Troque essa regra para Contents Contain Match primeiro. Isso quase sempre é um intervalo de indexação, e a variante Match evita o problema por completo.

"O arquivo está no OneDrive, no Dropbox ou em um disco externo." Confira a Privacidade do Spotlight para aquele volume antes de qualquer outra coisa. Clientes de sincronização em nuvem e discos externos são os lugares mais comuns onde uma pasta acaba excluída sem ninguém fazer isso de propósito.

"Eu mesmo copiei e colei o texto do PDF e ele com certeza está ali dentro." Descarte a camada de texto em seguida — o teste de seleção de texto na Pré-visualização leva dez segundos e diz na hora se o OCR é mesmo a peça que falta.

"Tenho documentos escaneados ou PDFs protegidos por senha e nada disso se aplica." Continue no Hazel e use as opções de OCR e senha dele. Uma correção do Spotlight não resolve isso, e embora o File Arbor Pro leia documentos escaneados desde a 1.3.0, ele não consegue abrir PDFs protegidos por senha — essa é uma vantagem real do Hazel, e não é uma que este artigo consiga te convencer a abandonar.

"Quero a mesma regra de conteúdo em uma máquina Windows também." Esse é o único caso em que vale a pena olhar o File Arbor — não como substituto do Hazel, mas como forma de rodar uma regra equivalente em uma segunda plataforma que o Hazel não alcança.

Mantendo as Regras de Conteúdo Confiáveis Daqui Para Frente

Use Contents Contain Match por padrão em qualquer regra que monitore uma pasta sincronizada com um serviço de nuvem ou que viva em uma mídia removível — o pequeno custo de velocidade vale a pena para nunca precisar se perguntar se o Spotlight já alcançou o arquivo. Reserve o Contents Contain simples para pastas no seu disco interno principal, onde você já confirmou que a indexação acompanha o ritmo, já que é a opção mais rápida quando o índice está realmente em dia.

Teste uma regra de conteúdo nova contra um arquivo que você já sabe que corresponde, antes de confiar nela para os próximos arquivos que chegarem. Uma regra que silenciosamente não faz nada é muito mais difícil de perceber do que uma regra que dispara quando não deveria, e condições de conteúdo são exatamente o tipo de regra que falha em silêncio quando a extração de texto por trás dela — do Spotlight ou de uma leitura direta — não encontra nada.

FAQ

Por que a condição Contents Contain do Hazel não está correspondendo aos meus arquivos?

O Contents Contain busca no índice do Spotlight, não no arquivo em si. Se o Spotlight ainda não indexou o arquivo — porque ele é novo, foi sincronizado de um serviço de nuvem, está em um disco externo ou a pasta foi excluída na Privacidade do Spotlight — a condição não encontra nada, mesmo com o texto claramente presente no documento. O próprio fórum da Noodlesoft confirma que essa é a causa mais comum.

Qual é a diferença entre Contents Contain e Contents Contain Match no Hazel?

O Contents Contain consulta o índice do Spotlight e é rápido; o Contents Contain Match lê o arquivo diretamente, é mais lento, mas não depende do Spotlight de jeito nenhum. A Noodlesoft recomenda a segunda opção sempre que a primeira deixa passar um arquivo que deveria corresponder, já que uma leitura direta não é enganada por um índice desatualizado ou incompleto.

Como resolvo o Contents Contain do Hazel quando ele para de funcionar?

Abra a regra e troque a condição de Contents Contain para Contents Contain Match — essa é a correção que a própria Noodlesoft recomenda, e funciona porque a variante Match lê o texto do arquivo diretamente em vez de depender do Spotlight. Se isso não resolver, confirme que o Spotlight realmente indexou a pasta e que o arquivo tem uma camada de texto de verdade, não só uma imagem escaneada.

O Hazel consegue ler PDFs escaneados ou fotos de documentos?

Sim, a partir do Hazel 6. A Noodlesoft adicionou reconhecimento de texto na hora, que roda OCR em imagens e em PDFs sem camada de texto antes de tentar a correspondência, além de uma opção para informar a senha de PDFs criptografados. Versões anteriores do Hazel e a maioria dos concorrentes baseados em regras não conseguem ler um arquivo sem nenhuma camada de texto; o File Arbor Pro consegue desde a 1.3.0, mas não tem opção de senha.

O File Arbor tem a mesma dependência do Spotlight que o Hazel?

Não. As condições de conteúdo do File Arbor leem o texto do arquivo diretamente, do mesmo jeito que o Contents Contain Match do Hazel, então não existe um índice de busca que possa ficar desatualizado ou excluir uma pasta. A troca é a mesma que o próprio Hazel aceita na sua opção de leitura direta: ler o arquivo é mais lento que consultar um índice, mas nunca depende de o Spotlight ter chegado primeiro até o arquivo.

O File Arbor pode substituir o Hazel para OCR ou PDFs criptografados?

Para digitalizações, sim, desde a 1.3.0, embora o File Arbor Pro leia só a primeira e a última página; para PDFs criptografados, não. Ele não consegue abrir um PDF protegido por senha, então um documento criptografado nunca vai corresponder a uma regra de conteúdo no File Arbor. O Hazel 6 faz as duas coisas. Se seus arquivos são majoritariamente PDFs criptografados, o Hazel é a opção mais adequada; a vantagem do File Arbor é rodar as mesmas regras de conteúdo no Windows e no Mac sem depender do Spotlight.

Na Prática

O Contents Contain do Hazel não está quebrado — ele está respondendo com honestidade sobre o que o Spotlight indexou, o que nem sempre é a mesma coisa que está de fato no arquivo. Troque a regra para Contents Contain Match e o intervalo do Spotlight desaparece por completo. Se PDFs criptografados fazem parte do seu fluxo de trabalho, o suporte a senha do Hazel 6 faz algo que nenhuma correção do Spotlight e nenhuma regra do File Arbor conseguem hoje.

Se você também mantém arquivos no Windows e quer o mesmo tipo de regra de conteúdo lá, o plano gratuito do File Arbor já é suficiente para testar uma regra nos seus próprios arquivos antes de decidir se vale a pena usar ao lado do Hazel, não no lugar dele. Veja os preços para saber o que as condições de conteúdo do plano Pro incluem.