paraninfodl 1.1.0

Download ebooks from ebooks.paraninfo.es as PDF

paraninfodl

Download ebooks from ebooks.paraninfo.es as PDF. Chromium is installed automatically on first run.

Installation

pipx (recommended)

pipx install git+https://github.com/El-Mundos/paraninfodl

uv

uv tool install git+https://github.com/El-Mundos/paraninfodl

pip

pip install git+https://github.com/El-Mundos/paraninfodl

Arch Linux (AUR)

git clone https://aur.archlinux.org/paraninfodl.git
cd paraninfodl
makepkg -si

Or with an AUR helper:

yay -S paraninfodl
# or
paru -S paraninfodl

From source

git clone https://github.com/El-Mundos/paraninfodl
cd paraninfodl
pip install .

Usage

paraninfodl <url>

The first run opens a browser window for Google login. The session is saved to ~/.paraninfo_session.json and reused automatically from then on.

Options

Flag	Description
-o PATH	Output path for the PDF. Can be a file or a directory. Defaults to ./<book-slug>.pdf.
--quality N	Re-encode images at JPEG quality N (1–95). Lower = smaller file. Omit for lossless.
--text-layer	Add a selectable/searchable text layer to the PDF.
--keep-pages	Keep the downloaded page images after building the PDF.

Examples

# Lossless PDF
paraninfodl https://ebooks.paraninfo.es/reader/my-book

# Compressed + searchable text
paraninfodl https://ebooks.paraninfo.es/reader/my-book --quality 75 --text-layer

# Keep page images for inspection
paraninfodl https://ebooks.paraninfo.es/reader/my-book --keep-pages

Notes

• Only works with books your account has access to.
• The saved session (~/.paraninfo_session.json) contains your cookies — don't share it.
• Page images are cached in ~/.cache/paraninfodl/<book-slug>/ and deleted after the PDF is built (unless --keep-pages is set). Re-running resumes from where it left off regardless of which directory you run from.