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 config file located at ~/.config/fancy-cat/config.json. The file is automatically created on the first run with default settings.

The default 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.