dahjah/grawlix
1
0
Fork 0
mirror of https://github.com/jo1gi/grawlix.git synced 2026-07-11 02:34:43 -06:00
Code Issues Actions Packages Projects Releases Wiki Activity
eBook cli downloader
69 Commits 3 Branches 3 Tags 369 KiB
Python 97.6%
Nix 2.4%
d231418a57
Go to file
s0len d231418a57 Fix Nextory: bump X-App-Version and handle null series 
The Nextory API now rejects the old X-App-Version "5.4.1" with an
AppDeprecateError. Bump it to "2026.05.4" (current Android app version).

Also, the product API can return {"series": null} for standalone books
(not just omit the key entirely). The previous `"series" in product_info`
check passed in that case and we crashed on a NoneType subscript.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-21 07:41:05 +02:00
grawlix Fix Nextory: bump X-App-Version and handle null series 2026-05-21 07:41:05 +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 pyproject.toml 2023-05-10 10:22:48 +02: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

README.md

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

From pypi (recommended)

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>