Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jo1gi/grawlix
eBook cli downloader
https://github.com/jo1gi/grawlix
Last synced: about 1 month ago
JSON representation
eBook cli downloader
- Host: GitHub
- URL: https://github.com/jo1gi/grawlix
- Owner: jo1gi
- License: gpl-3.0
- Created: 2023-04-06T19:37:37.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2024-10-30T11:36:45.000Z (about 2 months ago)
- Last Synced: 2024-10-30T12:29:31.802Z (about 2 months ago)
- Language: Python
- Size: 83 KB
- Stars: 16
- Watchers: 4
- Forks: 6
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- starred - jo1gi/grawlix - eBook cli downloader (Python)
README
# grawlix
![GitHub release](https://img.shields.io/github/v/release/jo1gi/grawlix)
![GitHub top language](https://img.shields.io/github/languages/top/jo1gi/grawlix)
![License](https://img.shields.io/github/license/jo1gi/grawlix)
[![Donate using Ko-Fi](https://img.shields.io/badge/donate-kofi-00b9fe?logo=ko-fi&logoColor=00b9fe)](https://ko-fi.com/jo1gi)CLI ebook downloader
## Supported services
grawlix currently supports downloading from the following sources:
- [DC Universe Infinite](https://www.dcuniverseinfinite.com)
- [eReolen](https://ereolen.dk)
- [fanfiction.net](https://www.fanfiction.net)
- [Flipp](https://flipp.dk)
- [Internet Archive](https://archive.org)
- [Manga Plus](https://mangaplus.shueisha.co.jp)
- [Marvel Unlimited](https://marvel.com)
- [Nextory](https://nextory.com)
- [Royal Road](https://www.royalroad.com)
- [Saxo](https://saxo.com)
- [Storytel / Mofibo](http://storytel.com)
- [Webtoons](https://webtoons.com)## Installation
### From pypi (recommended)
```shell
pip install grawlix
```### From repo (unstable)
```shell
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**
```shell
grawlix --username "[email protected]" --password "SuperSecretPassword"
```**Config file example**
```toml
[sources.name]
username = "[email protected]"
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](https://github,com/rotemdan/ExportCookies) 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:
```shell
grawlix [options]
```