Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/jo1gi/grawlix

eBook cli downloader
https://github.com/jo1gi/grawlix

Last synced: 3 months 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-07-12T21:08:55.000Z (4 months ago)
Last Synced: 2024-07-13T01:32:08.343Z (4 months ago)
Language: Python
Size: 81.1 KB
Stars: 12
Watchers: 2
Forks: 3
Open Issues: 8
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] 

```