Download images from the web into monbooru, and find tags for the files already in it.
Paste a URL from a booru, a gallery, any site gallery-dl supports, or a direct image link: monloader fetches the files with their tags, rating and source, and pushes them into a monbooru gallery. For a file monbooru already holds, it looks up tags by md5 or image similarity (IQDB, SauceNAO) on the boorus, or in an optional local copy of the Hydrus Public Tag Repository.
monloader never touches your files directly: everything goes through monbooru's API. It can add images and tags and, for an upgrade monbooru asks for, swap in a better file.
Documentation · Install · Releases · Changelog
 |
 |
- Download a booru post, pool, tag search or artist page, or a direct image link
- Pools and manga: a booru pool imports as an ordered collection; a manga or comic gallery becomes one
.cbzfor monbooru's reader - Tags mapped to monbooru: tags by category (artist, character, copyright, meta...), rating and source, normalized across booru families
- 50+ site profiles for boorus and manga/comic sites; every other gallery-dl site works through a generic fallback
- Update gallery-dl from the app, or roll it back, when a site fix lands, without waiting for a monloader release
- Queue that shows whether each item was added, already in your library, skipped, or failed
- Watched searches: save a tag search or an artist page and monloader checks it on a schedule, fetching only new posts
- Reverse lookup: exact md5 searches on the boorus, IQDB and SauceNAO similarity lookups for re-encoded copies, and offline sha256 lookups in an optional local copy of the Hydrus PTR (needs about 80 GB of disk)
monloader is a companion downloader for monbooru. It fetches images from the web and pushes them into your library:
---
config:
layout: dagre
flowchart:
wrappingWidth: 200
---
flowchart LR
web["`- Any booru or gallery supported by gallery-dl
- Direct image URL`"]
ptr["`Hydrus
Public Tag Repository`"]
sender["`**monsender**
browser extension`"]
loader(["`**monloader**
downloader`"])
booru["`**monbooru**
Your self-hosted booru`"]
web -->|browse| sender
sender -->|send URL| loader
web -->|paste URL| loader
loader -->|push images, tags, source| booru
booru -.->|lookup by hash| loader
loader -.->|reverse lookup: md5 + similarity| web
ptr <-.->|"`sync: sha256 tags + aliases + implications
contribute back`"| loader
classDef hub fill:#5c6bc0,stroke:#9fa8da,stroke-width:3px,color:#ffffff;
classDef tool fill:#16161c,stroke:#5c6bc0,stroke-width:1.5px,color:#e2e2e8;
classDef src fill:#16161c,stroke:#8888a0,stroke-width:1px,color:#8888a0;
class loader hub;
class sender,booru tool;
class web,ptr src;
- monbooru: self-hosted booru; organizes, tags, and serves your collection.
- monloader: this application; fetches files and per-post metadata (via gallery-dl) and pushes them into a monbooru gallery over the REST API; also answers monbooru's reverse lookups (boorus, IQDB/SauceNAO, Hydrus PTR) and source refetches.
- monsender: browser extension; sends the URL of the page you're browsing to monloader.
monloader runs on Linux (x86_64, arm64) and Windows (x86_64), and needs a running monbooru. Once started, it's at http://localhost:8456.
monbooru's docker-compose.yml already includes monloader:
docker compose up -d monloaderDownload a build for your system from the releases, unpack it, and run it.
- lite expects gallery-dl to be installed.
- bundled brings its own gallery-dl.
Beside the portable archives, Windows builds also ship as an installer, Linux bundled builds as an AppImage and as a Flatpak, and Arch has the monloader AUR package.
- In monloader's Settings, check the API URL under Monbooru. The default,
http://monbooru:8455, is right when both run from monbooru's compose file. - Under Pairing, click Connect to monbooru, then approve the request in monbooru under Settings → Plugins.
- Back in monloader, pick the Default gallery and save.
Then paste a URL into the add bar on the home page.
Intended for local network use. monloader's UI is not designed to be exposed to the public internet.