Quick X Folder Preview · Dépannage

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

Vérifié sur macOS 26 Tahoe et dans la documentation développeur d’Apple·Mis à jour en septembre 2026·9 min de lecture
En bref : Si un plug-in Quick Look (Coup d’œil dans les menus français) n’affiche plus un type de fichier qu’il prenait en charge, sans que vous ayez touché à vos réglages, la cause la plus probable est qu’il reposait encore sur l’ancien format .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

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.

Une subtilité à connaître
Les générateurs intégrés d’Apple, ceux qui gèrent les PDF, les images et les autres types de fichiers natifs, se trouvent toujours dans des dossiers nommés .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 .qlgeneratorExtension d’application moderne
Format de fichierBundle .qlgenerator (CFPlugIn)Bundle .appex (App Extension)
Emplacement d’installation~/Library/QuickLook ou un dossier système Library/QuickLookDans l’application hôte, sous Contents/PlugIns
S’exécute dansLe processus partagé quicklookd, avec tous les autres plug-insSon propre processus isolé, séparé des autres extensions
Fonctionne sur macOS 15 Sequoia ou ultérieurNonOui
Apparaît dans les Réglages Système, rubrique ExtensionsNon, jamaisOui
Visible avec `qlmanage -m`Oui, avant la suppressionOui
Exige une signature de code pour fonctionnerNon (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 maintenu

SourceCodeSyntaxHighlight

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 maintenu

QLStephen (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 mainteneur

QLStephenSwift 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 moderne

Une 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.

Terminal

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 secondes

Le 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

Deux problèmes différents, faciles à confondre
La fin de la prise en charge de .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.

État des lieux, honnêtement
4,99 $ une seule fois, après un essai de 14 jours avec toutes les fonctions, sans abonnement. Unfold couvre davantage de types de fichiers (plus de 250 contre nos 13) si vous avez besoin d’une couverture plus large et pouvez satisfaire son exigence de macOS 15.6. Si votre problème immédiat est un plug-in cassé, utilisez les vérifications et solutions ci-dessus. Elles règlent le problème du jour dans tous les cas.

Sources et lectures complémentaires

Questions fréquentes

Pourquoi mes plug-ins Quick Look ne fonctionnent-ils plus après la mise à jour de macOS ?
Si le plug-in reposait sur l’ancien format .qlgenerator, Apple en a totalement supprimé la prise en charge dans macOS 15 Sequoia (sorti en 2024), et cela vaut toujours sous macOS 26 Tahoe, sans aucun retour en arrière. Ce n’est ni un bogue ni un réglage que vous pourriez réactiver. Le plug-in doit être reconstruit sur la nouvelle architecture d’extensions d’application d’Apple, et tant que son développeur ne l’a pas fait, il ne se charge tout simplement plus.
Qu’est-ce qu’un plug-in .qlgenerator, et pourquoi Apple l’a-t-il supprimé ?
Un bundle .qlgenerator était l’ancienne méthode qui permettait aux développeurs tiers d’ajouter la prise en charge de Quick Look pour un type de fichier qu’Apple ne gérait pas nativement. Il utilisait un format de plug-in appelé CFPlugIn, s’installait dans un dossier Library/QuickLook et se chargeait directement dans le même processus d’arrière-plan que tous les autres aperçus de votre Mac. Ce processus partagé était aussi le point faible : un seul plug-in défectueux ou qui plantait pouvait bloquer les aperçus pour tout le monde. Les extensions d’application corrigent cela en exécutant chaque aperçu dans son propre processus isolé.
Comment savoir si un plug-in de mon Mac est concerné ?
Aucune alerte ni aucun message d’erreur n’apparaît. Le plug-in cesse simplement d’afficher quoi que ce soit, et Quick Look se rabat sur une icône de fichier générique ou une page blanche. Ouvrez Terminal et lancez `qlmanage -m`. La commande liste tous les générateurs et toutes les extensions d’aperçu que macOS a actuellement enregistrés. Si un plug-in dont vous dépendez n’y figure pas, ou si son type de fichier affiche un aperçu vide quand vous appuyez sur Espace, il est très probablement encore à l’ancien format.
Les plug-ins Quick Look intégrés d’Apple ont-ils cassé eux aussi ?
Non. Les générateurs d’Apple situés dans /System/Library/QuickLook portent encore l’ancienne extension .qlgenerator dans le nom de leurs dossiers, mais c’est un reste de nommage, pas le type de plug-in obsolète. En tant que composant système signé par Apple elle-même, ce code n’est pas concerné par la suppression. Seuls les bundles .qlgenerator installés par d’autres développeurs sont touchés.
Est-ce la même chose que la désactivation de Glance par Homebrew ?
Non, et confondre les deux mène à la mauvaise solution. Ici, Apple retire une interface de plug-in entière de macOS, ce qui touche tous les plug-ins .qlgenerator, quelle que soit la façon dont vous les avez installés. La désactivation d’un cask par Homebrew (Glance compris) relève d’une règle distincte et plus étroite 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. Pour ce problème précis, lisez notre analyse complète de la désactivation des casks Homebrew.
Quels plug-ins ont réellement été reconstruits sur la nouvelle interface ?
QLMarkdown et SourceCodeSyntaxHighlight, tous deux du développeur sbarex, ont été reconstruits sur l’architecture moderne d’extensions d’application et sont activement maintenus en 2026. Il existe aussi quelques remplaçants plus récents, écrits à partir de zéro et uniquement sur la nouvelle interface, dont QLStephenSwift, PreviewText et PreviewCode. QLStephen lui-même, l’aperçu d’origine des fichiers texte sans extension que la plupart des développeurs Mac ont gardé installé pendant des années, n’a pas été reconstruit par son mainteneur. Une issue GitHub réclamant la migration est ouverte depuis octobre 2025, sans qu’aucun correctif ait été fusionné.
Que faut-il utiliser à la place d’un plug-in qui ne sera jamais reconstruit ?
Vérifiez d’abord s’il existe déjà un remplaçant sur l’interface moderne pour ce type de fichier précis, avant de supposer qu’il faudra payer. Si rien de gratuit ne le couvre, un outil d’aperçu payant tout-en-un, bâti dès le départ sur l’interface actuelle, comme Peek, Looq ou Unfold, prend en charge les types de fichiers les plus courants (Markdown, code, archives) en une seule installation et ne se heurtera pas de nouveau au même mur.

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