1 unstable release

new 0.1.0 Jan 30, 2025

#559 in Images

MIT/Apache

115KB
3K SLoC

A Glowfic-To-Epub converter

Using this software requires Rust.

You can either clone the repository and follow the instructions, or run cargo install glowpub --locked to install glowpub. If you install it, replace cargo run -- with glowpub in the commands below.


To process a specific post clone this repo and, from its directory, run:

cargo run -- post <post-id>

This will download the entire thread and cache it locally, along with all images. It'll then generate a single html file in /books/html/<post-id>.html, and an epub file in /books/epub/<post-id>.epub.


To process an entire board/continuity:

cargo run -- board <board-id>

For example, if you want to download all of planecrash:

cargo run -- board 215

Additional options

Combine these by chaining them after the command.

cargo run -- board 215 --use-cache --jpeg --text-to-speech --flatten-details=mixed --single-file
  • --use-cache: re-use already cached items.
  • --jpeg: convert images in epubs to jpeg, can lead to significantly smaller file sizes.
  • --text-to-speech: change the output in a way that may be more comfortable for text-to-speech.
  • --flatten-details: flatten details tags (see example below). Valid values are --flatten-details=none (default), --flatten-details=all, --flatten-details=mixed. mixed flattens details in epubs only.
  • --single-file: if downloading a board/continuity, output the entire board in a single epub file.

With flatten-details enabled this:

This is a summary This is the hidden content

Becomes more or less:

▼ This is a summary

This is the hidden content

Note that you can't close the latter, so the inherent spoiler protection is compromised, this is mostly useful for ereaders that have trouble with tags.

Dependencies

~37–52MB
~867K SLoC