File size: 2,177 Bytes
283b6c6 75107ce 283b6c6 b3ed3e9 283b6c6 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 | ---
title: Imageboard Grabber
emoji: 🖼️
colorFrom: indigo
colorTo: purple
sdk: docker
app_port: 7860
pinned: true
---
# Imageboard Grabber
Booru-style imageboard grabber (inspired by Bionus/Grabber): tag search, thumbnail grid, multi-select, server-side batch ZIP download. Ships with **e621** preconfigured and a **schema-based "Add site" panel** for Danbooru/Gelbooru/Safebooru/etc.
## Features
- **Tag exclusion on ZIP download:** Specify custom tags to filter out of the compiled ZIP's `.txt` tag list and markdown meta files.
- **Direct Hugging Face dataset upload:** Enter your Hugging Face write token and desired dataset repository name to instantly package and upload your compiled archives to a Hugging Face dataset. Creates the dataset automatically if it does not already exist.
## Run locally with Docker
```bash
docker build -t grabber .
docker run --rm -p 7860:7860 grabber
```
Then open http://localhost:7860.
## Deploy to Hugging Face Spaces
1. Push this repo to GitHub (Lovable → GitHub sync, or `git push`).
2. Create a new Space on Hugging Face → **SDK: Docker**.
3. Link the GitHub repo (or add the Space as a remote and push).
The frontmatter above tells HF Spaces to build the `Dockerfile` and serve on port `7860`.
## Adding a custom site
Click **+ Add site** and paste the site's API schema:
- **Base URL / Search Path** — e.g. `https://danbooru.donmai.us` + `/posts.json`
- **Param names** for tags / page / limit
- **JSON path** to the posts array (empty = root)
- **Field mappings** (dotted paths) for `id`, `previewUrl`, `fileUrl`, `ext`, `tags`, `source`, `rating`, `score`
Example (Danbooru):
```
baseUrl: https://danbooru.donmai.us
searchPath: /posts.json
postsPath: (empty)
fields.id: id
fields.previewUrl: preview_file_url
fields.fileUrl: file_url
fields.ext: file_ext
fields.tags: tag_string_general
fields.source: source
fields.rating: rating
fields.score: score
```
## Tech
- TanStack Start (React 19, Vite 7) + Tailwind v4 + shadcn/ui
- Server-side image fetching and streaming ZIP via `fflate`
- Node server build via nitro `node-server` preset
|