Code Monkey home page Code Monkey logo

get621's Introduction

get621

build Telegram

Command line tool for e621.net, written in Rust.

Features

  • 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.

Usage

Search for posts

Single post:

get621 asriel_dreemurr order:score

Multiple posts (here, 5):

get621 asriel_dreemurr order:score --limit 5

Note: --limit can be replaced with -l.

Blacklist tags:

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.

Saving posts

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.

Single post:

get621 --save asriel_dreemurr order:score

Multiple posts (here, 10):

get621 --save asriel_dreemurr order:score --limit 10

Note: --save can be replaced with -s.

Bulk saving pools

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.

Reverse search images

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.

Building

  1. Install rust if you don't have it already.

  2. Clone the repository:

    git clone https://github.com/nasso/get621.git
    cd get621
  3. 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.

License

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.

get621's People

Contributors

nasso avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.