eBook cli downloader
Go to file
Mattias Svensson bf2de7c07d nextory: add want-to-read download + stop leaking login tokens
Add a want-to-read flow so the whole 'Saved for later' list can be
downloaded at once: a URL containing 'want-to-read' resolves the user's
want_to_read product list into a Series of book ids, skipping entries with
no epub format (audiobook-only). Mirrors the equivalent feature in
audiobook-dl.

Also remove three leftover rich.print() debug calls in login() that printed
the full session/profile/authorize responses — including the login and
profile tokens — to stdout on every run, and drop a duplicated header update.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-28 10:55:32 +02:00
grawlix nextory: add want-to-read download + stop leaking login tokens 2026-06-28 10:55:32 +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>