# Install fancy-cat with Homebrew, Nix

PDF reader for terminal emulators using the Kitty image protocol. Version 0.6.0 via Homebrew; verified 2026-06-27.

## Install

```sh
sudo av install brew:fancy-cat
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install fancy-cat
```

  Evidence: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#fancy-cat
```

  Evidence: nixpkgs package indexes: pkgs/by-name/fa/fancy-cat/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:fancy-cat
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/fancy-cat>
- **Version:** 0.6.0
- **Source summary:** PDF reader for terminal emulators using the Kitty image protocol
- **Homepage:** <https://github.com/freref/fancy-cat>
- **Repository:** <https://github.com/freref/fancy-cat>
- **Upstream docs:** <https://github.com/freref/fancy-cat#readme>
- **License:** AGPL-3.0-or-later
- **Source archive:** <https://github.com/freref/fancy-cat/archive/refs/tags/v0.6.0.tar.gz>
- **Last updated:** 2026-06-27T15:38:04Z
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- fancy-cat (cli)
- fancy-cat (alias)

## Dependencies

- mujs
- mupdf

## Build dependencies

- zig@0.15

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 0.6.0
- Package-manager updated: 2026-06-27
- Local data: ok
- Upstream repository: https://github.com/freref/fancy-cat
- Upstream latest detected: v0.6.0 (current)
## Project history and usage

fancy-cat is a terminal PDF viewer built around the Kitty image protocol. Its README describes a modal interface, runtime configuration, key mappings, command mode, hot reload, status bar, page navigation, and dark-mode colorization.

### Project history

The repository was created in November 2024 and is implemented as a Zig project. Its README presents the project as a PDF viewer for terminals that can display pages through image-capable terminal emulators such as Kitty, Ghostty, and WezTerm.

### Adoption history

Official adoption information is modest: the README points to packaging status across repositories and the package appears in Homebrew and Nix through the input facts. The project is still young and the official sources do not support a broad adoption claim.

### How it is used

The primary command is `fancy-cat <path-to-pdf> <optional-page-number>`. Once running, users navigate through a modal interface similar to Neovim and can enter command mode with `:` by default.

Configuration is JSON and lives under the XDG config directory when available, with fallback and legacy locations documented by the README.

### Why package nerds care

fancy-cat is interesting to terminal-tool users because it packages graphical PDF reading as a shell-native workflow. It belongs to the recent wave of CLI applications that rely on modern terminal image protocols instead of opening a separate GUI viewer.

### Timeline

- 2024: Repository created.
- 2024: v0.1.0 tag published.
- 2026: v0.6.0 tag present.

### Related projects

- Kitty image protocol support is the key terminal capability.
- Zig is the implementation and build toolchain.

### Sources

- <https://github.com/freref/fancy-cat>
- <https://raw.githubusercontent.com/freref/fancy-cat/master/README.md>
- <https://api.github.com/repos/freref/fancy-cat>
- <https://api.github.com/repos/freref/fancy-cat/tags?per_page=20>


## Security Notes

broad file, network, media, or database tool signal.

- **Geiger risk:** blue / medium
- broad file, network, media, or database tool signal

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** fancy-cat
- **Version Scheme:** 0
- **Revision:** 1
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable

## Other Package-Manager Records

- Nix - fancy-cat: normalized package name match | nixpkgs package indexes: pkgs/by-name/fa/fancy-cat/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [mujs](https://www.automicvault.com/pkg/brew/mujs/) - Runtime dependency declared by Homebrew.
- [mupdf](https://www.automicvault.com/pkg/brew/mupdf/) - Runtime dependency declared by Homebrew.
- [bookokrat](https://www.automicvault.com/pkg/brew/bookokrat/) - Shares av.db curated category or tags: cli, pdf, productivity, terminal.
- [doxx](https://www.automicvault.com/pkg/brew/doxx/) - Shares av.db curated category or tags: cli, document-viewer, productivity, terminal.
- [evince](https://www.automicvault.com/pkg/brew/evince/) - Shares av.db curated category or tags: cli, document-viewer, pdf, productivity.
- [gnome-papers](https://www.automicvault.com/pkg/brew/gnome-papers/) - Shares av.db curated category or tags: cli, document-viewer, pdf, productivity.
- [abook](https://www.automicvault.com/pkg/brew/abook/) - Shares av.db curated category or tags: cli, productivity, terminal.
- [aerc](https://www.automicvault.com/pkg/brew/aerc/) - Shares av.db curated category or tags: cli, productivity, terminal.
- [alot](https://www.automicvault.com/pkg/brew/alot/) - Shares av.db curated category or tags: cli, productivity, terminal.
- [alpine](https://www.automicvault.com/pkg/brew/alpine/) - Shares av.db curated category or tags: cli, productivity, terminal.
- [mdfried](https://www.automicvault.com/pkg/brew/mdfried/) - Local package facts share a topical domain. Shared terms: cli, productivity, terminal, viewer, viewers.
- [mdless](https://www.automicvault.com/pkg/brew/mdless/) - Local package facts share a topical domain. Shared terms: cli, productivity, terminal, viewer, viewers.

## Combined YAML source

View the package source record on GitHub. [combined/fancy-cat.yml](https://github.com/automic-vault/db/blob/main/combined/fancy-cat.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
