Jeromos Kovács
59c0e2338b
* ci: format * ci: run on tag push, manual dispatch * ci: release a tip on each push to `main` and tag release on tag pushes * ci: run on more platforms * ci: don't fail fast * ci: enable windows * Update .github/workflows/rust.yml Co-authored-by: June <61218022+itsjunetime@users.noreply.github.com> * Update .github/workflows/rust.yml Co-authored-by: June <61218022+itsjunetime@users.noreply.github.com> * Update .github/workflows/rust.yml Co-authored-by: June <61218022+itsjunetime@users.noreply.github.com> * chore: update custom `ratatui-image` rev * Update .github/workflows/rust.yml Co-authored-by: June <61218022+itsjunetime@users.noreply.github.com> * Update .github/workflows/rust.yml Co-authored-by: June <61218022+itsjunetime@users.noreply.github.com> * chore(deps): update kittage * Update kittage for maybe more windows fixes * Update kittage again for more windows fixes * Update kittage again..... * Maybe actually compile windows correctly now? * update kittage * oopsie forgot abt lock file * windows and kittage again ... * maybe fix the file path conversion stuff? * kittage once again........... --------- Co-authored-by: June <61218022+itsjunetime@users.noreply.github.com> Co-authored-by: itsjunetime <junewelker@gmail.com>
tdf
A terminal-based PDF viewer.
Designed to be performant, very responsive, and work well with even very large PDFs. Built with ratatui.
Features:
- Asynchronous Rendering
- Searching
- Hot reloading
- Responsive details about rendering/search progress
- Reactive layout
Installation
- Get the rust toolchain from rustup.rs
- Run
cargo install --git https://github.com/itsjunetime/tdf.git
If you want to use this with epubs or cbzs, add --features epub or --features cbz to the command line (or --features cbz,epub for both)
To Build
First, you need to install the system dependencies. This will generally only include libfontconfig and clang. If you're on linux, these will probably show up in your package manager as something like libfontconfig1-devel or libfontconfig-dev and just clang.
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:
- Get the rust toolchain from rustup.rs
- Clone the repo and
cdinto it - Run
cargo build --release
The binary should then be found at ./target/release/tdf.
You can also pull this in via radicle with rad clone rad:zb11K1XGfQooopqEfwtCMyvbcyK1
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:
- No AI-generated or AI-assisted or AI-viewed or AI-anythinged code will be accepted. "AI" is a plague upon this earth and I won't be caught dead pretending it's normal.
- All contributions will be treated as licensed under MPL-2.0 :)