Avior

The vim-way to read PDFs

A native macOS PDF viewer built for keyboard-driven productivity. Navigate with vim keybindings, run any action from the command palette, and annotate without ever modifying the original file.

Download for macOS Free · v1.56.12 · macOS 15+
A native Swift app for macOS

Built for Power Users

Every feature designed to keep your hands on the keyboard and your focus on the content.

Vim Keybindings

Navigate with hjkl, jump with marks, select in visual mode, follow links with Ctrl+] and jump back with Ctrl+[. Your muscle memory, perfected for PDFs.

Command Palette

Press : to run any action — with fuzzy search, command-only mode (!), and annotation search (/). No mouse required.

Non-Destructive Annotations

Highlight and annotate freely. Everything is saved to JSON sidecars, so your original PDF is never modified.

Layout-Aware Analysis

Detect a document's structure — titles, paragraphs, lists, tables, and figures — for the current page or the whole document. The detection model is downloaded on demand from Settings ▸ Model Files.

Open from the Terminal

Set up the avior command with a single paste into Terminal, then open any PDF straight from your shell: avior report.pdf.

Native Performance

Built with Swift for macOS. Instant startup, smooth scrolling (or instant page jumps, if you prefer), minimal memory footprint.

Why Avior?

A different approach to reading PDFs.

Built Like a Hammer

A solid, robust tool that just works. No subscriptions, no cloud dependencies. Own it as long as your OS supports it.

Keyboard-First Philosophy

Inspired by vim's operational elegance. Designed for those who think in keyboard shortcuts, not mouse clicks.

Focused Reading Experience

Purpose-built for academic researchers and technical readers. Not a PDF editor, but a PDF reading machine.

Frequently Asked Questions

Everything you need to know about Avior.

What macOS versions are supported?

Avior requires macOS 15 (Sequoia) or later, and is fully optimized for the latest macOS 27.

Is Avior free?

Yes, Avior is completely free.

How do updates work?

Avior updates itself. Choose Check for Updates… and the new version is downloaded, cryptographically verified, and installed in place — signed and notarized, with no manual re-downloads.

Can Avior understand my document's structure?

Yes. Avior includes layout detection that identifies titles, paragraphs, lists, tables, and figures — for the current page or the whole document. The detection model (about 246 MB) is downloaded on demand from Settings ▸ Model Files, with progress, automatic resume on dropped connections, and integrity verification before install.

Can I make Avior my default PDF viewer?

Yes. Avior registers itself with macOS as a PDF viewer, so it appears in Finder's Open With menu and can be set as your system-wide default for PDFs.

Can I open PDFs from the terminal?

Yes. Choose File ▸ Install 'avior' Shell Command… and paste the one command it shows into Terminal — it puts avior on your PATH and stays current as Avior updates. Then run avior report.pdf from any shell, or just avior to launch the app.

Does Avior remember where I left off?

Yes. Avior reopens each PDF at the page, position, and zoom where you left it — even after you quit — for the 1,000 PDFs you've used most recently. Turn it off in Settings ▸ Document ▸ Reopen documents where you left off.

Does Avior collect any of my data?

Your PDFs are processed entirely on your device and never uploaded. Avior offers optional anonymous diagnostics that are off by default; see our Privacy Policy for details.

How do I learn the keybindings?

Use the command palette (:) to discover available commands with their shortcuts. The help command works like the Linux man command — a handy tool to learn more about any feature.

Changelog

Track the evolution of Avior.

v1.56.12 2026-11-05
  • Pick up where you left off — Avior now reopens each PDF at the page, position, and zoom where you left it, even after you quit. Turn it off in Settings ▸ Document.
  • The reading cursor gets out of your way — scrolling, zooming, or jumping somewhere yourself now clears the reading cursor. Press h, j, k, or l to bring up a new one in the middle of the view. The reading cursor and the mouse pointer are now always separate (Cursor Follows Pointer has been removed).
  • Setting up the avior command works now — File ▸ Install 'avior' Shell Command… gives you one command to paste into Terminal. It puts avior on your PATH, stays current as Avior updates, and repairs avior commands set up by earlier versions. New avior install and avior uninstall commands set it up and remove it from the shell.
  • More dependable typing — keys pressed right as the command palette opens or closes now go where you expect, the palette's list always matches what you've typed, and a note you're writing in the inspector is no longer lost.
  • Scrolling no longer slows down over a long session (such as while recompiling a LaTeX paper), and closing a window now stops its layout analysis — plus fixes for the status bar in narrow windows, sidebar thumbnails after a PDF reloads, and a crash while thumbnails were drawing.