BBDrop Documentation¶
Welcome to BBDrop — a desktop application for batch uploading image galleries to multiple image and file hosts with BBCode output and persistent queue management.
Getting Started¶
New to BBDrop? Start here.
- Installation — Download and install BBDrop
- Quick Start — Upload your first gallery in 5 minutes
- Key Concepts — Image hosts, file hosts, templates, and queues
Tutorials¶
Step-by-step walkthroughs for common workflows.
- Setting Up IMX.to — Configure authentication, thumbnails, and gallery renaming
- Creating a Custom Template — Build a BBCode template with placeholders and conditionals
- Adding File Host Downloads — Enable file hosts for automatic archive upload
Guides¶
Task-oriented instructions for specific features.
Core¶
- GUI Guide — Interface walkthrough, tabs, and queue management
- Customize the Layout — Rearrange, float, and tab the dockable panels
- Image Hosts — IMX.to, Pixhost, and TurboImageHost configuration
- Multi-Host Upload — Upload to 7 premium file hosts
- File Manager — Browse and manage files on remote file hosts
- Queue Management — Queue operations, tabs, columns, context menu
- Scanning & Link Checking — Image scanning, link checker, cover photos
- BBCode Templates — Placeholders and conditional logic
- Proxies & Tor — Proxy pools, per-host proxy, Tor integration
Advanced¶
- Archive Management — ZIP, RAR, 7Z extraction and creation
- Duplicate Detection — Identify previously uploaded galleries
- Hooks & Automation — External app integration
- Credential Management — Secure password and API key storage
- Theme Customization — Dark, light, and auto themes
Explanation¶
Understand how BBDrop works under the hood.
- Upload Pipeline — How galleries flow from queue to hosted images
- Security Model — Credential encryption, transport security, and thread safety
- Queue & Persistence — How the queue survives restarts and manages state
Reference¶
Quick lookup for settings, shortcuts, and parameters.
- Settings — All settings by category
- Keyboard Shortcuts — Complete shortcut reference
- Template Placeholders — All placeholders including video
- External App Parameters — Hook variable reference
- CLI Reference — Command-line flags and usage
- Quick Reference — One-page cheat sheet
Troubleshooting¶
- FAQ — Frequently asked questions
- Common Issues — Known problems and solutions
- Troubleshooting Guide — Systematic diagnosis
- Silent Failures — When uploads fail without feedback
- Log Diagnosis — Interpret log files
- WSL2 Drag & Drop — Fix drag-and-drop in WSL2
Architecture & Decisions¶
- System Overview — C4 system context diagram
- Application Components — C4 container diagram
- Decision Log — Architecture Decision Records