// GOOD TERMINAL PDF VIEWER

v0.2.6 | MIT LICENSE | RUST

> QUICK_INSTALL

// One command. No dependencies. No package managers.

🍎 macOS (Apple Silicon)

curl -L https://github.com/Eris-Margeta/good-terminal-pdf-viewer/releases/latest/download/gtpv-macos-arm64 -o gtpv
chmod +x gtpv
sudo mv gtpv /usr/local/bin/

M1, M2, M3, M4 chips

🍎 macOS (Intel)

curl -L https://github.com/Eris-Margeta/good-terminal-pdf-viewer/releases/latest/download/gtpv-macos-x64 -o gtpv
chmod +x gtpv
sudo mv gtpv /usr/local/bin/

Intel Macs (pre-2020)

🐧 Linux (x64)

curl -L https://github.com/Eris-Margeta/good-terminal-pdf-viewer/releases/latest/download/gtpv-linux-x64 -o gtpv
chmod +x gtpv
sudo mv gtpv /usr/local/bin/

Ubuntu, Debian, Fedora, Arch...

🐧 Linux (x64 musl)

curl -L https://github.com/Eris-Margeta/good-terminal-pdf-viewer/releases/latest/download/gtpv-linux-x64-musl -o gtpv
chmod +x gtpv
sudo mv gtpv /usr/local/bin/

Alpine, static binary

🪟 Windows (x64)

# PowerShell
Invoke-WebRequest -Uri "https://github.com/Eris-Margeta/good-terminal-pdf-viewer/releases/latest/download/gtpv-windows-x64.exe" -OutFile "gtpv.exe"

# Move to PATH (optional)
Move-Item gtpv.exe C:\Windows\System32\

Windows 10/11

🦀 From Source (Cargo)

# Clone and build
git clone https://github.com/Eris-Margeta/good-terminal-pdf-viewer.git
cd good-terminal-pdf-viewer
cargo build --release

# Install
sudo cp target/release/gtpv /usr/local/bin/

Requires Rust 1.85+

> ALL_BINARIES

PLATFORM ARCH BINARY SIZE
Linux x86_64 (glibc) gtpv-linux-x64 ~5.6 MB
Linux x86_64 (musl) gtpv-linux-x64-musl ~5.8 MB
macOS Apple Silicon gtpv-macos-arm64 ~5.6 MB
macOS Intel x64 gtpv-macos-x64 ~5.6 MB
Windows x64 gtpv-windows-x64.exe ~5.6 MB

> PACKAGE_MANAGERS

🍺 Homebrew

brew install gtpv

Coming soon

📦 Cargo

cargo install gtpv

Coming soon (crates.io)

🏔️ Arch (AUR)

yay -S gtpv

Coming soon

❄️ Nix

nix-shell -p gtpv

Coming soon

> VERIFY_INSTALLATION

verification

$ gtpv --version

gtpv 0.2.6

$ gtpv --help

Good Terminal PDF Viewer - Fast PDF viewing in the terminal

Usage: gtpv [OPTIONS] <PDF_FILE>
       gtpv <COMMAND>

Commands:
  view     Interactive PDF viewer (default)
  render   Render specific page(s) to terminal
  info     Show PDF metadata and page info
  stream   Start stream mode for editor integration

Arguments:
  <PDF_FILE>  Path to PDF file

Options:
  -p, --page <N>        Start on page N (default: 1)
  -f, --format <FMT>    Output format: auto, kitty, iterm2, sixel, halfblock, braille, block
  -w, --width <W>       Output width in terminal columns
      --dpi <DPI>       Render DPI (default: 150)
  -h, --help            Show this help
  -V, --version         Show version

> BUILD_REQUIREMENTS

PLATFORM REQUIREMENTS
All Rust 1.85+ (rustup.rs)
macOS Xcode Command Line Tools (xcode-select --install)
Linux build-essential, libstdc++
Windows Visual Studio Build Tools or MSVC