Folio Helper

Une petite app compagnon gratuite qui permet à l’édition Mac App Store de Folio Writer de compiler avec les outils déjà installés sur votre Mac — ceux que le bac à sable d’Apple n’autorise pas l’app à lancer elle-même.

Télécharger Folio Helper 1.6.4

Version 1.6.4 · Gratuit · notarisé par Apple · macOS 13 ou ultérieur. Vous n’en avez besoin qu’avec l’édition Mac App Store, et seulement pour utiliser des outils que vous avez installés vous-même.

Nouveau dans la 1.6.4 — un utilitaire plus rapide et plus robuste : il recherche tous vos outils en une fois et se souvient de l’endroit où il les a trouvés, si bien que le panneau des outils se remplit en une ou deux secondes au lieu d’indiquer parfois « aucun outil » au démarrage à froid ; Compiler ▸ Arrêter arrête désormais tout ce que le moteur de rendu a lancé (le xelatex de latexmk, le pandoc et le Jupyter de Quarto), et pas seulement le processus principal ; et un outil qui s’arrête prématurément n’entraîne plus l’utilitaire dans sa chute en pleine compilation. Si la mise à jour automatique est activée, vous l’avez déjà.

Vous avez déjà Folio Helper ? Depuis Folio Writer 1.8.6 et Folio Helper 1.6.3, les mises à jour sont automatiques : l’app vérifie environ une fois par jour s’il existe de nouvelles versions, contrôle la signature de code du téléchargement, et l’utilitaire en cours d’exécution se remplace discrètement en arrière-plan — pas de boîtes de dialogue, pas de clics, rien à approuver. Vous préférez qu’on vous le demande d’abord ? Désactivez-la dans Réglages ▸ Compiler ; un bouton de mise à jour manuelle se trouve dans Compiler ▸ Configurer les outils externes….

Vous utilisez Folio Writer 1.8.4 ou antérieur ? Ces versions fonctionnent avec Folio Helper 1.5 (également disponible sous le nom sans numéro de version FolioHelper.zip vers lequel pointent leurs liens).

La mise à jour manuelle fonctionne aussi : quittez Folio Writer — Folio Helper s’arrête en même temps — remplacez Folio Helper.app dans Applications par la nouvelle version, puis rouvrez Folio Writer.

À quoi il sert

L’édition App Store s’exécute dans le bac à sable d’Apple, qui interdit de lancer des programmes externes — y compris les outils de composition que vous avez installés avec Homebrew, MacTeX ou TinyTeX. Folio Helper est un minuscule agent qui vit hors du bac à sable et exécute ces outils pour le compte de Folio Writer : pandoc, pandoc-crossref, typst, xelatex / pdflatex / lualatex / latexmk, tectonic, quarto et la ligne de commande claude. Une fois installé, la compilation en PDF via votre propre LaTeX, le rendu des projets .qmd avec Quarto et le mode Claude CLI de l’assistant d’écriture fonctionnent tous dans l’édition App Store.

Vous n’avez pas encore les outils ? Installez pandoc, pandoc-crossref, Quarto, Typst et un moteur LaTeX avec une seule commande dans le Terminal (elle affiche un menu pour choisir ce que vous voulez) :

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

Comment l’installer

La méthode simple (Folio Writer 1.8.5 ou ultérieur) : ouvrez Compiler ▸ Configurer les outils externes… et cliquez sur Installer Folio Helper. Folio Writer le télécharge, vérifie la signature et le place dans Applications — vous autorisez une fois le dossier Applications, vous confirmez l’unique invite de notarisation de macOS, et c’est la dernière interaction dont l’utilitaire aura jamais besoin : dès lors, il se tient à jour automatiquement.

À la main :

Téléchargez le fichier zip ci-dessus et décompressez-le (Safari l’a peut-être déjà fait).
Faites glisser Folio Helper.app dans votre dossier Applications.
Ouvrez-le une fois. Il n’a pas de fenêtre — il s’enregistre comme utilitaire d’arrière-plan et apparaît dans Réglages Système ▸ Général ▸ Ouverture sous le nom « Folio Helper ».
Dans Folio Writer, ouvrez Compiler ▸ Configurer les outils externes… et appuyez sur Revérifier. La fiche de Folio Helper liste chaque outil trouvé, avec son chemin et sa version.

Ce qu’il fait — et ce qu’il ne fait pas

Il exécute uniquement la liste fixe d’outils ci-dessus — on ne peut pas lui demander d’exécuter autre chose.
Il les exécute uniquement à la demande de Folio Writer ; la signature de code permet de vérifier que les connexions proviennent bien de Folio Writer.
Pas de fenêtre, pas d’élément dans la barre des menus, aucun accès réseau propre, rien de collecté. Il cherche les outils aux emplacements habituels (Homebrew, MacTeX, TinyTeX, /usr/local) et via le PATH de votre shell de connexion.

Désinstallation

Quittez-le (Réglages Système ▸ Ouverture ▸ désactivez « Folio Helper »), puis supprimez Folio Helper.app d’Applications. Folio Writer continue de fonctionner ; la compilation se limite simplement à ce que le bac à sable autorise.