Getting Started

Installation

Pre-built binaries

Install with a single command:

macOS (Apple Silicon)

curl -sL https://github.com/focusring/horn/releases/latest/download/horn-macos-aarch64 \
  -o /usr/local/bin/horn && chmod +x /usr/local/bin/horn

macOS (Intel)

curl -sL https://github.com/focusring/horn/releases/latest/download/horn-macos-x86_64 \
  -o /usr/local/bin/horn && chmod +x /usr/local/bin/horn

Linux (x86_64)

curl -sL https://github.com/focusring/horn/releases/latest/download/horn-linux-x86_64 \
  -o /usr/local/bin/horn && chmod +x /usr/local/bin/horn

Linux (aarch64)

curl -sL https://github.com/focusring/horn/releases/latest/download/horn-linux-aarch64 \
  -o /usr/local/bin/horn && chmod +x /usr/local/bin/horn

Windows

Invoke-WebRequest -Uri https://github.com/focusring/horn/releases/latest/download/horn-windows-x86_64.exe -OutFile horn.exe

Or download manually from GitHub Releases.

From source

Requires Rust 1.85+ (edition 2024):

cargo install --git https://github.com/focusring/horn.git

Docker

docker build -t horn .
docker run -v $(pwd):/data horn validate /data/document.pdf

Desktop App

Download the native desktop app from GitHub Releases:

Platform	Format
macOS	.dmg
Windows	.msi
Linux	.deb / .AppImage

See the Desktop App guide for more details.

WebAssembly (npm)

Use Horn in the browser or Node.js via the WASM package:

npm install @focusring/horn-wasm

See the WebAssembly guide for API details and usage examples.

GitHub Action

Add PDF accessibility checks to your CI pipeline:

- uses: focusring/horn@v1
  with:
    path: ./output/

See CI/CD Integration and GitHub Action Reference for all options.

Quick start

Validate a single PDF:

horn validate document.pdf

Validate a directory of PDFs:

horn validate ./pdfs/ --recurse

Get JSON output:

horn validate document.pdf --format json

See all available checks:

horn list-checks

Shell completions

Generate completions for your shell:

# Bash
horn completions bash > ~/.local/share/bash-completion/completions/horn

# Zsh
horn completions zsh > ~/.zfunc/_horn

# Fish
horn completions fish > ~/.config/fish/completions/horn.fish

Next steps

• Validating PDFs — learn about all validation options
• Output Formats — choose the right format for your use case
• CI/CD Integration — automate accessibility checks in your pipeline