Skip to content

A client made in python that use the gelbooru apy to download image with specified tag

Notifications You must be signed in to change notification settings

neoluigi4123/Gelbooru-Image-Downloader

Repository files navigation

(current version is 1.1)

Gelbooru Image Downloader

A Python client that uses the Gelbooru API to download images with specified tags. Can download image, video, gifs....

screencap

How to install it

You must verify your api key and user id from gelbooru here.

and once its done, just follow the instruction in the last release then you're good to go!

However, if you want to use an older version of the software, you can go over the release tab on the right, then chose your version.. Good luck!

image

How It Works

Tags

Enter your tags in the first text box. Tags should not contain any underscores (_) and must be comma-separated. The tags must also exist on Gelbooru; any typo or non-existent tag won't work.

API Key / User ID

To use the software, you must have an account on Gelbooru and then get your API key and user ID. The script saves your API key and user ID the first time you use it, so don't worry about losing them—the app takes care of everything.

To get them, check How to set up your Gelbooru API key and user ID.

Custom Directory

You can use any directory you want by checking the "Use Custom Directory" button, then either paste any directory or browse for one with the "Browse" button. The app will automatically use C:/Users/pc/Pictures/tag if you don't specify a custom one.

Download a Specific Number of Images

If unchecked, you'll download every image that can be found with the tags you entered. To download a specific number of images, you can check "Limit Max Images" and then input the desired number.

Clean Up

The cleanup function can take a significant amount of time based on how many images you want to download. It will check each image's content, and if it detects duplicates, it will delete them. (Note: it only detects exact duplicates. If an image is the same as another but with a text bubble or minor differences, it will count as a different one.)

Open Directory After Download

Check this option if you want to automatically open the folder with the downloaded images at the end of the download.

Fast Download

Because Gelbooru cannot send 100 images at the speed of light, there is some delay to ensure that the data is correctly downloaded and the server doesn't block the process. You can use "Fast Download" to download a smaller amount of images faster (500-1000), but this will be less accurate and is more likely to crash.

How to Set Up Your Gelbooru API Key and User ID

Create the Gelbooru Account

If you don't already have an account, go to this link to create one (don't forget to read their TOS that no one reads anyway: TOS).

Get Your API Key / User ID

Once your account is created, go to this URL to see your settings, which contain your API key and user ID. Scroll all the way down, and you'll see them.

image

Just grab them and paste them into the app, and you're good to go!

image

The script saves your API key and user ID the first time you use it, so don't worry about losing them—the app takes care of everything.

About

A client made in python that use the gelbooru apy to download image with specified tag

Resources

Stars

Watchers

Forks

Packages

No packages published