# Install tdf with Homebrew, Nix, pacman TUI-based PDF viewer. Version 0.5.0 via Homebrew; verified 2026-05-31. Also installable with nix: nix profile install nixpkgs#tdf. ## Install ```sh sudo av install brew:tdf ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install tdf ``` Evidence: local Homebrew formula metadata ### Linux - Nix (92%): ```sh nix profile install nixpkgs#tdf ``` Evidence: nixpkgs package indexes: pkgs/by-name/td/tdf/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - pacman (92%): ```sh sudo pacman -S tdf ``` Evidence: Arch Linux sync databases: tdf from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz ## Package facts - **Package key:** brew:tdf - **Package manager:** Homebrew - **Package manager page:** - **Version:** 0.5.0 - **Source summary:** TUI-based PDF viewer - **Homepage:** - **Repository:** - **License:** AGPL-3.0-only - **Source archive:** - **Last updated:** 2026-05-31T09:10:00Z - **Generated:** 2026-08-04T22:13:35+00:00 ## Executables - for_profiling (cli) - tdf (cli) - for_profiling (alias) - tdf (alias) ## Dependencies - fontconfig - freetype ## Build dependencies - llvm - pkgconf - rust ## 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-08-04 - Package-manager version: 0.5.0 - Package-manager updated: 2026-05-31 - Local data: ok - Upstream repository: https://github.com/itsjunetime/tdf - Upstream latest detected: v0.5.0 (current) ## Project history and usage tdf is a terminal-based PDF viewer designed for responsive use with large documents. It renders documents inside terminal environments and provides asynchronous rendering, search, hot reload, and reactive layouts. ### Project history The public Rust project began in 2024. Version 0.3.0, released in March 2025, rewrote the viewer around MuPDF for better rendering quality and performance; the 0.4 series improved the Kitty image backend and zoom behavior, and version 0.5.0 continued usability and stability work. The current changelog also records forthcoming Windows support. ### Adoption history The official README documents Cargo installation from Git and a Radicle clone identity. The supplied package metadata records Homebrew and Nix packages, widening installation beyond manual Rust builds. ### How it is used Users launch tdf with a document and navigate within a terminal UI. Optional Cargo features add EPUB and CBZ support, while the viewer provides search, hot reload, zooming, panning, color inversion, right-to-left display, and terminal-specific image rendering. ### Why package nerds care tdf is notable because it brings graphical document rendering into a terminal-native Rust workflow. Its MuPDF, fontconfig, Clang, Ratatui, and terminal image-protocol dependencies make it an interesting cross-section of systems packaging and modern TUI design. ### Timeline - 2024: The public tdf repository was created. - 2025-03: Version 0.3.0 rewrote rendering around MuPDF. - 2025-08: Version 0.4.0 introduced a new Kitty-oriented image backend. - 2025-12: Version 0.5.0 was released. - Unreleased: The changelog records Windows support. ### Related projects - Ratatui supplies the terminal UI framework, MuPDF supplies document rendering, and the optional feature set extends the PDF viewer to EPUB and CBZ documents. Radicle provides an alternative source-distribution route. ### Sources - - - - source_facts.package-manager ## Security Notes No matching local secret-handling manifest was found for tdf. Package metadata is still published here so future coverage has a stable package URL. ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** tdf - **Version Scheme:** 0 - **Revision:** 0 - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** stable ## Other Package-Manager Records - Nix - tdf: normalized package name match | nixpkgs package indexes: pkgs/by-name/td/tdf/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - pacman - tdf - 0.5.0-3: normalized package name match | Arch Linux sync databases: tdf from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | A TUI-based PDF viewer | https://github.com/itsjunetime/tdf ## Related links - [Source-control packages](https://pkg.so/source-control-tools/) - Belongs to a source-control command family. - [Terminal utility packages](https://pkg.so/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://pkg.so/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [Networking and protocol packages](https://pkg.so/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [fontconfig](https://pkg.so/brew/fontconfig/) - Runtime dependency declared by Homebrew. - [freetype](https://pkg.so/brew/freetype/) - Runtime dependency declared by Homebrew. - [pkgconf](https://pkg.so/brew/pkgconf/) - Build dependency declared by Homebrew. - [llvm](https://pkg.so/brew/llvm/) - Build dependency declared by Homebrew. - [rust](https://pkg.so/brew/rust/) - Build dependency declared by Homebrew. - [mupdf](https://pkg.so/brew/mupdf/) - Shares pkgdb curated category or tags: cli, document-viewer, media, pdf. - [lue-reader](https://pkg.so/brew/lue-reader/) - Shares pkgdb curated category or tags: cli, media, pdf, terminal. - [djview4](https://pkg.so/brew/djview4/) - Shares pkgdb curated category or tags: cli, document-viewer, media. - [cairo](https://pkg.so/brew/cairo/) - Shares pkgdb curated category or tags: cli, media, pdf. - [poppler](https://pkg.so/brew/poppler/) - Shares pkgdb curated category or tags: cli, media, pdf. - [ghostscript](https://pkg.so/brew/ghostscript/) - Shares pkgdb curated category or tags: cli, media, pdf. - [qpdf](https://pkg.so/brew/qpdf/) - Shares pkgdb curated category or tags: cli, media, pdf. - [ocrmypdf](https://pkg.so/brew/ocrmypdf/) - Shares pkgdb curated category or tags: cli, media, pdf. - [plutobook](https://pkg.so/brew/plutobook/) - Both packages work with overlapping file formats or content types. Shared terms: cli, document, fontconfig, freetype, media. - [podofo](https://pkg.so/brew/podofo/) - Both packages work with overlapping file formats or content types. Shared terms: cli, document, fontconfig, freetype, media. - [lazycut](https://pkg.so/brew/lazycut/) - Local package facts share a topical domain. Shared terms: based, cli, media, terminal, terminal-ui. ## Combined YAML source View the package source record on GitHub. [combined/tdf.yml](https://github.com/mxcl/pkgdb/blob/main/combined/tdf.yml) ## Sources - pkg.so package database - package-page enrichment - curated package history - package version freshness - pkgdb category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph