# itsjunetime/tdf

A tui-based PDF viewer

Repository: https://github.com/itsjunetime/tdf
Canonical: https://ross.abutalabs.com/products/itsjunetime-tdf
Language: Rust
License: AGPL-3.0
License Family: copyleft
Last push: 2026-08-16T02:34:04+00:00

## Health v2 (maintenance only)
Score: 76/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 97, release rhythm 59, longevity 59
- inputs: {"age_days": 829, "days_push": 18, "days_rel": 273, "gap_med": 20, "n_releases_24m": 6}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1948, forks 67 (observed 2026-08-28T04:05:57.996354+00:00)

## What it is
tdf is a terminal-based PDF viewer written in Rust using ratatui, designed for performance and responsiveness even with very large PDFs. It supports asynchronous rendering, searching, hot reloading, and optional EPUB/CBZ support via feature flags.

## Use cases
- read pdfs in the terminal
- view large pdf files without a gui
- search text inside pdfs from the command line
- watch a pdf that changes on disk
- open epub or cbz files in a tui

## When to avoid
- you need a graphical viewer with zoom, annotations, or form filling
- you want a polished end-user application rather than a hobbyist tool
- you cannot install build dependencies like libfontconfig and clang

## Facets
- artifact type: cli-tool
- maturity: active
- function: pdf-viewer, terminal-ui, search-engine
- domain: pdf, developer-tools
- platform: windows, cli, cross-platform
- tags: tui, rust, ratatui, pdf, terminal, hot-reloading, async-rendering, command-line, linux, macos

## Member repositories
- itsjunetime/tdf (main) score 76

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:57.996354+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:06:59.798956+00:00, confidence not recorded.
  - readme: https://github.com/itsjunetime/tdf (fetched 2026-08-28T04:05:57.996354+00:00, sha 20f05e6823c0)
- Data as of 2026-08-30T08:39:29.467469+00:00.