Skip to content

itsjunetime/tdf

Folders and files

NameName
Last commit message
Last commit date

Latest commit

69d5f96 · Mar 23, 2025

History

77 Commits
Feb 19, 2025
Mar 17, 2025
Mar 4, 2025
Mar 4, 2025
Feb 19, 2025
Mar 23, 2025
May 17, 2024
Jul 12, 2024
May 26, 2024
Mar 17, 2025
Mar 23, 2025
Mar 23, 2025
Feb 19, 2025
Feb 19, 2025
May 26, 2024
May 26, 2024

Repository files navigation

tdf

A terminal-based PDF viewer.

Designed to be performant, very responsive, and work well with even very large PDFs. Built with ratatui.

What it looks like

Features:

  • Asynchronous Rendering
  • Searching
  • Hot reloading
  • Responsive details about rendering/search progress
  • Reactive layout

To Build

First, you need to install the system dependencies. This will generally only include libfontconfig. If you're on linux, these will probably show up in your package manager as something like libfontconfig1-devel or libfontconfig-dev.

If it turns out that you're missing one of these, it will fail to compile and tell you what library you're missing. Find the development package for that library in your package manager, install it, and try to build again. Now, the important steps:

  1. Get the rust toolchain from rustup.rs
  2. Clone the repo and cd into it
  3. Run cargo build --release

Why in the world would you use this?

I dunno. Just for fun, mostly.

Can I contribute?

Yeah, sure. Please do.

Please note, though, that all contributions will be treated as licensed under MPL-2.0.