Pourquoi mon plug-in Quick Look installé avec Homebrew ne fonctionne-t-il plus ?
Homebrew désactive un cask pour l’une de deux raisons bien distinctes : il échoue au contrôle Gatekeeper d’Apple, ou il ne remplit plus les critères d’acceptation de Homebrew. Voici précisément quels plug-ins Quick Look chaque raison a touchés, ce que cela casse et ne casse pas, et comment vérifier votre propre Mac en dix secondes.
Par Ram Velmurugan · Founder & Lead Developer, 1dot.ai
glance-chamburr a été désactivé pour fails_gatekeeper_check, ce qui signifie que son app n’a jamais été signée ni notarisée par Apple. Les cinq autres, qlstephen, qlcolorcode, quicklookase, webpquicklook et quicklook-json, portent un code de raison distinct, no_longer_meets_criteria, et n’ont jamais été signalés pour un problème de signature. Tous les cinq utilisent en outre la déclaration d’artefact qlplugin, héritée de Homebrew, c’est-à-dire le format de bundle .qlgenerator qu’Apple ne charge plus depuis macOS 15 Sequoia (octobre 2024). C’est une seconde raison, sans lien avec la première, pour laquelle ces plug-ins ne font plus rien sur un Mac récent. Un cask désactivé ne peut tout simplement plus être installé ni mis à jour via brew. Il ne désinstalle pas la copie que vous avez déjà, et il ne signifie pas que le plug-in est dangereux. Il est seulement non signé ou, pour les cinq autres, plus du tout accepté par Homebrew.Note de la rédaction : 1dot.ai édite Quick X Folder Preview, une application d’aperçu de dossiers pour Mac citée vers la fin de ce guide. Elle est notarisée par Apple depuis le premier jour, n’a donc jamais été concernée par ce contrôle et ne joue aucun rôle dans les faits ci-dessus. Chaque citation de la politique de Homebrew, chaque état de cask et chaque date ci-dessous ont été vérifiés en direct le 13 novembre 2026, dans la documentation, les notes de version et l’API formulae de Homebrew. Les sources figurent en bas de page.
L’essentiel
Si un brew install --cask ou un brew upgrade échoue soudain pour un plug-in Quick Look, ou si Homebrew affiche un avertissement orange d’obsolescence la première fois que vous y touchez, ce n’est presque certainement pas un bug du plug-in. C’est l’une des deux politiques de Homebrew : soit son contrôle de signature et de notarisation, déployé progressivement depuis fin 2025 et jamais retiré depuis, soit une décision distincte selon laquelle le cask ne remplit plus du tout les critères d’acceptation de Homebrew. Ce guide indique quels vrais casks Quick Look chaque politique a touchés jusqu’ici, ce que « désactivé » change ou non sur un Mac où le plug-in est déjà installé, et comment vérifier n’importe quel cask vous-même en une ligne de Terminal, sans Homebrew.
Notre article précédent sur cette politique portait sur un seul plug-in, Glance, et sur sa date de désactivation du 1er septembre 2026. Celui-ci en est le complément plus large : la politique complète, les codes de raison que Homebrew utilise réellement (ils ne sont pas tous identiques), et l’état en direct de neuf vrais casks au lieu d’un seul.
- La politique : le contrôle de signature de Homebrew
- D’où vient la notion de « notarisé »
- Quels plug-ins Quick Look sont réellement touchés
- Pourquoi les codes de raison ne concordent pas tous
- Vérifier n’importe quel cask vous-même, en une ligne
- Ce que « désactivé » veut dire, et ce qu’il ne veut pas dire
- Vos options
- Comparaison côte à côte
- Est-ce terminé, ou cela continue-t-il ?
- La place de Quick X Folder Preview
- Sources et lectures complémentaires
- Questions fréquentes
La politique : le contrôle de signature de Homebrew
Tout a commencé avec Homebrew 5.0.0, publié le 12 novembre 2025. Ses notes de version le disent clairement : « Casks without codesigning are deprecated », les casks sans signature de code sont donc obsolètes, et plus loin : « We will disable all Homebrew/homebrew-cask casks that fail Gatekeeper checks in September 2026 », soit la désactivation en septembre 2026 de tous les casks de Homebrew/homebrew-cask qui échouent aux contrôles Gatekeeper. La même version a rendu obsolètes les options --no-quarantine et --quarantine, qui permettaient jusque-là à brew install d’écarter d’office l’avertissement Gatekeeper de macOS pour un logiciel non signé, à la place de l’utilisateur. La justification figure directement dans les notes de version : Homebrew ne souhaite plus offrir de moyen simple de contourner les protections de macOS (« not wish to easily provide circumvention to macOS security features »).
Homebrew 6.0.0, publié le 11 juin 2026, l’a confirmé au lieu de l’abandonner discrètement : « Casks that fail macOS Gatekeeper checks, deprecated in 5.0.0, remain on track to be disabled in September 2026. » Les casks qui échouent à Gatekeeper, rendus obsolètes dans la 5.0.0, restaient donc promis à la désactivation en septembre 2026. Au moment où ce grand ménage a réellement eu lieu, il avait déjà survécu à deux cycles de version complets en tant qu’engagement déclaré, et non comme un simple avertissement susceptible d’être retiré.
La documentation de Homebrew sur deprecate! et disable! en explique le fonctionnement. Un cask obsolète s’installe toujours mais affiche un avertissement. Un cask désactivé échoue purement et simplement. Les casks comptant plus de 300 installations sur les 90 derniers jours sont censés rester au moins six mois en statut obsolète avant d’être désactivés, sauf si le problème ne peut pas être corrigé. Une fois désactivé, un cask est retiré automatiquement du tap environ un an après sa date de désactivation.
D’où vient la notion de « notarisé »
Ce n’est pas Homebrew qui a inventé la signature de code ni la notarisation. Apple a présenté la notarisation à la WWDC 2018 et l’a rendue facultative sous macOS Mojave. À partir de macOS 10.15 Catalina, en 2019, Apple en a fait l’exigence par défaut : un logiciel signé avec un certificat Developer ID et distribué en dehors du Mac App Store doit aussi être notarisé, sinon Gatekeeper lui oppose davantage d’obstacles au premier lancement. Cette règle est en vigueur depuis sept ans. Ce qui a changé fin 2025, ce n’est pas la règle d’Apple. C’est Homebrew qui a décidé de l’appliquer réellement comme condition d’inscription dans son tap officiel, au lieu de laisser un cask non signé y rester indéfiniment avec une option de contournement pour faire disparaître l’avertissement.
La notarisation n’est pas gratuite. Elle exige une adhésion à l’Apple Developer Program, 99 $ par an au moment de la rédaction, et l’envoi de chaque version au scan automatique d’Apple. Pour une app commerciale, c’est négligeable. Pour un plug-in Quick Look open source, bénévole et maintenu par une seule personne, c’est un coût réel et récurrent, dont beaucoup de petits utilitaires vraiment utiles se sont passés, bien avant que Homebrew n’en fasse une condition pour rester référencé.
Quels plug-ins Quick Look sont réellement touchés
Plutôt que de répéter des affirmations de seconde main, nous avons interrogé directement l’API publique formulae de Homebrew (formulae.brew.sh/api/cask/<name>.json) pour neuf vrais casks liés à Quick Look, le 13 novembre 2026. Voici exactement ce que chacun renvoie :
| Cask | Plug-in | État | Raison | Date de désactivation |
|---|---|---|---|---|
glance-chamburr | Glance (code, Markdown, archives) | Désactivé | fails_gatekeeper_check | 2026-09-01 |
qlstephen | QLStephen (fichiers texte sans extension) | Désactivé | no_longer_meets_criteria | 2026-09-27 |
qlcolorcode | QLColorCode (code avec coloration syntaxique) | Désactivé | no_longer_meets_criteria | 2026-09-27 |
quicklookase | QuickLookASE (Adobe Swatch Exchange) | Désactivé | no_longer_meets_criteria | 2026-09-27 |
webpquicklook | WebPQuickLook (images .webp) | Désactivé | no_longer_meets_criteria | 2026-09-27 |
quicklook-json | quicklook JSON (fichiers .json) | Désactivé | no_longer_meets_criteria | 2025-12-23 |
qlmarkdown | sbarex QLMarkdown (rendu Markdown) | Disponible | sans objet, une v1.5.x signée et notarisée est sortie à temps | sans objet |
suspicious-package | Suspicious Package (inspection d’installeurs) | Disponible | sans objet, notarisé de longue date | sans objet |
betterzip | BetterZip (aperçu d’archives/Quick Look) | Disponible | sans objet, notarisé de longue date | sans objet |
Interrogé en direct sur formulae.brew.sh le 13 novembre 2026. Le contrôle de Homebrew tourne en continu : revérifiez un cask vous-même avec la commande d’une ligne ci-dessous avant de supposer que ce tableau est encore exact dans quelques mois.
Pourquoi les codes de raison ne concordent pas tous
Le tableau ci-dessus met en évidence un point que beaucoup d’articles sur cette politique passent sous silence : tous les casks Quick Look désactivés ne portent pas le même code de raison. Seul glance-chamburr est marqué fails_gatekeeper_check, la raison qui signifie « jamais notarisé ». QLStephen, QLColorCode, QuickLookASE et WebPQuickLook portent à la place no_longer_meets_criteria, un code distinct que la documentation de Homebrew liste comme une entrée à part, aux côtés de raisons voisines comme :unmaintained et :unreachable, et qui n’a rien à voir avec Gatekeeper. Interroger la fiche API de chaque cask le 13 novembre 2026 fait aussi apparaître une date absente du tableau : Homebrew a rendu ces quatre casks obsolètes le 22 septembre 2025, près de deux mois avant même la sortie de la politique Gatekeeper dans la 5.0.0, puis les a désactivés un an plus tard, selon leur propre calendrier, le 27 septembre 2026. quicklook-json porte la même raison no_longer_meets_criteria, mais a sauté l’étape d’obsolescence et a été désactivé directement le 23 décembre 2025.
Il existe une seconde raison, indépendante, pour laquelle ce sont précisément ces cinq-là. Chacun installe son plug-in via la déclaration d’artefact qlplugin de Homebrew. Le fichier Ruby du cask qlstephen, par exemple, déclare qlplugin "QLStephen.qlgenerator", ce qui signifie que le plug-in lui-même est un bundle .qlgenerator hérité. Apple a supprimé la prise en charge de tout ce format de plug-in dans macOS 15 Sequoia, sorti en octobre 2024. Ces cinq plug-ins n’affichaient donc déjà plus d’aperçu sur aucun Mac sous Sequoia ou ultérieur, bien avant que Homebrew ne touche à leurs casks. Notre analyse complète de la suppression de .qlgenerator traite ce changement de plateforme à part entière. La politique Acceptable Casks de Homebrew et le changement d’Apple dans Sequoia sont deux décisions sans rapport, prises par deux organisations différentes. Elles sont simplement tombées sur les cinq mêmes plug-ins, parce qu’un plug-in que plus personne ne peut exécuter a aussi peu de chances d’obtenir un certificat Developer ID.
En pratique, le résultat est le même dans les deux cas : le cask ne s’installe plus. Mais vous ne pouvez pas en conclure que chaque plug-in Quick Look désactivé a échoué à un contrôle de signature. Ces cinq-là sont de petits outils à usage unique (QLStephen affiche les fichiers texte sans extension, WebPQuickLook les images .webp), et le format sur lequel ils reposaient ne fonctionnait déjà plus sur les versions actuelles de macOS avant que le contrôle de Homebrew ne les rattrape.
Vérifier n’importe quel cask vous-même, en une ligne
Inutile d’installer Homebrew pour vérifier l’état d’un cask. Ceci fonctionne dans n’importe quel Terminal :
curl -s https://formulae.brew.sh/api/cask/NAME.json | grep -E '"disabled"|"deprecated"|_reason|_date'
Remplacez NAME par le nom du cask, par exemple qlstephen ou glance-chamburr. La réponse indique immédiatement si "disabled" ou "deprecated" vaut true, ainsi que les champs de raison et de date correspondants.
Si Homebrew est déjà installé, brew info --cask NAME affiche les mêmes informations en langage clair, date de désactivation exacte comprise, directement depuis la ligne de commande de Homebrew plutôt que sur la foi d’un article de blog.
Ce que « désactivé » veut dire, et ce qu’il ne veut pas dire
C’est le point sur lequel il faut être précis, car « désactivé » évoque un interrupteur à distance, et ce n’en est pas un.
brew install --cask NAME et brew upgrade échouent avec une erreur pour ce cask. Cela concerne toute personne qui réinstalle après avoir effacé un Mac ou migré vers un nouveau, toute personne qui ne l’avait pas encore installé et le cherche après la date butoir, et toute personne qui compte sur brew upgrade pour recevoir automatiquement une future version corrective.Vos options
Chercher un tap propre au développeur ou un téléchargement direct
La politique de notarisation de Homebrew ne régit que le tap officiel homebrew/cask. Un développeur qui continue de distribuer une version non signée est libre de publier un tap personnel (installé avec `brew install --cask <github-username>/tap/<name>`) ou simplement d’héberger le .dmg ou le .zip sur sa page GitHub Releases, et la politique officielle ne touche ni l’un ni l’autre.
Commencez par le dépôt GitHub du projet. S’il existe un tap personnel ou un téléchargement direct, désinstallez le cask officiel, installez depuis l’autre source et autorisez l’app une fois via System Settings > Privacy & Security > Open Anyway (Réglages Système > Confidentialité et sécurité > Ouvrir quand même). Gatekeeper signale toujours ce qui n’a jamais été notarisé, quel que soit le canal par lequel c’est arrivé.
Cela n’aide que pour glance-chamburr. Pour les cinq autres casks, un tap personnel installe toujours le même bundle .qlgenerator, et ce format ne se charge pas sous macOS 15 Sequoia ou ultérieur, quelle que soit la signature. Trouver une autre source de téléchargement ne ramènera donc pas l’aperçu.
Gratuit, vous gardez le même plug-inL’autoriser manuellement et continuer à l’utiliser tel quel
Si un plug-in est déjà installé et enregistré comme extension Quick Look, rien ne vous oblige à le remplacer. La date de désactivation ne bloque que brew install et brew upgrade pour ce cask précis. Dans le cas de glance-chamburr, l’extension elle-même continue de fonctionner jusqu’à ce que vous la supprimiez.
La contrepartie : vous perdez, pour ce plug-in, le filet de sécurité des mises à jour automatiques de Homebrew. Si le développeur publie plus tard un correctif de sécurité, il vous faudra le trouver et l’installer vous-même au lieu de compter sur `brew upgrade`. Cette option ne vaut pas pour les cinq autres casks sous macOS 15 Sequoia ou ultérieur : leur format .qlgenerator ne se charge plus au niveau du système, il ne reste donc aucune copie fonctionnelle à utiliser telle quelle.
Gratuit, plus manuel à l’avenirPasser à une alternative notarisée et activement maintenue
Pour les plug-ins que ce ménage frappe le plus, l’aperçu du code et du Markdown, Looq et Unfold sont les deux options notarisées qui couvrent le même terrain. Notre article consacré à Glance, cité plus bas, les compare en détail. Pour des formats plus pointus comme le JSON ou les fichiers Adobe Swatch Exchange, il n’existe généralement pas de remplaçant notarisé équivalent, c’est donc l’option dont la couverture est la moins garantie.
C’est la voie à suivre si vous préférez ne plus revérifier l’état de vos casks chaque fois que Homebrew durcit son contrôle, ce que l’historique de cette politique laisse prévoir.
Généralement payant, aucun obstacle Gatekeeper lors des prochains contrôlesComparaison côte à côte
| Critère | Rester sur le cask officiel désactivé | Tap personnel / téléchargement direct | Alternative notarisée |
|---|---|---|---|
Installable via brew install après la date de désactivation | Non | Oui, si le développeur en publie un | Oui |
| Signé et notarisé par Apple | Non | Non | Oui |
| Coût | Gratuit | Gratuit | Généralement un petit achat unique |
| Mises à jour automatiques via Homebrew | Non, figé à la dernière version installée | Seulement si l’autre tap reste maintenu | Par son propre système de mise à jour ou le Mac App Store |
| Alerte Gatekeeper à la première installation | Sans objet, ne s’installe pas | Oui, une autorisation manuelle unique | Non |
| Résiste au prochain durcissement du contrôle | Non | Dépend entièrement du développeur | Oui |
Est-ce terminé, ou cela continue-t-il ?
Cela continue. Il ne s’agissait pas d’un nettoyage ponctuel fondé sur une liste figée établie en 2025. Homebrew a introduit le contrôle dans la 5.0.0, a confirmé le calendrier sept mois plus tard dans la 6.0.0 au lieu de l’abandonner discrètement, et a supprimé l’échappatoire --no-quarantine dans la même série de versions. Les conséquences concrètes d’un échec au contrôle deviennent ainsi plus strictes, pas plus souples. Tout cask soumis aujourd’hui au tap doit franchir la même barre, et un cask en règle aujourd’hui peut encore être rattrapé plus tard s’il n’est plus maintenu ou perd son certificat de signature. Si un plug-in Quick Look dont vous dépendez a été installé avec Homebrew et que vous ne l’avez pas vérifié depuis le début de cette affaire, cinq minutes maintenant valent mieux qu’une mauvaise surprise en pleine migration.
La place de Quick X Folder Preview
Ce contrôle ne concerne pas directement Quick X Folder Preview. L’app ajoute l’aperçu des dossiers et des archives, un manque qu’aucun des plug-ins ci-dessus n’a jamais comblé, et elle est notarisée par Apple depuis sa première version. Elle n’a donc jamais été concernée par ce ménage. Elle est disponible dès maintenant pour macOS 13.0 (Ventura) ou ultérieur, sur Apple Silicon comme sur Intel.
Sources et lectures complémentaires
La politique de Homebrew, dans ses propres termes : notes de version de Homebrew 5.0.0, notes de version de Homebrew 6.0.0, documentation Homebrew : Deprecating, Disabling and Removing, documentation Homebrew : Acceptable Casks.
État des casks en direct, vérifié le 13 nov. 2026 : glance-chamburr, qlstephen, qlcolorcode, quicklookase, webpquicklook, quicklook-json, qlmarkdown (Homebrew Formulae, chaque page alimentée par la même API JSON publique interrogée pour cet article).
L’exigence de notarisation d’Apple : Apple Developer : Notarizing macOS software before distribution, MacRumors, article sur la notarisation sous Catalina.
Pourquoi cinq de ces casks ne fonctionnent plus, notarisation ou pas : Apple Developer, macOS Sequoia 15 Release Notes, section Quick Look, et la source de chaque cask, par exemple Homebrew/homebrew-cask, qlstephen.rb, qui déclare directement l’artefact qlplugin "QLStephen.qlgenerator".
Notre article précédent, plus ciblé : Glance QuickLook Plugin Not Working or Disabled?. Notre analyse complète du changement de plateforme : Pourquoi les plug-ins Quick Look ne fonctionnent plus sous macOS Sequoia et Tahoe.
Questions fréquentes
En résumé
Votre plug-in Quick Look ne s’est presque certainement pas cassé tout seul, mais ne présumez pas de la raison sans vérifier. Homebrew a désactivé six vrais casks Quick Look à des dates échelonnées entre décembre 2025 et septembre 2026 : un pour avoir échoué au contrôle de signature et de notarisation, cinq pour une raison distincte qui n’a rien à voir avec les signatures et coïncide plutôt avec l’abandon par Apple de l’ancien format de plug-in .qlgenerator dans macOS 15 Sequoia. Rien de tout cela ne supprime un plug-in déjà installé. Vous le sentirez à la prochaine réinstallation, mise à jour ou migration de Mac, et c’est pourquoi mieux vaut vérifier maintenant que plus tard.
Vous cherchez d’autres guides de productivité sur Mac ? Notre article sur l’échéance de Glance détaille toutes les solutions pour ce plug-in précis. Notre guide complet de dépannage de Quick Look vous aide si Quick Look lui-même dysfonctionne pour des raisons sans rapport avec Homebrew, et notre analyse de la suppression de .qlgenerator par Apple explique le changement de plateforme, distinct de celui-ci. Parcourez aussi tous les guides de 1dot.ai ou consultez la page produit de Quick X Folder Preview pour les tarifs et la liste complète des extensions.
Prévisualisez dossiers et archives sans les extraire
Quick X Folder Preview ajoute 13 extensions Quick Look à la barre d’espace, notarisées par Apple. Gratuit pendant 14 jours, puis 4,99 $ une seule fois pour une licence à vie.
Essayer gratuitementLire d’autres guides