# 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
- **Version:** 0.5.0
- **Source summary:** TUI-based PDF viewer
- **Homepage:** <https://github.com/itsjunetime/tdf>
- **Repository:** <https://github.com/itsjunetime/tdf>
- **Last updated:** 2026-05-31T09:10:00Z
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- for_profiling (alias)
- tdf (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 0.5.0
## 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

- <https://github.com/itsjunetime/tdf#readme>
- <https://github.com/itsjunetime/tdf/blob/main/CHANGELOG.md>
- <https://github.com/itsjunetime/tdf/releases>
- source_facts.package-manager


## Security Notes

No matching local secret-handling manifest was found for tdf. Nucleus package metadata is still published here so future coverage has a stable package URL.


## 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


## 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
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph