PDF viewer for terminals using the Kitty image protocol

fancy-cat <path-to-pdf> <optional-page-number>

fancy-cat uses a modal interface similar to Neovim. There are two modes: view mode and command mode. To enter command mode you type : by default (this can be changed in the config file).

Documentation on the available commands can be found here.

fancy-cat can be configured through a JSON configuration file located in one of several locations (primary $XDG_CONFIG_HOME/fancy-cat/config.json, fallback $HOME/.config/fancy-cat/config.json, legacy $HOME/.fancy-cat). An empty configuration file is automatically created in the primary or fallback location on the first run.

An example config.json and documentation can be found here.

fancy-cat is available in the following repositories:

• Zig version 0.14.0
• Terminal emulator with the Kitty image protocol (e.g. Kitty, Ghostty, WezTerm, etc.)

1. Fetch submodules:

git submodule update --init --recursive

2. Build the project:

zig build --release=small

zig build -Dcpu="skylake" --release=small

3. Install:

# Add to your PATH
# Linux
mv zig-out/bin/fancy-cat ~/.local/bin/

# macOS
mv zig-out/bin/fancy-cat /usr/local/bin/

zig build run -- <path-to-pdf> <optional-page-number>

• ✅ Filewatch (hot-reload)
• ✅ Runtime config
• ✅ Custom keymappings
• ✅ Modal interface
• ✅ Commands
• ✅ Colorize mode (dark-mode)
• ✅ Status bar
• ✅ Page navigation (zoom, prev, next, etc.)

AGPL-3.0-or-later

Contributions are welcome.