Imageboard Downloader

imageboard-downloader-rs is a command-line multi image gallery downloader made in Rust with a very simple, yet extensible API.

It is a cross-platform tool with speed, simple cli interface and multiple simultaneous downloads as its main focus.

Dependencies

Installation

Currently, you can install the latest version using cargo

bash cargo install imageboard_downloader Or by cloning this repository and building it yourself

```bash git clone https://gitlab.com/FerrahWolfeh/imageboard-downloader-rs.git

cd imageboard-downloader-rs

cargo build --release

cargo run --release -- "yourtag" "youranothertag(cool)" -o ~/ ```

The final binary will be located at target/release/imageboard_downloader

Usage

To use the utility simply call it with space-separated tags

bash imageboard_downloader [OPTIONS] <TAGS>... Or run with cargo

bash cargo run -- [OPTIONS] <TAGS>...

See more details with imageboard_downloader --help.

Examples

Download images from danbooru with specified tags:

bash imageboard_downloader "skyfire_(arknights)" In case you want to authenticate with danbooru, use the --auth flag only once. Then all subsequent downloads will use authentication as well.

Download only images with "safe" rating from e621 (also works with danbooru/konachan):

bash imageboard_downloader -i e621 "ash_(pokemon)" "pikachu" --safe-mode

Download images from rule34 with 100 simultaneous downloads: bash imageboard_downloader -i rule34 -d 100 "moe"

By default, the program will download files to your current dir with the following structure ./<gallery_name>/tag1+tag2+.../<file_md5>.png. In case you want to download files to another place use: bash imageboard_downloader "kroos_(arknights)" -o /any/other/dir This will save files in /any/other/dir/danbooru/kroos_(arknights)/<file_md5>.png If the specified directory does not exist, it will be created.

Save downloaded images with their id instead of md5 as filename: bash imageboard_downloader -i e621 "wolf" "anthro" --id

Inspiration and References