Quick start

last updated

monbooru on its own needs no quick start beyond its install page. This page is for the next step: adding monloader (downloads and lookups) and the monsender extension to a monbooru you already run.

1. Start with monbooru#

If it is not running yet, follow installing monbooru, then open http://localhost:8455 and check that you can access it.

2. Start monloader#

monloader ships as a service in monbooru’s docker/docker-compose.yml, already on the same network. Start it:

docker compose up -d monloader

Then open http://localhost:8456.

3. Pair monloader with monbooru#

  1. In monloader, go to Settings -> monbooru. The default api url http://monbooru:8455 is right for the shared compose network.
  2. In the pairing section below, click connect to monbooru.
  3. In monbooru, open Settings -> Plugins and approve the request.
  4. Back in monloader, pick a default gallery and save.

The apps then exchange tokens themselves. From now on monloader pushes downloads into that gallery.

To try it, paste a post URL from a booru site into monloader’s queue page; the image lands in monbooru with its tags.

4. Add the browser extension#

  1. Install monsender in Firefox or Chrome.
  2. In the extension options, set the monloader URL - the address your browser reaches it at, so http://localhost:8456 on the same machine, or your server’s LAN address like http://monloader.lan:8456.
  3. Click connect to monloader, then approve the request in monloader under Settings -> pairing.

Now browse to a post on a supported site and press the toolbar button (or Ctrl+Shift+L). The page goes to monloader, downloads, and lands in monbooru.

Where next#