Warum Quick-Look-Plug-ins unter macOS Sequoia und Tahoe nicht mehr funktionieren
Apple hat das alte Plug-in-Format .qlgenerator in macOS 15 Sequoia entfernt, und unter macOS 26 Tahoe kam es nicht zurück. Was sich dadurch geändert hat, welche Plug-ins neu gebaut wurden und wie Sie Ihren eigenen Mac prüfen.
Von Ram Velmurugan · Founder & Lead Developer, 1dot.ai
.qlgenerator gebaut. Apple hat die Unterstützung dafür in macOS 15 Sequoia entfernt, und daran hat sich bis macOS 26 Tahoe nichts geändert. Damit es wieder funktioniert, muss es auf Apples neuerer Architektur für App-Erweiterungen (App Extensions) neu gebaut werden. Manche Entwickler haben das schon erledigt, andere nicht. Eine Einstellung, mit der Sie das alte Verhalten zurückholen, gibt es nicht.Hinweis der Redaktion: 1dot.ai entwickelt Quick X Folder Preview, eine Vorschau-App für Ordner auf dem Mac, die gegen Ende dieser Anleitung kurz vorkommt. Sie kostet derzeit einmalig 4,99 $ nach einer 14-tägigen Testphase und spielt für die Lösungen unten keine Rolle. Jeder Verweis auf Apples Dokumentation, jeder Plug-in-Status und jede Angabe zu Drittanbietern wurde im September 2026 live geprüft, auf Apples eigener Entwicklerseite und im GitHub-Repository des jeweiligen Projekts. Die Quellen stehen weiter unten.
Was tatsächlich kaputtgegangen ist
Apples eigene Versionshinweise zu macOS Sequoia 15 sagen es im Abschnitt Quick Look unter „Deprecations“ ohne Umschweife: "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." Auf Deutsch: Die Unterstützung für die veralteten Generator-Plug-ins wird entfernt, und wer Vorschauen und Miniaturen für eigene Dateitypen liefern will, soll auf die Schnittstellen für Vorschau- und Miniatur-Erweiterungen umsteigen. Diese eine Zeile, abgelegt unter der internen Fehlernummer 116791365, ist der ganze Grund, warum so viele Plug-ins nach diesem Update still und leise aufgehört haben zu funktionieren.
Die Änderung kam mit macOS 15.0 Sequoia im Jahr 2024. Sie betrifft nicht nur Betaversionen, sie ist keine Einstellung, und sie wurde auch in keinem späteren Punkt-Update zurückgenommen. macOS 26 Tahoe, die zum Zeitpunkt dieses Artikels aktuelle Version, lädt ein .qlgenerator-Plug-in eines Drittanbieters weiterhin nicht. Punkt.
- Warum Apple das geändert hat
- Altes Plug-in und moderne Erweiterung im Vergleich
- Welche Plug-ins tatsächlich tot sind und welche neu gebaut wurden
- So prüfen Sie Ihren eigenen Mac
- Die Lösung
- Das ist nicht das Problem mit Homebrew
- Wo Quick X Folder Preview hineinpasst
- Quellen und weiterführende Links
- Häufige Fragen
Warum Apple das geändert hat
Das alte Format .qlgenerator stammt aus dem ursprünglichen Quick-Look-Framework, lange bevor macOS 10.15 Catalina 2019 das separate Framework QuickLook Thumbnailing für Miniaturen einführte. Generatoren von Drittanbietern waren CFPlugIn-Bundles. Sie wurden in einen Ordner Library/QuickLook installiert und direkt in quicklookd geladen, also in denselben Hintergrundprozess, der auch jede andere Vorschau im System erzeugt. Wegen dieses gemeinsamen Prozesses konnte ein einziges schlecht geschriebenes oder abstürzendes Plug-in die Quick-Look-Vorschau für alle Dateitypen verschlechtern oder lahmlegen, nicht nur für seinen eigenen.
App-Erweiterungen lösen das Zuverlässigkeitsproblem schon durch ihren Aufbau. Eine Vorschau-Erweiterung für Quick Look (auf Basis des Protokolls QLPreviewingController) oder eine separate Miniatur-Erweiterung läuft in einem eigenen, abgeschotteten Prozess (Sandbox). Sie liegt im Bundle der zugehörigen App unter Contents/PlugIns statt in einem gemeinsamen Systemordner. Stürzt eine Erweiterung ab, reißt sie nichts anderes mehr mit, und das System kann ihren Lebenszyklus genauso verwalten wie bei jeder anderen App-Erweiterung.
.qlgenerator unter /System/Library/QuickLook. Das ist ein Überbleibsel bei der Benennung von signiertem Systemcode aus Apples eigener Hand, kein Beleg dafür, dass der alte Plug-in-Typ noch funktioniert. Betroffen sind nur .qlgenerator-Bundles von Drittanbietern.Altes Plug-in und moderne Erweiterung im Vergleich
| Eigenschaft | Altes .qlgenerator | Moderne App-Erweiterung |
|---|---|---|
| Dateiformat | .qlgenerator-Bundle (CFPlugIn) | .appex-Bundle (App Extension) |
| Installationsort | ~/Library/QuickLook oder ein Systemordner Library/QuickLook | In der zugehörigen App, unter Contents/PlugIns |
| Läuft in | Dem gemeinsamen Prozess quicklookd, zusammen mit allen anderen Plug-ins | Einem eigenen Sandbox-Prozess, getrennt von anderen Erweiterungen |
| Funktioniert ab macOS 15 Sequoia | Nein | Ja |
| Erscheint in den Systemeinstellungen unter Erweiterungen | Nein, noch nie | Ja |
| Auffindbar mit `qlmanage -m` | Früher ja, vor der Entfernung | Ja |
| Braucht überhaupt eine Code-Signatur | Nein (ein Teil des Problems) | Praktisch ja, als Teil des Erweiterungssystems |
Angaben zur Architektur geprüft anhand von Apples eigenen Versionshinweisen zu macOS Sequoia 15 und der Entwicklerdokumentation, September 2026.
Welche Plug-ins tatsächlich tot sind und welche neu gebaut wurden
Das betrifft nicht alle Plug-ins gleich. Manche Entwickler haben schon lange vor dem Stichtag auf die neue Schnittstelle umgestellt. Andere haben ihr Projekt seit Jahren nicht angefasst, und die Entfernung hat ihm endgültig den Rest gegeben. Hier ist der tatsächliche Stand der Plug-ins, nach denen am häufigsten gefragt wird, direkt im Repository des jeweiligen Projekts geprüft.
QLMarkdown
Der Entwickler sbarex hat diese Markdown-Vorschau auf der modernen Architektur für App-Erweiterungen neu gebaut und veröffentlicht auch 2026 weiter Updates, unter anderem mit Mermaid-Diagrammen, KaTeX-Formeln und Codeblöcken mit Syntaxhervorhebung. Es lässt sich problemlos über Homebrew installieren (`brew install --cask qlmarkdown`) und ist eines der deutlichsten Beispiele für ein altes Plug-in, dem der Umstieg gelungen ist.
Neu gebaut, aktiv gepflegtSourceCodeSyntaxHighlight
Die Vorschau mit Syntaxhervorhebung für Quellcode vom selben Entwickler wurde ebenfalls auf die aktuelle Schnittstelle umgestellt. Sie setzt macOS 12 Monterey oder neuer voraus, also lange vor dem Stichtag mit Sequoia. Wenn Sie sich auf ein älteres Plug-in für Code-Vorschauen verlassen haben, um das es still geworden ist, ist dies der direkte, aktiv gepflegte Ersatz.
Neu gebaut, aktiv gepflegtQLStephen (das Original)
QLStephen, das Plug-in, mit dem Quick Look Textdateien ohne Endung anzeigen konnte, ist wahrscheinlich das am weitesten verbreitete Opfer dieser Änderung, schlicht weil es jahrelang auf so vielen Entwickler-Macs installiert war. Ein GitHub-Issue, das den Entwickler bittet, es auf der modernen Schnittstelle neu zu bauen, ist seit dem 16. Oktober 2025 offen. Bis heute wurde kein Pull Request dafür übernommen. Wenn Sie darauf angewiesen waren, betrachten Sie es als eingestellt, statt auf ein Update zu warten.
Nicht neu gebaut, keine Lösung vom EntwicklerQLStephenSwift und ähnliche Neuentwicklungen
Statt auf die ursprünglichen Entwickler zu warten, haben andere von Grund auf neuen Ersatz geschrieben, der dieselben Lücken abdeckt und von Anfang an auf der aktuellen Architektur läuft. QLStephenSwift (von MyCometG3) und PreviewText (von smittytone) decken beide denselben Fall ab wie früher QLStephen: Textdateien ohne Endung. PreviewCode vom selben Entwickler übernimmt die Syntaxhervorhebung für Quellcode. Keines davon schleppt Altlasten aus der Plug-in-Zeit mit sich herum.
Neu, nur auf der modernen Schnittstelle gebautEine von der Community gepflegte Liste auf GitHub, Oil3/List-of-modern-Quick-Look-extensions, führt rund fünfzig Erweiterungen, die nachweislich auf der aktuellen Schnittstelle gebaut sind. Alles, was noch im alten Format .qlgenerator vorliegt, ist dort ausdrücklich ausgeschlossen. Für einen bestimmten Dateityp geht die Suche dort schneller, als jedes Plug-in einzeln nachzuschlagen.
So prüfen Sie Ihren eigenen Mac
Wenn das passiert, erscheint weder ein Dialogfenster noch ein Absturzbericht. Ein Plug-in zeigt einfach nichts mehr an.
qlmanage -m
Dieser Befehl listet jeden Generator und jede Vorschau-Erweiterung auf, die macOS derzeit registriert hat. Fehlt ein Plug-in, das Sie dort erwarten, oder zeigt ein Dateityp, den es früher abgedeckt hat, beim Drücken der Leertaste nur noch eine leere Seite oder ein allgemeines Symbol, dann gehen Sie davon aus, dass es betroffen ist.
Dauert etwa 10 SekundenUnter System Settings > General > Login Items & Extensions > Quick Look (auf einem deutschen Mac: Systemeinstellungen > Allgemein > Anmeldeobjekte & Erweiterungen > Quick Look) sehen Sie, welche modernen Erweiterungen gerade aktiviert sind. Dort standen immer nur App-Erweiterungen, nie alte Plug-ins. Eine leere oder kurze Liste beweist also für sich allein nichts. Der Terminal-Befehl oben ist die zuverlässigere Prüfung.
Die Lösung
Suchen Sie nach dem Namen des Plug-ins zusammen mit „app extension“, oder sehen Sie auf seiner GitHub-Seite unter „Releases“ nach, ob es etwas gibt, das nach Ende 2024 erschienen ist, also nach der Entfernung. Hat der ursprüngliche Entwickler es neu gebaut, genügt meist die Installation der aktuellen Version. Hat er es nicht getan und gibt es für denselben Dateityp einen von Grund auf neuen Ersatz, etwa die oben genannten für Textdateien und Quellcode, dann installieren Sie diesen, statt zu warten.
Wenn Sie nicht länger einzeln verfolgen wollen, welche Ihrer Plug-ins den Umstieg überlebt haben, deckt eine Komplettlösung, die von Anfang an auf der aktuellen Schnittstelle gebaut wurde, etwa Peek, Looq oder Unfold, die Vorschau für Markdown, Code und Archive mit einer einzigen Installation ab. Dieses spezielle Problem kann Sie damit nicht noch einmal treffen.
Das ist nicht das Problem mit Homebrew
.qlgenerator entfernt hat, ist eine Änderung an der Schnittstelle der Plattform. Sie betrifft jedes Plug-in, das noch so gebaut ist, ganz gleich, wie Sie es installiert haben. Dass Homebrew am 1. September 2026 einzelne Casks deaktiviert hat, darunter Glance, ist eine eigene Regel über Code-Signatur und Notarisierung auf einem einzigen Vertriebsweg. Ein Plug-in kann an der einen Prüfung scheitern, an beiden oder an keiner. Wenn Sie etwas gezielt über Homebrew installiert haben und dessen Cask deaktiviert wurde, lesen Sie stattdessen unsere ausführliche Analyse dieses Stichtags, denn dort ist die Lösung eine andere.Wo Quick X Folder Preview hineinpasst
Keines der hier behandelten Plug-ins und keine der Erweiterungen zeigt den Inhalt von Ordnern oder Archiven an, ohne sie vorher zu entpacken. Genau diese Lücke schließt Quick X Folder Preview mit 13 Erweiterungen, die von Anfang an auf der aktuellen Architektur für App-Erweiterungen gebaut sind und nicht auf etwas, das dieser Artikel als veraltet beschreibt. Die App ist jetzt verfügbar, für macOS 13.0 (Ventura) oder neuer, auf Apple Silicon und Intel.
Quellen und weiterführende Links
Apples offizielle Ankündigung der Entfernung: macOS Sequoia 15 Release Notes, Abschnitt Quick Look.
Hintergrund zur Plug-in-Architektur: The Eclectic Light Company, How Sequoia has changed QuickLook and its thumbnails, Michael Tsai, Sequoia No Longer Supports QuickLook Generator Plug-ins.
Bitte um Umstellung von QLStephen, ungelöst: whomwah/qlstephen, GitHub-Issue #143.
Neu gebaute Plug-ins: sbarex/QLMarkdown auf GitHub, sbarex/SourceCodeSyntaxHighlight auf GitHub.
Liste moderner Erweiterungen: Oil3/List-of-modern-Quick-Look-extensions auf GitHub.
Häufige Fragen
Unterm Strich
Ein Quick-Look-Plug-in, das ohne Ihr Zutun und ohne geänderte Einstellung aufgehört hat zu funktionieren, geht fast immer auf diese eine Änderung zurück: Apple hat das alte Format .qlgenerator in macOS 15 Sequoia entfernt, und macOS 26 Tahoe hat es nicht zurückgebracht. Manche Entwickler, darunter sbarex, haben ihre Plug-ins auf der aktuellen Schnittstelle neu gebaut, und die liefen die ganze Zeit weiter. Andere, etwa der ursprüngliche Entwickler von QLStephen, haben das nicht getan. Dann ist ein von Grund auf neuer Ersatz die verlässlichere Lösung als Warten. In jedem Fall dauert die Prüfung mit qlmanage -m zehn Sekunden und zeigt Ihnen genau, wo Sie stehen, bevor Sie irgendetwas installieren.
Sie suchen weitere Anleitungen für den Mac? Lesen Sie unsere ausführliche Anleitung zum Ansehen von Dateien auf dem Mac, ohne sie zu öffnen, nutzen Sie unsere vollständige Anleitung zur Fehlerbehebung bei Quick Look, wenn Quick Look selbst abstürzt oder aus Gründen ohne Bezug zu einem Plug-in leere Vorschauen zeigt, lesen Sie über den separaten Stichtag für die Notarisierung von Casks bei Homebrew, wenn Sie eigentlich darauf gestoßen sind, lesen Sie unsere speziellere Anleitung zum Ansehen von ZIP- und RAR-Archiven, ohne sie zu entpacken, erfahren Sie, warum EPS-Dateien keine Vorschau mehr zeigen, wenn Ihnen Miniaturen von EPS- oder PostScript-Dateien fehlen (diese Unterstützung hat Apple selbst entfernt, ohne dass ein Plug-in beteiligt war), stöbern Sie in allen Anleitungen von 1dot.ai oder sehen Sie sich die Produktseite von Quick X Folder Preview an, mit Preisen und der vollständigen Liste der Erweiterungen.
Vorschau für Ordner und Archive, ohne zu entpacken?
Quick X Folder Preview ergänzt die Leertaste um 13 Quick-Look-Erweiterungen, gebaut auf der aktuellen Architektur für App-Erweiterungen. 14 Tage kostenlos, danach einmalig 4,99 $ für eine dauerhafte Lizenz.
Kostenlos testenWeitere Anleitungen lesen