Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/Bionus/imgbrd-grabber

Very customizable imageboard/booru downloader with powerful filenaming features.
https://github.com/Bionus/imgbrd-grabber

android booru danbooru downloader gelbooru grabber imageboard linux macos windows

Last synced: about 2 months ago
JSON representation

Very customizable imageboard/booru downloader with powerful filenaming features.

Awesome Lists containing this project

README

        

Grabber

[![Discord chat](https://img.shields.io/discord/780466420877361156?logo=discord&logoColor=white)](https://discord.gg/pWnY5eW3rz)
[![GitHub release](https://img.shields.io/github/release/Bionus/imgbrd-grabber.svg)](https://github.com/Bionus/imgbrd-grabber/releases/latest)
[![GitHub downloads](https://img.shields.io/github/downloads/Bionus/imgbrd-grabber/latest/total.svg)](https://github.com/Bionus/imgbrd-grabber/releases/latest)
[![GitHub downloads](https://img.shields.io/github/downloads/Bionus/imgbrd-grabber/total.svg)](https://github.com/Bionus/imgbrd-grabber/releases)
[![GitHub issues](https://img.shields.io/github/issues/Bionus/imgbrd-grabber.svg)](https://github.com/Bionus/imgbrd-grabber/issues)
[![Donate with PayPal](https://img.shields.io/badge/paypal-donate-orange.svg)](https://www.paypal.me/jvasti)
[![Donate with Patreon](https://img.shields.io/badge/patreon-donate-orange.svg)](https://www.patreon.com/bionus)
[![Build Status](https://img.shields.io/github/actions/workflow/status/Bionus/imgbrd-grabber/build.yml)](https://github.com/Bionus/imgbrd-grabber/actions)
[![Code Coverage](https://img.shields.io/codecov/c/github/Bionus/imgbrd-grabber.svg)](https://codecov.io/gh/Bionus/imgbrd-grabber)
[![Codacy Badge](https://app.codacy.com/project/badge/Grade/3ab9cd9af181458fad287a2663129d98)](https://app.codacy.com/gh/Bionus/imgbrd-grabber/dashboard)
[![Project license](https://img.shields.io/github/license/bionus/imgbrd-grabber.svg)](https://raw.githubusercontent.com/Bionus/imgbrd-grabber/develop/LICENSE)

Imageboard/booru downloader which can download thousands of images from multiple boorus very easily.

Thanks to its powerful naming features, you just have to set your filename and save directory using all the tokens available, and the program will generate a filename using the image's information. With this, you can store and manage your pictures in advanced directory structures, and save image with custom filenames!

Grabber works on Windows, Mac, and Linux. It is available in English, French, Russian, simplified Chinese, and Spanish.

## Download
You can download the latest release [here](https://github.com/Bionus/imgbrd-grabber/releases/latest), or find all previous releases [here](https://github.com/Bionus/imgbrd-grabber/releases).

For users interested, a nightly version is built automatically on every commit on the `develop` branch, and can be downloaded [here](https://github.com/Bionus/imgbrd-grabber/releases/nightly). Note that it might be less stable than official releases, so use at your own risk.

* [Install steps for Windows](https://www.bionus.org/imgbrd-grabber/docs/install/windows.html)
* [Install steps for Linux](https://www.bionus.org/imgbrd-grabber/docs/install/linux.html)
* [Install steps for macOS](https://www.bionus.org/imgbrd-grabber/docs/install/macos.html)
* [Install steps for Android](https://www.bionus.org/imgbrd-grabber/docs/install/android.html)

## Features

### Browse

[](https://www.bionus.org/imgbrd-grabber/assets/img/screenshots/search-basic.png)

* Tabs to make multiple searches at the same time
* Able to show results from multiple imageboards at the same time in a single tab
* Remove duplicate results from multiple-imageboard searches
* Auto-completion of tags in the search field
* Blacklisting of tags to mark or hide images you don't want to see
* Proxy support
* Post-filtering (when the imageboard search is limited)
* Auto-download images as you search according to a whitelist

### Download

[](https://www.bionus.org/imgbrd-grabber/assets/img/screenshots/download.png)

* Download thousands of images at once
* Download single images using their MD5 or ID
* Command line interface to download images

 


 


 


 


 

### Customize

[](https://www.bionus.org/imgbrd-grabber/assets/img/screenshots/sources.png)

* Add your own imageboards very easily
* Authentication for sources behind a login wall
* Theme support using CSS. See [Themes](https://www.bionus.org/imgbrd-grabber/docs/plugins/theme.html) for details.
* Lots of options to customize the program's behaviour

 


 


 

### Organize

[](https://www.bionus.org/imgbrd-grabber/assets/img/screenshots/filename.png)

* Save images using a custom format, for example `%artist%/%copyright%/%character%/%md5%.%ext%`, or using JavaScript code. See [Filename](https://www.bionus.org/imgbrd-grabber/docs/filename.html) for details.
* Favorite tags to keep track of new images
* "View it later" tags to save a search for later
* Support saving images directly to a local booru, such as [Szurubooru](https://www.bionus.org/imgbrd-grabber/docs/commands/szurubooru.html), [MyImouto](https://www.bionus.org/imgbrd-grabber/docs/commands/my-imouto.html), [Gelbooru](https://www.bionus.org/imgbrd-grabber/docs/commands/gelbooru.html), or [Shimmie](https://www.bionus.org/imgbrd-grabber/docs/commands/shimmie.html).
* Can add entries to a database for each image or tag while downloading. See [Commands](https://www.bionus.org/imgbrd-grabber/docs/commands/) for details.
* Conditional filenames triggered by a tag
* Rename already downloaded images

## Default sources
You can add additional sources very easily, but here's a short list of some sources that are included and supported by default:
* Danbooru
* Gelbooru
* E-Hentai
* Pixiv
* yande.re
* Shimmie
* e621
* Konachan
* rule34
* safebooru
* Anime-Pictures
* behoimi
* Zerochan
* Twitter

## Compilation
See the [Compilation](https://bionus.github.io/imgbrd-grabber/docs/compilation.html) documentation to know how to build Grabber.

* Linux: run `./build.sh` at the root of the repository
* macOS: run `./build-mac.sh` at the root of the repository

## Contributors



Jack Vasti

💻 📖 ⚠️

YMI

🐛 🤔

SultrySamthepenna…

🐛

BarryMode

💻 🐛

Ken Swenson

💻 📦

Larry He

💻



brodycas3

🐛

Klion Xu

🌍

MasterPetrik

🐛 🌍 🤔

Eddy Castillo

🌍

MrAndre96

🐛

Umair Ahmed

🐛



ccppoo

🌍

YamiNoSho

🐛 💬 🤔

waitingmoon

🌍

Penguin-Guru

💻

lucas

🌍

Andrei Stepanov

🌍 🐛 🤔

This project follows the [all-contributors](https://github.com/kentcdodds/all-contributors) specification.
Contributions of any kind are welcome!