A fork of neobooru/SzuruChrome with quality-of-life improvements, bug fixes, and a modernized UI.
Browser extension (Chrome / Firefox / Waterfox) for importing media from various booru sites into a self-hosted szurubooru instance.
| Feature | Description |
|---|---|
| Right-Click Quick Import | Right-click any booru page → "Import to selected Szuru instance" — imports instantly without opening the popup. |
| Hotkey Import | Configure a custom keyboard shortcut to import the current page with one keypress. |
| Import + Link Last Hotkey | A second configurable hotkey imports the current page and links it with the previously uploaded post. Consecutive uses build a link-chain. |
| Batch Import | On booru listing/gallery pages a launcher lets you select many posts and import them all at once — each is opened in a background tab, scraped, uploaded and closed, with a live progress bar. |
| Pool Import | Enter a pool name before starting a batch and every imported post is added to that szurubooru pool, in selection order (creating the pool if it doesn't exist). |
| Sequential Import Queue | Hotkey, context-menu and link-chain imports process strictly one after another, with automatic retry of transient failures (network drops, timeouts, HTTP 429/5xx). The queue survives a Chrome MV3 service-worker restart mid-burst. |
| Auto-Relations | After upload a reverse-image search runs automatically; posts above the configurable similarity threshold (default 60%) are linked as relations. Toggle in Settings → General. |
| Exact-Duplicate Handling | For 100% matches the higher-quality file is kept and tags/sources are merged instead of creating a duplicate. |
| Feature | Description |
|---|---|
| Tag Blacklist & Rename Rules | Patterns that drop or rewrite scraped tags before upload — exact names, * globs, or full regex with $1 back-references, plus a live tester. Applies to popup and hotkey imports alike. |
| Tag Suggestions | After the reverse search, the popup offers the most common tags from visually similar posts as one-click chips (no extra API calls). |
| Auto-import all tags | Automatically imports all tags including their categories on supported pages (Danbooru, Zerochan, etc.). |
| Tag Category Colors | Map szurubooru tag categories to display colors, with a native color picker and one-click import from the instance. |
| Fallback Source Tag Import | When a fallback source URL is used, tags from the original booru source are also imported — no tags lost. |
| Feature | Description |
|---|---|
| "Already Imported" Badge | A small pill on booru pages whose source already exists in your instance, linking to the post — no need to open the popup to check. |
| Statistics Tab | Imports, duplicates, failures, success rate, transferred volume, a 30-day activity chart and per-host / per-instance breakdown — plus a list of failed imports you can retry with one click. |
| Config Export / Import | Export all settings to a JSON file (optionally without auth tokens) and restore them — handy across browsers and profiles. |
| Glass Notify Toasts | Import status notifications in a modern glassmorphism style with progress, download speed and a compact completion history. |
| Multi-Language (EN/DE) | Switch the extension UI between English and German in Settings → Interface. |
| Fix | Description |
|---|---|
| 403 / CDN hotlink protection | Content uploads include credentials and Referer, with a multi-strategy CDN fetch (page-context fetch, credentials + Referer, XHR) and per-request CORS injection. |
| MV3 FormData upload | Temp-file uploads use native fetch() instead of the Axios fetch adapter, which silently failed on multipart uploads in Chrome/Brave service workers. |
| Octet-Stream / ArrayBuffer | Binary data is base64-encoded during message passing to survive MV3 serialization; missing MIME types are detected from the file extension. |
| Filename Preservation | Uploaded files retain their original filename from the source URL. |
Popup on a booru page
Batch import — select posts on a listing page
| Settings — General (tag rules) | Settings — Statistics |
|---|---|
 |
 |
| Settings — Interface (backup) | Settings — Tags |
 |
 |
| Settings — Instances | Settings — Changelog |
 |
 |
- Download the
.xpifrom the Releases tab - Open
about:addons→ gear icon → "Install Add-on From File…" → select the.xpi - Alternatively:
about:debugging→ "This Firefox" → "Load Temporary Add-on" → select the.xpi
Note: For unsigned XPIs, set
xpinstall.signatures.required = falseinabout:config.
- Download the extension ZIP from the Releases tab
- Extract the ZIP anywhere (you'll get a folder containing
manifest.json) - Open
chrome://extensions/ - Enable Developer mode (toggle in the top-right)
- Click Load unpacked and select the extracted folder
Chrome has no signed store build yet, so it's loaded unpacked — Developer mode has to stay enabled. Want to build it yourself instead? See Build.
npm install # Install dependencies
npm run build # Firefox/Waterfox production build → ./extension/
npm run build:chrome # Chrome/Brave/Edge production build → ./extension/
npm run pack:xpi # Build Firefox .xpi → ./extension.xpi
npm run dev # Dev mode with HMRAfter building, load the extension/ folder in your browser:
- Chrome:
chrome://extensions/→ "Load unpacked" → select./extension - Firefox:
about:debugging→ "Load Temporary Add-on" → select any file in./extension
- Vue 3 + Composition API +
<script setup> - Pinia for state management
- PrimeVue 3 + PrimeFlex for UI components
- Vite 5 as build tool (two configs: main app + content script)
- webextension-polyfill for cross-browser compatibility
- neo-scraper for booru page scraping
This project is a fork of neobooru/SzuruChrome (v1.1.24). All original credit goes to neobooru and contributors.
Ein Fork von neobooru/SzuruChrome mit Quality-of-Life-Verbesserungen, Bugfixes und einer modernisierten Oberfläche.
Browser-Extension (Chrome / Firefox / Waterfox) zum Importieren von Medien von verschiedenen Booru-Seiten in eine selbst-gehostete szurubooru-Instanz.
| Feature | Beschreibung |
|---|---|
| Rechtsklick Quick Import | Rechtsklick auf jeder Booru-Seite → "Zur gewählten Szuru-Instanz importieren" — importiert sofort ohne das Popup zu öffnen. |
| Hotkey Import | Konfigurierbare Tastenkombination zum sofortigen Import der aktuellen Seite. |
| Import + letzten Post verknüpfen | Ein zweites Tastenkürzel importiert die aktuelle Seite und verknüpft sie mit dem zuvor hochgeladenen Post. Mehrfach-Nutzung bildet eine Verknüpfungskette. |
| Batch-Import | Auf Listen-/Galerie-Seiten erscheint ein Starter, mit dem du viele Posts auswählen und auf einmal importieren kannst — jeder wird in einem Hintergrund-Tab geöffnet, gescrapt, hochgeladen und geschlossen, mit Live-Fortschritt. |
| Pool-Import | Vor dem Batch einen Pool-Namen eingeben, und jeder importierte Post wird in Auswahlreihenfolge diesem szurubooru-Pool hinzugefügt (wird angelegt, falls nicht vorhanden). |
| Sequentielle Warteschlange | Hotkey-, Kontextmenü- und Ketten-Importe laufen strikt nacheinander, mit automatischer Wiederholung vorübergehender Fehler (Netzwerkabbruch, Timeout, HTTP 429/5xx). Die Queue übersteht einen MV3-Service-Worker-Neustart mitten in einer Serie. |
| Auto-Relationen | Nach dem Upload läuft automatisch eine Reverse-Image-Suche; Posts über dem konfigurierbaren Schwellwert (Standard 60%) werden als Relationen verknüpft. Umschaltbar unter Einstellungen → Allgemein. |
| Exakte-Duplikat-Behandlung | Bei 100%-Treffern wird die höherwertige Datei behalten und Tags/Quellen werden zusammengeführt, statt ein Duplikat anzulegen. |
| Feature | Beschreibung |
|---|---|
| Tag-Blacklist & Umbenennungs-Regeln | Muster, die gescrapte Tags vor dem Upload verwerfen oder umschreiben — exakte Namen, *-Globs oder vollständige Regex mit $1-Rückverweisen, plus Live-Tester. Gilt für Popup- und Hotkey-Import. |
| Tag-Vorschläge | Nach der Reverse-Suche bietet das Popup die häufigsten Tags ähnlicher Posts als Ein-Klick-Chips an (ohne zusätzliche API-Aufrufe). |
| Alle Tags automatisch importieren | Importiert automatisch alle Tags inklusive Kategorien auf unterstützten Seiten (Danbooru, Zerochan, etc.). |
| Tag-Kategorie-Farben | szurubooru-Tag-Kategorien auf Anzeigefarben mappen, mit nativem Farbwähler und Ein-Klick-Import aus der Instanz. |
| Fallback-Quellen-Tags | Wird eine Fallback-Quelle genutzt, werden auch die Tags der Originalquelle importiert — keine Tags gehen verloren. |
| Feature | Beschreibung |
|---|---|
| "Bereits importiert"-Badge | Eine kleine Pille auf Booru-Seiten, deren Quelle schon in deiner Instanz existiert, mit Link zum Post — kein Popup-Öffnen zum Nachsehen nötig. |
| Statistik-Tab | Importe, Duplikate, Fehler, Erfolgsquote, übertragenes Volumen, 30-Tage-Diagramm und Aufschlüsselung pro Host / Instanz — plus eine Liste fehlgeschlagener Importe, die sich mit einem Klick wiederholen lassen. |
| Konfiguration Export / Import | Alle Einstellungen als JSON exportieren (optional ohne Auth-Tokens) und wiederherstellen — praktisch über Browser und Profile hinweg. |
| Glass-Benachrichtigungs-Toasts | Import-Status im modernen Glasmorphismus mit Fortschritt, Download-Geschwindigkeit und kompaktem Verlauf. |
| Mehrsprachig (EN/DE) | Extension-Oberfläche unter Einstellungen → Oberfläche zwischen Englisch und Deutsch umschalten. |
| Fix | Beschreibung |
|---|---|
| 403 / CDN-Hotlink-Schutz | Content-Uploads enthalten Credentials und Referer, mit Multi-Strategie-CDN-Fetch (Page-Context-Fetch, Credentials + Referer, XHR) und CORS-Injektion pro Request. |
| MV3 FormData-Upload | Temp-Datei-Uploads nutzen natives fetch() statt des Axios-Fetch-Adapters, der bei Multipart-Uploads in Chrome/Brave-Service-Workern still fehlschlug. |
| Octet-Stream / ArrayBuffer | Binärdaten werden bei der Nachrichtenübermittlung base64-kodiert, um MV3-Serialisierung zu überleben; fehlende MIME-Typen werden aus der Dateiendung erkannt. |
| Dateinamen-Erhaltung | Hochgeladene Dateien behalten ihren originalen Dateinamen aus der Quell-URL. |
Popup auf einer Booru-Seite
Batch-Import — Posts auf einer Listen-Seite auswählen
| Einstellungen — Allgemein (Tag-Regeln) | Einstellungen — Statistik |
|---|---|
|
|
| Einstellungen — Oberfläche (Backup) | Einstellungen — Tags |
|
|
| Einstellungen — Instanzen | Einstellungen — Changelog |
|
|
.xpiaus dem Releases-Tab herunterladenabout:addons→ Zahnrad-Icon → "Add-on aus Datei installieren…" →.xpiauswählen- Alternativ:
about:debugging→ "Dieser Firefox" → "Temporäres Add-on laden" →.xpiauswählen
Hinweis: Für unsignierte XPIs:
xpinstall.signatures.required = falseinabout:configsetzen.
- Das Extension-ZIP aus dem Releases-Tab herunterladen
- Das ZIP irgendwohin entpacken (du erhältst einen Ordner mit
manifest.json) chrome://extensions/öffnen- Entwicklermodus aktivieren (Schalter oben rechts)
- Entpackte Erweiterung laden klicken und den entpackten Ordner auswählen
Für Chrome gibt es noch keinen signierten Store-Build, daher wird er entpackt geladen — der Entwicklermodus muss aktiviert bleiben. Lieber selbst bauen? Siehe Build.
npm install # Dependencies installieren
npm run build # Firefox/Waterfox Production-Build → ./extension/
npm run build:chrome # Chrome/Brave/Edge Production-Build → ./extension/
npm run pack:xpi # Firefox .xpi bauen → ./extension.xpi
npm run dev # Dev-Modus mit HMRNach dem Build den extension/-Ordner im Browser laden:
- Chrome:
chrome://extensions/→ "Entpackte Erweiterung laden" →./extensionauswählen - Firefox:
about:debugging→ "Temporäres Add-on laden" → beliebige Datei in./extensionauswählen
- Vue 3 + Composition API +
<script setup> - Pinia für State-Management
- PrimeVue 3 + PrimeFlex für UI-Komponenten
- Vite 5 als Build-Tool (zwei Configs: Haupt-App + Content-Script)
- webextension-polyfill für Cross-Browser-Kompatibilität
- neo-scraper zum Scrapen von Booru-Seiten
Dieses Projekt ist ein Fork von neobooru/SzuruChrome (v1.1.24). Alle Credits gehen an neobooru und die Mitwirkenden.