SzuruCompanion

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.

Early Development Notice This project is actively evolving. APIs and behavior may change. Built as a passion project for personal use—contributions and feedback welcome!

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