Pourquoi les plug-ins Quick Look ne fonctionnent plus sous macOS Sequoia et Tahoe
Apple a supprimé l’ancien format de plug-in .qlgenerator dans macOS 15 Sequoia, et il n’est pas revenu avec macOS 26 Tahoe. Ce que cela a changé, quels plug-ins ont été reconstruits et comment vérifier votre propre Mac.
Par Ram Velmurugan · Founder & Lead Developer, 1dot.ai
.qlgenerator. Apple a cessé de prendre ce format en charge dans macOS 15 Sequoia, et rien n’a changé jusqu’à macOS 26 Tahoe. Pour fonctionner à nouveau, le plug-in doit être reconstruit sur la nouvelle architecture d’extensions d’application d’Apple (App Extensions). Certains développeurs l’ont déjà fait, d’autres non. Aucun réglage ne permet de revenir en arrière.Note de la rédaction : 1dot.ai édite Quick X Folder Preview, une application d’aperçu de dossiers pour Mac, brièvement citée à la fin de ce guide. Elle coûte aujourd’hui 4,99 $ une seule fois après un essai de 14 jours et ne joue aucun rôle dans les solutions ci-dessous. Chaque référence à la documentation d’Apple, chaque état de plug-in et chaque affirmation sur des outils tiers ont été vérifiés en direct en septembre 2026, sur le site développeur d’Apple et dans le dépôt GitHub de chaque projet. Les sources figurent en bas de page.
Ce qui a réellement cassé
Les notes de version de macOS Sequoia 15 publiées par Apple le disent sans détour, à la section Quick Look, rubrique « Deprecations » : "Support for deprecated Quick Look Generator plugins is being removed. To provide previews and thumbnails for your custom file types, migrate to Quick Look Preview Extension and Thumbnail Extension API." Autrement dit, la prise en charge des anciens plug-ins générateurs est supprimée, et les développeurs qui veulent fournir des aperçus et des vignettes pour leurs propres types de fichiers doivent passer aux interfaces d’extensions d’aperçu et de vignettes. Cette seule ligne, rattachée au numéro de bogue interne 116791365, explique à elle seule tous les plug-ins qui ont cessé de fonctionner sans bruit après cette mise à jour.
Le changement est arrivé avec macOS 15.0 Sequoia en 2024. Il ne concerne pas que les bêtas, ce n’est pas un réglage, et il n’a été annulé dans aucune mise à jour intermédiaire. macOS 26 Tahoe, la version actuelle au moment où nous écrivons, ne charge toujours aucun plug-in .qlgenerator tiers. Un point c’est tout.
- Pourquoi Apple a fait ce changement
- Ancien plug-in et extension moderne, face à face
- Quels plug-ins sont vraiment morts, et lesquels ont été reconstruits
- Comment vérifier votre propre Mac
- La solution
- Ce n’est pas le problème des casks Homebrew
- La place de Quick X Folder Preview
- Sources et lectures complémentaires
- Questions fréquentes
Pourquoi Apple a fait ce changement
L’ancien format .qlgenerator remonte au framework Quick Look d’origine, bien avant que macOS 10.15 Catalina n’introduise en 2019 un framework séparé pour les vignettes, QuickLook Thumbnailing. Les générateurs tiers étaient des bundles CFPlugIn, installés dans un dossier Library/QuickLook et chargés directement dans quicklookd, le même processus d’arrière-plan qui produit tous les autres aperçus du système. Avec ce processus partagé, un seul plug-in mal écrit ou qui plantait pouvait dégrader ou bloquer les aperçus Quick Look de tous les types de fichiers, pas seulement du sien.
Les extensions d’application règlent ce problème de fiabilité par construction. Une extension d’aperçu Quick Look (bâtie sur le protocole QLPreviewingController) ou une extension de vignettes distincte s’exécute dans son propre processus isolé (sandbox). Elle vit dans le bundle de l’application hôte, sous Contents/PlugIns, et non dans un dossier système partagé. Si une extension plante, elle n’entraîne plus rien d’autre dans sa chute, et le système gère son cycle de vie comme celui de n’importe quelle autre extension d’application.
.qlgenerator sous /System/Library/QuickLook. C’est un reste de nommage sur du code système signé par Apple, pas la preuve que l’ancien type de plug-in fonctionne encore. Seuls les bundles .qlgenerator d’autres développeurs sont touchés par la suppression.Ancien plug-in et extension moderne, face à face
| Propriété | Ancien .qlgenerator | Extension d’application moderne |
|---|---|---|
| Format de fichier | Bundle .qlgenerator (CFPlugIn) | Bundle .appex (App Extension) |
| Emplacement d’installation | ~/Library/QuickLook ou un dossier système Library/QuickLook | Dans l’application hôte, sous Contents/PlugIns |
| S’exécute dans | Le processus partagé quicklookd, avec tous les autres plug-ins | Son propre processus isolé, séparé des autres extensions |
| Fonctionne sur macOS 15 Sequoia ou ultérieur | Non | Oui |
| Apparaît dans les Réglages Système, rubrique Extensions | Non, jamais | Oui |
| Visible avec `qlmanage -m` | Oui, avant la suppression | Oui |
| Exige une signature de code pour fonctionner | Non (c’est une partie du problème) | En pratique oui, via le système d’extensions |
Détails d’architecture vérifiés dans les notes de version de macOS Sequoia 15 et la documentation développeur d’Apple, septembre 2026.
Quels plug-ins sont vraiment morts, et lesquels ont été reconstruits
Tous les plug-ins ne sont pas logés à la même enseigne. Certains développeurs sont passés à la nouvelle interface bien avant l’échéance. D’autres n’ont pas touché à leur projet depuis des années, et la suppression l’a simplement achevé. Voici l’état réel des plug-ins qui reviennent le plus souvent dans les questions, vérifié directement dans le dépôt de chaque projet.
QLMarkdown
Le développeur sbarex a reconstruit cet aperçu Markdown sur l’architecture moderne d’extensions d’application et continue de publier des mises à jour en 2026, avec notamment le rendu des diagrammes Mermaid, les formules KaTeX et les blocs de code avec coloration syntaxique. Il s’installe sans difficulté via Homebrew (`brew install --cask qlmarkdown`) et c’est l’un des exemples les plus nets d’un ancien plug-in qui a réussi la transition.
Reconstruit, activement maintenuSourceCodeSyntaxHighlight
L’aperçu avec coloration syntaxique pour le code source, du même développeur, a lui aussi été porté sur l’interface actuelle. Il exige macOS 12 Monterey ou ultérieur, bien avant l’échéance de Sequoia. Si vous utilisiez un ancien plug-in d’aperçu de code qui ne donne plus signe de vie, voici son remplaçant direct et activement maintenu.
Reconstruit, activement maintenuQLStephen (l’original)
QLStephen, le plug-in qui permettait à Quick Look d’afficher les fichiers texte sans extension, est sans doute la victime la plus répandue de ce changement, tout simplement parce que tant de développeurs l’ont gardé installé sur leur Mac pendant des années. Une issue GitHub demandant au mainteneur de le reconstruire sur l’interface moderne est ouverte depuis le 16 octobre 2025, et aucune pull request n’a été fusionnée à ce jour. Si vous en dépendiez, considérez-le comme abandonné plutôt que d’attendre une mise à jour.
Non reconstruit, aucun correctif du mainteneurQLStephenSwift et autres réécritures à partir de zéro
Plutôt que d’attendre les mainteneurs d’origine, d’autres développeurs ont écrit de nouveaux remplaçants qui visent les mêmes lacunes et reposent dès le premier jour sur l’architecture actuelle. QLStephenSwift (de MyCometG3) et PreviewText (de smittytone) couvrent tous deux le même cas que QLStephen autrefois : les fichiers texte sans extension. PreviewCode, du même développeur, gère la coloration syntaxique du code source. Aucun d’eux ne traîne le moindre héritage de l’ancien système de plug-ins.
Nouveau, bâti uniquement sur l’interface moderneUne liste tenue par la communauté sur GitHub, Oil3/List-of-modern-Quick-Look-extensions, recense une cinquantaine d’extensions dont il est confirmé qu’elles reposent sur l’interface actuelle, et exclut explicitement tout ce qui utilise encore l’ancien format .qlgenerator. Pour un type de fichier précis, c’est plus rapide que de chercher plug-in par plug-in.
Comment vérifier votre propre Mac
Aucune boîte de dialogue ni aucun rapport de plantage n’apparaît quand cela se produit. Le plug-in cesse simplement d’afficher quoi que ce soit.
qlmanage -m
Cette commande liste tous les générateurs et toutes les extensions d’aperçu que macOS a actuellement enregistrés. Si un plug-in que vous attendez n’y figure pas, ou si un type de fichier qu’il couvrait affiche désormais une page blanche ou une icône générique quand vous appuyez sur Espace, considérez qu’il est touché.
Environ 10 secondesLe chemin System Settings > General > Login Items & Extensions > Quick Look (sur un Mac en français : Réglages Système > Général > Ouverture et extensions > Coup d’œil) montre les extensions modernes actuellement activées. On n’y a jamais vu que des extensions d’application, jamais d’anciens plug-ins. Une liste vide ou maigre ne prouve donc rien à elle seule. La commande Terminal ci-dessus reste la vérification la plus fiable.
La solution
Cherchez le nom du plug-in accompagné de « app extension », ou consultez la page des versions (« Releases ») de son dépôt GitHub pour repérer une publication postérieure à fin 2024, date de la suppression. Si le développeur d’origine l’a reconstruit, réinstaller la version actuelle suffit en général. S’il ne l’a pas fait et qu’un remplaçant écrit à partir de zéro existe pour le même type de fichier, comme ceux cités plus haut pour le texte brut et le code source, installez-le au lieu d’attendre.
Si vous préférez ne plus suivre un à un les plug-ins qui ont survécu à cette transition, un outil d’aperçu tout-en-un bâti dès le départ sur l’interface actuelle, comme Peek, Looq ou Unfold, couvre les aperçus Markdown, de code et d’archives en une seule installation. Ce problème précis ne pourra plus vous rattraper.
Ce n’est pas le problème des casks Homebrew
.qlgenerator par Apple est un changement d’interface au niveau de la plateforme. Il touche tous les plug-ins encore construits de cette façon, quelle que soit leur méthode d’installation. La désactivation de certains casks par Homebrew le 1er septembre 2026, Glance compris, relève d’une règle distincte sur la signature de code et la notarisation, propre à un seul canal de distribution. Un plug-in peut échouer à l’un de ces contrôles, aux deux ou à aucun. Si vous avez installé quelque chose via Homebrew et que son cask a été désactivé, lisez plutôt notre analyse complète de cette échéance, car la solution n’est pas la même.La place de Quick X Folder Preview
Aucun des plug-ins ni aucune des extensions présentés ici n’affiche le contenu d’un dossier ou d’une archive sans l’extraire d’abord. C’est précisément la lacune que Quick X Folder Preview comble avec 13 extensions bâties dès le départ sur l’architecture actuelle d’extensions d’application, et non sur quoi que ce soit que cet article décrit comme obsolète. L’application est disponible dès maintenant pour macOS 13.0 (Ventura) ou ultérieur, sur Apple Silicon comme sur Intel.
Sources et lectures complémentaires
Annonce officielle d’Apple : macOS Sequoia 15 Release Notes, section Quick Look.
Contexte sur l’architecture des plug-ins : The Eclectic Light Company, How Sequoia has changed QuickLook and its thumbnails, Michael Tsai, Sequoia No Longer Supports QuickLook Generator Plug-ins.
Demande de migration de QLStephen, non résolue : whomwah/qlstephen, issue GitHub #143.
Plug-ins reconstruits : sbarex/QLMarkdown sur GitHub, sbarex/SourceCodeSyntaxHighlight sur GitHub.
Liste des extensions modernes : Oil3/List-of-modern-Quick-Look-extensions sur GitHub.
Questions fréquentes
En résumé
Un plug-in Quick Look qui a cessé de fonctionner tout seul, sans aucun changement de réglage de votre part, s’explique presque toujours par ce seul changement : Apple a supprimé l’ancien format .qlgenerator dans macOS 15 Sequoia, et macOS 26 Tahoe ne l’a jamais rétabli. Certains développeurs, dont sbarex, ont reconstruit leurs plug-ins sur l’interface actuelle, et ceux-ci n’ont jamais cessé de fonctionner. D’autres, comme le mainteneur d’origine de QLStephen, ne l’ont pas fait, et un remplaçant écrit à partir de zéro est alors une solution plus sûre que l’attente. Dans tous les cas, la vérification avec qlmanage -m prend dix secondes et vous dit exactement où vous en êtes avant d’installer quoi que ce soit.
Vous cherchez d’autres guides pour Mac ? Lisez notre guide complet pour prévisualiser des fichiers sur Mac sans les ouvrir. Consultez notre guide de dépannage complet de Quick Look si Quick Look lui-même plante ou affiche des aperçus vides pour des raisons sans rapport avec un plug-in, et notre article sur l’échéance de notarisation des casks Homebrew si c’est en réalité ce problème que vous avez rencontré. Pour les archives, lisez notre guide pour voir le contenu d’une archive ZIP ou RAR sans l’extraire, et si ce sont des vignettes EPS ou PostScript qui manquent, découvrez pourquoi les fichiers EPS n’ont plus d’aperçu (Apple a retiré cette prise en charge elle-même, aucun plug-in n’est en cause). Vous pouvez aussi parcourir tous les guides de 1dot.ai ou consulter la page produit de Quick X Folder Preview pour les tarifs et la liste complète des extensions.
Des aperçus de dossiers et d’archives sans extraction ?
Quick X Folder Preview ajoute 13 extensions Quick Look à la barre d’espace, bâties sur l’architecture actuelle d’extensions d’application. Gratuit pendant 14 jours, puis 4,99 $ une seule fois pour une licence à vie.
Essayer gratuitementLire d’autres guides