Release Notes#

Every release is a Universal Binary requiring macOS 11 (Big Sur) or later, signed with a Developer ID and notarized by Apple.

Galley checks for updates once a day and can be updated at any time from Galley ▸ Check for Updates…. Installed through Homebrew? brew upgrade --cask galley gets you to the same build.

v0.6#

7 September 2026 — download

Changed#

  • Galley no longer switches macOS font smoothing off at launch. Text is drawn at the system default weight, so a page now looks exactly as it does in Preview — the two use the same PDFKit engine, and the smoothing setting was the only thing making Galley’s body text look lighter.
  • If you prefer the thinner rendering, it is two defaults write commands away. See Text Weight.

Upgrading#

Versions up to v0.5 wrote AppleFontSmoothing and CGFontRenderingFontSmoothingDisabled into Galley’s preferences on every launch, and upgrading does not remove them. If text still looks thinner than in Preview after updating, delete both keys once and relaunch:

defaults delete com.github.munepi.galley CGFontRenderingFontSmoothingDisabled
defaults delete com.github.munepi.galley AppleFontSmoothing

v0.5#

6 September 2026 — download

New#

  • Page Color under the View menu. Dark and Charcoal invert the page while leaving photographs positive; Sepia, Orange and Gray tint the paper without touching the ink. Every preset keeps a WCAG AAA (7:1) contrast ratio, and the setting is display-only — copying, exporting and printing keep the original colors. With Normal selected nothing is installed in the rendering path, so the feature costs nothing when it is off.
  • Standard macOS find keys: Cmd + G and Shift + Cmd + G step through matches whether or not the search bar is focused, and Cmd + E searches for the current selection and shares it through the system find pasteboard. See Text Search.
  • A Match Case option in the search bar, applying to plain and regular-expression searches alike.
  • Navigation history: Cmd + [ and Cmd + ] return to where you were before following a link, clicking a bookmark or annotation, jumping to a search match, or running a Forward Search — the same keys Preview uses.

Changed#

  • The hidden Opt + J / Opt + K page aliases are gone. Every command is now a single, uniquely titled menu item, which is what lets you rebind any of them yourself — including Vim-style navigation. See Custom Key Bindings.
  • Regular-expression search is no longer forced to be case-insensitive; the Match Case checkbox decides.

Fixed#

  • The .pkg installer no longer relocates itself onto another copy of the bundle found elsewhere on disk, and no longer skips its payload when that copy is newer. It installs what it carries, into /Applications.

v0.4#

7 August 2026 — download

New#

  • The galleypdf command, shipped inside the application bundle. Open a PDF, jump to a page, force a reload, or run a SyncTeX forward search from your shell, your editor, or a build script.
  • A Homebrew tap: brew install --cask munepi/galley/galley installs Galley and puts galleypdf on your PATH.
  • New URL scheme endpoint galleypdf://open, with an optional page parameter.
  • Every galleypdf:// endpoint now accepts background=1, so a forward search never takes focus away from your editor — even when it is what launches Galley.
  • Vim/Neovim (VimTeX) joins the SyncTeX menu, so Cmd + Click in the PDF jumps back into your editor. Forward search has worked since VimTeX v2.18, and this completes the round trip. See VimTeX.

Changed#

  • Rectangular selection reports its dimensions to 0.01 mm, up from 0.1 mm.
  • The disk image now contains GalleyPDF.app itself instead of a .pkg installer. Mount it and drag the app onto the Applications shortcut.
  • Updates therefore replace the application in place, and no longer ask for an administrator password.
  • The application bundle carries a stapled notarization ticket of its own, so a first launch works without a network connection.
  • displayline.bash has been replaced by galleypdf displayline, which takes the same arguments without the AppleScript round trip.

Fixed#

  • Quitting with the Fonts or XMP subtab open no longer leaves the Info sidebar there on the next launch, where a font scan would start up behind a spinner. The sidebar returns to Info instead.

v0.3#

28 April 2026 — download

New#

  • PDF Info sidebar with five panels — Info (Document Info, PDF/X, PDF/A, PDF/UA, Security, Pages, Features), Fonts (a CGPDFDocument scan walking inherited page resources and Form XObjects), XMP (the raw packet parsed into sections), Bookmarks (click-to-navigate), and Annotations (click-to-navigate, Cmd + C copies the content).
  • View menu shortcuts: PDF Info (Cmd + I), PDF Bookmarks (Cmd + B), PDF Annotations (Cmd + N).
  • Export the sidebar as Markdown or JSON via File ▸ Export ▸ … (All / Info / Fonts / XMP / Bookmarks / Annotations), or from the in-panel Export dropdown.
  • The main window remembers its position and size across launches.

v0.2#

19 April 2026 — download

New#

  • Sparkle 2 auto-update support, with a Check for Updates… menu item and a daily check against the stable appcast.
  • Debug logging through os_log, filterable by subsystem (make log). See Debug Mode.

Changed#

  • Marquee selection refinements in the PDF view.
  • Refined page input HUD behaviour.

Fixed#

  • A generation token now guards against race conditions during PDF reload.

v0.1#

4 April 2026 — download

The first release.

  • A lightweight macOS PDF previewer built on PDFKit and AppKit, with SyncTeX support.
  • Auto-reload when the PDF changes on disk.
  • SyncTeX forward and inverse search.
  • The galleypdf:// URL scheme for editor integration.
  • Emacs (AUCTeX / YaTeX) and Visual Studio Code (LaTeX Workshop) integration.
  • PDF text search with regular expressions and cross-line matching.
  • Precision measurement tools.
Backward galleypdf Command Roadmap Forward