arnaucube
arnaucube/link2epub-rsPublic Self-hosted repository
1 branches
History
README

link2epub-rs

This tool was initially implemented in Go at https://github.com/arnaucube/link2epub . This repo is a rust implementation of the same idea, more up to date.

CLI to download articles and convert them to .epub/.mobi files.

It gets the text content, simplifies its html, downloads the images, and builds the .epub/.mobi file. AVIF article images are converted to PNG for compatibility with ebook readers. Most AVIF images are decoded directly in Rust. Bitstreams not yet supported by the Rust decoder require avifdec from libavif on PATH (nix shell nixpkgs#libavif).

The motivation is to read web articles offline in your e-reader.

Usage

Build with the current stable Rust toolchain:

cargo build --release

Place the binary in the ~/bin directory for a comfortable usage from anywhere.

link2epub 'https://link.com/to-the-article'

# optionally add extension (by default .epub)
link2epub 'https://link.com/to-the-article' -t mobi

# see help for all the available flags
link2epub --help

mobi generation requires Calibre’s ebook-convert command on PATH. epub generation has no external runtime dependencies.