eBook cli downloader
Go to file
Mattias Svensson 8118719dbb address review: dedup want-to-read pagination, surface skipped books
- _download_want_to_read: dedup by product id and stop when a page adds
  nothing new, guarding against an infinite loop if the API ignores 'page'.
- download_series: record AccessDenied skips in the failed list too (was
  undercounted) and list the skipped book ids in the summary.
- main: collapse the duplicated GrawlixError/Exception handler bodies.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-28 14:04:09 +02:00
grawlix address review: dedup want-to-read pagination, surface skipped books 2026-06-28 14:04:09 +02:00
.gitignore Add support for marvel unlimited 2023-05-14 17:35:25 +02:00
flake.lock Add nix flake 2025-12-27 14:12:18 +01:00
flake.nix Add nix flake 2025-12-27 14:12:18 +01:00
LICENSE Create LICENSE 2023-04-29 17:14:27 +02:00
pyproject.toml Fix Nextory: bump X-App-Version, null series, missing urllib3 dep (#25) 2026-06-03 07:50:17 +00:00
README.md Add storytel support (#13) 2024-04-02 15:18:45 +00:00
setup.py Add code 2023-04-06 21:38:19 +02:00

grawlix

GitHub release GitHub top language License Donate using Ko-Fi

CLI ebook downloader

Supported services

grawlix currently supports downloading from the following sources:

Installation

pip install grawlix

From repo (unstable)

git clone https://github.com/jo1gi/grawlix.git
cd grawlix
python3 setup.py install

Authentication

Authentication can either be done with login (username and password) or cookies. Not all sources support both methods.

Login

Some sources require authentication, which can be done either with cli arguments or a config file.

Cli example

grawlix --username "user@example.com" --password "SuperSecretPassword" <url>

Config file example

[sources.name]
username = "user@example.com"
password = "SuperSecretPassword"

Config file should be placed in ~/.config/grawlix/grawlix.toml

Cookies

Some sources can be authenticated with Netscape cookie files. I use this extension to export my cookies from my browser.

Cookies can be placed in current dir as cookies.txt or be given with the --cookie argument.

Download books

To download a book run:

grawlix [options] <book url>