SzuruCompanion

A complete workflow for uploading media to Szurubooru (or Oxibooru) from anywhere—browser or mobile—with automatic AI tagging, metadata extraction, and intelligent processing.

Save media from Twitter, Pixiv, Danbooru, 4chan, and 100+ other sites. Share URLs from your phone, right-click images in Chrome, or tap the floating bubble. The CCC backend handles everything: downloading with gallery-dl/yt-dlp, AI tagging with WD14, and uploading to your Szurubooru instance.

Features

Multi-Platform Input

- Browser Extension (Chrome, Firefox, Edge) — Right-click images or use the popup to send URLs - Mobile App (Android) — Share from any app via system share sheet, floating bubble for instant clipboard capture, and built-in job status viewer - Web Dashboard — Real-time job monitoring, queue status, and processing history

Intelligent Processing

- Automatic AI Tagging — WD14 Tagger runs in-process (CPU or GPU), no separate container needed - Metadata Extraction — gallery-dl and yt-dlp parse artist info, descriptions, ratings, and more - Smart Normalization — Handles fxtwitter.com, fixupx.com, ddinstagram.com, and other redirect domains automatically - Site-Specific Handling — Custom logic for Moeview infinite scrolls, 4chan boards, and special cases

Mobile-First Features

- Floating Bubble — Optional overlay that sits on top of other apps; copy a URL anywhere, tap the bubble to queue it instantly - Visual Feedback — Green glow on success, red pulse on failure—know the status without switching apps - Background Sync — Optional folder monitoring for automated uploads from camera/downloads

User Management & Security

- Multi-User Support — Create and manage users through the dashboard with JWT authentication - Per-User Credentials — Each user configures their own Szurubooru and site credentials (Twitter, Sankaku, etc.) - Encrypted Storage — All credentials encrypted at rest in the database - Role-Based Access — Admin and user roles with granular permissions - Category Mappings — Map WD14 tag categories to your Szurubooru instance's custom categories

Queue Management

- Real-Time Monitoring — Track job status, view processing logs, and manage queue in the dashboard - User-Specific Jobs — Jobs are attributed to the user who submitted them - Retry & Control — Pause, resume, stop, or retry failed jobs with visual feedback

Self-Hosted & Private

- All processing happens on your infrastructure - Clients never talk to Szurubooru directly—only to your CCC backend - Easy reverse proxy setup with Nginx Proxy Manager or any standard proxy

License

MIT