dynasty

Dynasty Reader downloader, written in Rust. There is only a CLI for now, I'm planning to make the GUI later when I feel like it.

Installation

There is currently two ways of installing:

Github releases

Download the release and then put it in your path or anywhere you want.

Cargo

Installing using cargo is pretty straighforward, make sure you have Rust installed and then run the command below.

bash cargo install dynasty

cargo will install dynasty-cli in $HOME/.cargo/bin assuming you're using the default installation root.

Usage

This is the --help.

``` dynasty 0.1.0 Aynh aynlazur@gmail.com

USAGE: dynasty-cli [OPTIONS]

ARGS: What to download.

        This could be a Dynasty Reader's URL or the URL's path.

        Targets below are equivalent and will download the series `A Monster Wants to Eat Me`

        "https://dynasty-scans.com/series/a_monster_wants_to_eat_me"
        "series/a_monster_wants_to_eat_me"

        You could also use the chapter's title to download them. Example:

        "Asumi-chan Is Interested In Lesbian Brothels! ch12"
        "Hino-san no Baka ch12.5"

OPTIONS: -d, --dir

The directory to store the downloaded (directory|tag|chapter)s.

        Based on what you supplied as <TARGET>, it will save your downloads on:

        * DIRECTORY: <DIR>/{DIRECTORY}/{TAG_TITLE}/{CHAPTER_TITLE}/{PAGE}.(jpg|png)
        * TAG:       <DIR>/{TAG_TITLE}/{CHAPTER_TITLE}/{PAGE}.(jpg|png)
        * CHAPTER:   <DIR>/{CHAPTER_TITLE}/{PAGE}.(jpg|png)

        [default: .]

-h, --help
        Print help information

-i, --interactive <KIND>
        Interactively select <KIND> instead of downloading directly.

        <KIND> defaults to "chapter" if you don't specify it.

        <KIND> may conflict with <TARGET> argument.

        * chapter conflicts with CHAPTER <TARGET>.
        * tag conflicts with CHAPTER and TAG <TARGET>.

        [possible values: chapter, tag]

-j, --max-concurrent-fetch <NUM>
        Set the maximum number of concurrently running fetches.
        (high value may cause HTTP 503 Error)

        [default: 4]

-V, --version
        Print version information

```

What I mean by DIRECTORY and TAG is the first and the second path after the URL respectively, for example:

https://dynasty-scans.com/series/assaultlilyleagueofgardensfullbloom

series is DIRECTORY, assault_lily_league_of_gardens_full_bloom is TAG.
https://dynasty-scans.com/authors

authors is DIRECTORY, no TAG here.

Examples

These examples assumes the dynasty-cli binary is in your path.

Download the series directory (don't do this).

bash dynasty-cli https://dynasty-scans.com/series

Download the entire Hino-san no Baka with 12 concurrent fetch.

bash dynasty-cli series/hino_san_no_baka -j 12

Using proxy is possible through reqwest, you need to export the HTTPS_PROXY variable. SOCKS proxy also works, just make sure to explicitly set the protocol.

bash HTTPS_PROXY=socks5://127.0.0.1:1080 dynasty-cli kitanai_kimi_ga_ichiban_kawaii_ch26

License

Licensed under either of

Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.