Org Preview v0.3.0

Org Preview is a live reader for local Org-mode files. Keep writing in your editor and the preview follows your saves. Downloaded releases need no Node.js, npm, or Emacs.

Includes an outline, search, source view, themes, zoom, and common Org formatting. Documents stay local; embedded HTML and Babel blocks never execute. BSD-3-Clause, with the MIT-licensed Orga parser.

macOS: Apple Silicon

1. Download org-preview-0.3.0-arm64.dmg and SHA256SUMS-darwin-arm64.txt from Assets below. The ZIP is an alternative; GitHub's Source code archives are not installers.
2. Quit older copies. Open the DMG, drag Org Preview.app into Applications, and eject the disk image.
3. Launch the Applications copy. If macOS cannot verify the developer and you trust this repository, first try opening the app, then use System Settings → Privacy & Security → Open Anyway and confirm Open. These builds are ad-hoc signed for bundle integrity, but not Developer-ID-signed or notarized. Click Done on the initial alert, then approve this app specifically; no paid Apple Developer membership is needed to run it.
4. Click Open file, press ⌘O, drag in an Org file, or use Finder → Open With → Org Preview. Keep one installed copy.

Apple first-launch guidance. If the app is reported as damaged, re-download and verify its checksum; report the exact alert if it persists.

Omarchy / Arch Linux: x86_64

Download org-preview-0.3.0.tar.gz and SHA256SUMS-linux-x64.txt to Downloads. This tested installation uses your home directory and needs no FUSE or sudo:

ORG_PREVIEW_VERSION=0.3.0
cd "$HOME/Downloads"
mkdir -p "$HOME/.local/opt" "$HOME/.local/bin"
tar -xzf "org-preview-$ORG_PREVIEW_VERSION.tar.gz" -C "$HOME/.local/opt"
ln -sfn "$HOME/.local/opt/org-preview-$ORG_PREVIEW_VERSION/org-preview" "$HOME/.local/bin/org-preview"
"$HOME/.local/bin/org-preview"

Use Open file, Ctrl+O, or drag-and-drop. Open notebooks from the terminal with ~/.local/bin/org-preview ~/notes/today.org. The installation guide includes an optional app-launcher entry, default file associations, and update instructions. No AUR/pacman package is supplied.

Alternatively download org-preview-0.3.0.AppImage, make it executable, and run it with --appimage-extract-and-run when FUSE 2 is absent. Native Wayland and XWayland were tested on Omarchy. Run as your normal user with sandboxing enabled.

Compare downloads with the supplied SHA-256 files using shasum -a 256 on macOS or sha256sum on Linux. To update, quit the app and repeat installation for the new version; there is no in-app updater.

Known limits

One UTF-8 document at a time, up to 4 MB. Editing, full Emacs export parity, local image/file links, math/diagrams, Babel, Quick Look, Developer ID signing/notarization, and auto-updates remain outside scope. Intel Mac builds are not supplied.

Release information · Merged source

What's Changed

• Fix Mac bundle signatures and release asset handling by @chadhs in #3

Full Changelog: v0.2.0...v0.3.0