⚠️ Using commands can slow down huge batch downloads (a recent computer may need from 100ms to 1s more per image) ⚠️
Follow the official INSTALL.md documentation from the Szurubooru repository. Note that you’ll need to have Docker installed.
Don’t forget to update the
MOUNT_ variables in the
If you’re having issues setting it up (for example with filesystem permissions), there is a Common errors page in their wiki that might be of help for troubleshooting.
You need NodeJS to be installed on your machine to use the upload script used by Grabber. You can download it from their website, or from a package manager here.
Download the szurubooru.js file into Grabber’s installation folder.
ℹ️ If your Szurubooru instance is not on the same machine as Grabber, or simply not accessible at
http://localhost:8080/, make sure to update the URL in the script.
This script uses the NodeJS “axios” and “form-data” plugins, so you can install them with:
npm install -g axios form-data
Make sure the
NODE_PATH environment variable is properly set to point to your global node_modules folder. On Windows, it’s usually:
But you can check the exact path with:
npm root -g
Open Grabber, then go to “Options > Commands”, and set the “Image” field to:
node szurubooru.js "YOUR_USERNAME" "YOUR_TOKEN" "%all:includenamespace,unsafe,underscores%" "%rating%" "%source:raw%" "%path:nobackslash%"
Make sure to replace
YOUR_USERNAME by your Szurubooru username, and
YOUR_TOKEN by the token created earlier (in the
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx format or similar).
This command will be run every time an image is saved, causing it to also be sent to your Szurubooru instance!