# Bibe

[![License](https://img.shields.io/badge/License-BSD%203--Clause-blue.svg)](https://opensource.org/licenses/BSD-3-Clause)

Bibe is a command-line tool that allows you to download every chapter (or a
subset) of a series from websites like `webtoons.com` or `mangadex.org`.

## Supported website

- [MangaDex](https://mangadex.org/)
- [MangaKakalot](https://mangakakalot.com/)
- [WEBTOON](https://www.webtoons.com/)
- [WebtoonScan](https://webtoonscan.com/)

## How to install

### Pre-compiled binaries

You can download a pre-compiled executable for Linux, MacOS and Windows
operating systems, then you should copy that executable to a location from your
`$PATH` env:

- [Linux 64bit](https://github.com/TehUncleDolan/spiders/releases/download/bibe-v0.1.0/bibe_amd64)
- [MacOS 64bit](https://github.com/TehUncleDolan/spiders/releases/download/bibe-v0.1.0/bibe_darwin)
- [Windows 64bit](https://github.com/TehUncleDolan/spiders/releases/download/bibe-v0.1.0/bibe.exe)

You might need to run `chmod +x bibe_amd64` or `chmod +x bibe_darwin`.

### Build Manually

If you prefer to build `bibe` manually, or a pre-compiled executable is not
provided for your platform, then you can build `bibe` from the source:

- [Install Rust](https://www.rust-lang.org/tools/install)
- Run `cargo install bibe`

## Usage

```bash
USAGE:
    bibe [OPTIONS] --url <url>

FLAGS:
    -h, --help       Prints help information
    -V, --version    Prints version information

OPTIONS:
    -b, --begin <begin>       Start downloading from this chapter [env: BIBE_BEGIN=]
    -d, --delay <delay>       Delay between each request (in ms) [env: BIBE_DELAY=] [default: 1000]
    -e, --end <end>           Stop downloading after this chapter [env: BIBE_END=]
    -g, --group <group>...    Preferred scantrad group in case of conflict [env: BIBE_GROUPS=]
    -l, --lang <lang>         Chapters language [env: BIBE_LANG=] [default: gb]
    -o, --output <output>     Output directory [env: BIBE_OUTPUT=] [default: .]
    -r, --retry <retry>       Max number of retry for HTTP requests [env: BIBE_RETRY=] [default: 3]
    -u, --url <url>           Series URL [env: BIBE_URL=]
```

The simplest invocation only requires you to specify the URL of the series you
want to download, the other options have sensible defaults.

```bash
bibe -u "https://www.webtoons.com/fr/thriller/hell-is-other-people/list?title_no=1841"
```

If you only want to download a subset of the chapters, you can specify a range.
For example, the following command will download the first 10 chapters under the
specified directory:

```bash
bibe --url "https://www.webtoons.com/fr/thriller/hell-is-other-people/list?title_no=1841" \
     --begin 1
     --end 10
     --output ~/Documents/Books/Webtoons
```