Command line tool for e621.net, written in Rust.
- Regular tag searching, using any of the search options from the website.
- Pool bulk downloading.
- Post downloading.
- Parents/children posts fetching.
- Posts/pools bulk downloading.
- Unlimited result count (automatically splits into multiple API requests).
- Reverse image searching (experimental).
- Various output modes:
- "verbose" (artist, id, tags, description...).
- "raw" (posts are downloaded to the standard output).
- "id" (post IDs are printed to the standard output).
Note: there can be up to 6 tags at once. Trying to search for more will cause a 422 "Unprocessable entity" HTTP error. This is an API limitation.
get621 asriel_dreemurr order:score
get621 asriel_dreemurr order:score --limit 5
Note: --limit
can be replaced with -l
.
get621 asriel_dreemurr order:score -- -solo -chicken
Note: Since the syntax to blacklist a tag uses a dash, it must be placed after
two dashes --
to make the difference between a blacklisted tag and a command
option/flag (such as -l
or --limit
). As a result, anything after --
will
be treated as a tag for the request.
This will download posts to the current working directory as <id>.<ext>
.
This will overwrite any file with the same name in the current working directory, without any warning.
get621 --save asriel_dreemurr order:score
get621 --save asriel_dreemurr order:score --limit 10
Note: --save
can be replaced with -s
.
This will download posts to the current working directory as
<pool_id>-<page>_<post_id>.<ext>
.
This will overwrite any file with the same name in the current working directory, without any warning.
get621 --pool <pool_id> --save
Note: --pool
can be replaced with -P
.
get621 reverse path/to/image1.png /another/image2.gif ./glob/**/pattern/*.jpg
Note: -s
or --save
can be used to download posts to the current working
directory.
-
Install rust if you don't have it already.
-
Clone the repository:
git clone https://github.com/nasso/get621.git cd get621
-
Use Cargo to build get621:
-
For debug builds:
cargo build
-
For release builds:
cargo build --release
-
Note: Linux users will probably need to have OpenSSL installed with the
development packages to compile the openssl-sys
crate (e.g. libssl-dev
on
Ubuntu and openssl-devel
on Fedora). pkg-config
is also required when
targeting Linux.
get621
is licensed under the terms of either the MIT license or the Apache
License (Version 2.0), at your choice.
See LICENSE-MIT and LICENSE-APACHE-2.0.