Folio Helper

Eine kleine, kostenlose Begleit-App, mit der die Mac-App-Store-Ausgabe von Folio Writer mit den Werkzeugen kompilieren kann, die bereits auf Ihrem Mac installiert sind – denen, die die App wegen Apples Sandbox nicht selbst starten darf.

Folio Helper 1.7 laden

Version 1.7 · Kostenlos · von Apple beglaubigt · macOS 14 oder neuer. Sie brauchen ihn nur mit der Mac-App-Store-Ausgabe und nur, um Werkzeuge zu nutzen, die Sie selbst installiert haben.

Neu in 1.7 – der Helper kann jetzt auch die Codex-Kommandozeile von OpenAI (codex) ausführen, damit der Assistent-Anbieter ChatGPT (Codex) auf diesem Mac, der mit Folio Writer 1.18 kommt, auch in der App-Store-Ausgabe funktioniert. Er findet codex, wo immer npm, Homebrew oder Volta es installiert haben. Wenn automatische Updates aktiviert sind, bekommen Sie ihn, ohne etwas zu tun.

Sie haben Folio Helper schon? Ab Folio Writer 1.8.6 und Folio Helper 1.6.3 sind Updates automatisch: Die App sucht etwa einmal am Tag nach neuen Versionen, prüft die Codesignatur des Downloads, und der laufende Helper ersetzt sich still im Hintergrund – keine Dialoge, keine Klicks, nichts zu bestätigen. Möchten Sie lieber vorher gefragt werden? Schalten Sie es unter Einstellungen ▸ Kompilieren aus; eine Schaltfläche für manuelle Updates finden Sie unter Kompilieren ▸ Externe Tools einrichten….

Sie verwenden Folio Writer 1.8.4 oder älter? Diese Versionen gehören zu Folio Helper 1.5 (auch unter der unversionierten Adresse FolioHelper.zip erhältlich, auf die ihre Links verweisen).

Von Hand aktualisieren geht auch: Beenden Sie Folio Writer – Folio Helper wird dabei mit beendet –, ersetzen Sie Folio Helper.app im Ordner „Programme“ durch die neue Version und öffnen Sie Folio Writer erneut.

Wofür er da ist

Die App-Store-Ausgabe läuft in Apples Sandbox, die das Starten externer Programme verbietet – auch der Satzwerkzeuge, die Sie mit Homebrew, MacTeX oder TinyTeX installiert haben. Folio Helper ist ein winziger Agent, der außerhalb der Sandbox lebt und diese Werkzeuge im Auftrag von Folio Writer ausführt: pandoc, pandoc-crossref, typst, xelatex / pdflatex / lualatex / latexmk, tectonic, quarto sowie die Befehlszeilen claude und codex. Wenn er installiert ist, funktionieren in der App-Store-Ausgabe das Kompilieren zu PDF über Ihr eigenes LaTeX, das Rendern von .qmd-Projekten mit Quarto und der Claude-CLI-Modus des Schreibassistenten (ab Folio Writer 1.18 auch ChatGPT über Codex).

Sie haben die Werkzeuge noch nicht? Installieren Sie pandoc, pandoc-crossref, Quarto, Typst und eine LaTeX-Engine mit einem einzigen Befehl im Terminal (er zeigt ein Menü, in dem Sie auswählen, was Sie möchten):

curl -fsSL https://foliowriter.app/install-folio-tools.sh | bash

So installieren Sie ihn

Der einfache Weg (Folio Writer 1.8.5 oder neuer): Öffnen Sie Kompilieren ▸ Externe Tools einrichten… und klicken Sie auf Folio Helper installieren. Folio Writer lädt ihn herunter, prüft die Signatur und legt ihn in den Ordner „Programme“ – Sie genehmigen den Ordner „Programme“ einmal, bestätigen die einmalige Beglaubigungsabfrage von macOS, und das ist die letzte Interaktion, die der Helper je braucht: Von da an hält er sich automatisch auf dem neuesten Stand.

Von Hand:

Laden Sie die ZIP-Datei oben herunter und entpacken Sie sie (Safari hat das vielleicht schon erledigt).
Ziehen Sie Folio Helper.app in Ihren Ordner Programme.
Öffnen Sie ihn einmal. Er hat kein Fenster – er registriert sich als Hintergrund-Helper und erscheint unter Systemeinstellungen ▸ Allgemein ▸ Anmeldeobjekte als „Folio Helper“.
Öffnen Sie in Folio Writer Kompilieren ▸ Externe Tools einrichten… und klicken Sie auf Erneut prüfen. Die Helper-Karte listet jedes gefundene Werkzeug mit Pfad und Version auf.

Was er tut – und was nicht

Führt nur die feste Liste der oben genannten Werkzeuge aus – er kann nicht dazu gebracht werden, irgendetwas anderes auszuführen.
Führt sie nur aus, wenn Folio Writer darum bittet; anhand der Codesignatur wird geprüft, dass Verbindungen von Folio Writer stammen.
Kein Fenster, kein Menüleistensymbol, kein eigener Netzwerkzugriff, keine Datenerfassung. Er sucht Werkzeuge an den üblichen Orten (Homebrew, MacTeX, TinyTeX, npm, Volta, /usr/local) und über den PATH Ihrer Login-Shell.

Deinstallieren

Beenden Sie ihn (Systemeinstellungen ▸ Anmeldeobjekte ▸ „Folio Helper“ ausschalten) und löschen Sie dann Folio Helper.app aus dem Ordner „Programme“. Folio Writer funktioniert weiter; das Kompilieren greift dann einfach auf das zurück, was die Sandbox erlaubt.