Download

Booru Downloader Guide: How Boorus, Tags & Engines Work

"Booru" comes from the Japanese pronunciation of "board" (imageboard), and it has become the name for a whole family of tag-based image archives. Instead of folders or albums, a booru stores every post as a flat list of tags: the character, the artist, the source, the copyright, the number of people in the frame, even the file type. That is what separates a booru from an ordinary gallery: you don't browse it, you query it. Type a tag and you get every matching post; combine tags and you narrow it down. A booru downloader simply automates that query, so you can save a whole search in one run instead of right-clicking one image at a time.

Most boorus share the same building blocks. Tags are grouped into namespaces (general, artist, character, copyright), so artist:foo and character:bar mean different things. A rating (safe / questionable / explicit on many sites, or a simpler safe-versus-NSFW split on others) is attached to every post so it can be filtered. Pools group related posts in order, which is how multi-page comics or animation cuts stay in sequence. And because the artist is a first-class tag, "download everything by this artist" is just another search. Understanding those four ideas: tags, ratings, pools, and artists, is most of what you need to bulk-download any booru cleanly.

There is no single "booru" program; there are several engines, and knowing which one a site runs tells you how its API and URLs behave. Danbooru is the original Ruby engine. Gelbooru, in its older v0.1 and current v0.2 flavors, powers a large share of the imageboards people use daily. Moebooru is the engine behind high-resolution anime sites like Konachan and yande.re. Shimmie2 runs sites such as Paheal. And Philomena is the modern engine built for Derpibooru. "Bulk downloading a booru" means pointing a tool at one of those APIs, walking every page of a tag or artist search, and saving the full-resolution files locally, ideally with the tags kept so your copy stays as searchable as the original.

Plenty of good tools do this. gallery-dl and imgbrd-grabber are excellent, actively maintained, and cover dozens of boorus; yt-dlp is the go-to for the video-style booru sites. They are also, respectively, a command-line program, a heavier power-user GUI, and a terminal tool: great if that is your world. ArchiveX is one no-command-line option built for Windows 10 and 11. Pick a supported site, paste a tag, artist, or URL, and it bulk-downloads images, GIFs, and videos into a built-in searchable gallery, so the local copy stays as tag-browsable as the site itself. It covers 19 booru, art, and video sites; the per-site guides below walk through each one specifically.

FAQ

What exactly is a "booru"?
A booru is a tag-based imageboard: an archive where every post is labeled with tags instead of sorted into folders, so you find images by searching tag combinations rather than browsing pages. The word comes from the Japanese pronunciation of "board." A booru downloader is any tool that takes one of those tag searches and saves every matching post at once.
How do booru tag search, ratings, and pools actually work?
On most boorus, every post carries namespaced tags (general, artist, character, copyright), a content rating (commonly safe / questionable / explicit), and can belong to pools that keep multi-page sets in order. A search is just a set of tags ANDed together, often with a rating filter applied. A good booru downloader reads those same tags and ratings, so you can grab, for example, one artist's safe-rated posts and keep the tags attached to your local files.
Are all boorus built on the same software?
No: "booru" is a style, not one program. The common engines are Danbooru (the original), Gelbooru v0.1 and v0.2, Moebooru (Konachan, yande.re), Shimmie2 (Paheal and others), and Philomena (Derpibooru). Each exposes a slightly different API and URL format, which is why a booru downloader has to support a site's specific engine rather than treating every site the same.
Is bulk-downloading a booru legal and safe?
Saving publicly posted images for personal, offline use is generally fine, but the honest answer is that it depends on the site's Terms of Service and the copyright of the work. Stick to public content, respect each booru's ToS and rate limits, don't use a downloader to bypass logins or paywalls, and don't redistribute an artist's work. A booru downloader is a convenience tool for content you're already allowed to view, not a license to infringe.
What's the difference between a booru downloader and just saving images in my browser?
Saving in the browser is one file, one right-click, no tags. A booru downloader walks an entire tag or artist search across every page and saves the full-resolution files in a single run, and the better ones keep the tags, so your local copy stays searchable. That is the whole point of bulk-downloading a booru instead of collecting posts by hand.
Once I download a booru tag, can I still search it offline?
Only if the tool keeps the tags. Many downloaders dump files into a folder with cryptic names and drop the metadata, so your local copy becomes a pile of images you can no longer query. Keeping the tags, or using a booru downloader like ArchiveX that stores them in a built-in searchable gallery, is what lets you filter your archive by artist, character, or rating the same way you did on the original site.

Related