From 28e4c097637881bd1a85d0c3829e563accb432fb Mon Sep 17 00:00:00 2001 From: Alisue Date: Sun, 26 Jul 2026 00:24:41 +0900 Subject: [PATCH] docs(readme): document Quick Look registration troubleshooting The v0.31.1 sandbox fix ships correctly, but macOS does not always auto-register the Quick Look extension after install (for example when the app is still quarantined at first launch), so pressing Space renders no preview. Add a troubleshooting tip that registers the appex with pluginkit and refreshes the Quick Look cache. Co-Authored-By: Claude Opus 4.8 (1M context) --- README.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/README.md b/README.md index 9d7e555e..13851b2f 100644 --- a/README.md +++ b/README.md @@ -101,6 +101,17 @@ brew install --cask arto-app/tap/arto xattr -dr com.apple.quarantine /Applications/Arto.app ``` +> [!TIP] +> **Quick Look preview not showing?** macOS normally registers the Quick Look +> extension the first time you launch Arto. If pressing Space on a Markdown file +> still shows no preview — or a stale one right after an upgrade — register the +> extension manually and refresh the cache: +> +> ```sh +> pluginkit -a /Applications/Arto.app/Contents/PlugIns/ArtoQuickLook.appex +> qlmanage -r && qlmanage -r cache +> ``` + Alternatively, [Nix] is also supported. To try it without a permanent installation: