Getting Started on GalleyPDF

The Philosophy

Mon, 01 Jan 0001 00:00:00 +0000

The Core Philosophy: 1-to-1 Correspondence#

Galley maintains a strict 1-to-1 correspondence between your TeX source and its PDF output. It enforces a single-window policy — one source, one PDF, one window — so that SyncTeX operations always target the correct context without ambiguity.

This is not an arbitrary constraint. It is what makes Forward Search and Inverse Search reliable: when there is exactly one window per source/PDF pair, every “jump” can be resolved unambiguously. As soon as you allow multiple windows for the same PDF, SyncTeX targets become ambiguous and the user has to disambiguate manually — exactly the kind of friction Galley is built to remove.

System Requirements

Mon, 01 Jan 0001 00:00:00 +0000

System Requirements#

OS: macOS 11.0 (Big Sur) or later
Architecture: Universal Binary — native support for both Apple Silicon and Intel Macs

Installation

Mon, 01 Jan 0001 00:00:00 +0000

Installation#

Pre-compiled Universal Binaries are available under the Releases section.

Download GalleyPDF_<version>.dmg.
Double-click to mount the disk image.
Double-click GalleyPDF.pkg inside the mounted volume.
Follow the on-screen instructions to install GalleyPDF.app.

After installation, see Integration to wire Galley into your text editor.