Cross-platform desktop app for uploading content to multiple image and file hosts, generating BBcode for forums, monitoring content links, and much more.
- Go to the latest release page
- Download the version for your operating system
- Extract and run the executable (e.g.
bbdrop.exe)
Note: portable versions don't require installation, just unpack and run
git clone https://github.com/twwat/bbdrop.git
cd bbdrop
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
python bbdrop.py --guipython bbdrop.py --guiDrag folders into the upload queue, configure settings, and click Start All. Results appear in the BBCode viewer.
To add a folder to an already-running instance:
python bbdrop.py --gui /path/to/gallerypython bbdrop.py /path/to/images
python bbdrop.py /path/to/images --name "Gallery Name" --template "Forum Post"All CLI flags
| Flag | Description | Default |
|---|---|---|
folder_paths |
Paths to folders containing images | -- |
-v, --version |
Print version and exit | -- |
--gui |
Launch GUI | off |
--name NAME |
Gallery name | folder name |
--size {1,2,3,4,6} |
Thumbnail size: 1=100, 2=180, 3=250, 4=300, 6=150 | 3 |
--format {1,2,3,4} |
Thumbnail format: 1=fixed width, 2=proportional, 3=square, 4=fixed height | 2 |
--max-retries N |
Retry attempts for failed uploads | 3 |
--parallel N |
Simultaneous upload count | 4 |
--template, -t NAME |
BBCode template name | default |
--setup-secure |
Set up secure password storage (interactive) | -- |
--rename-unnamed |
Rename all unnamed galleries from previous uploads | -- |
--debug |
Print all log messages to console | off |
--install-context-menu |
Install Windows right-click menu entry | -- |
--remove-context-menu |
Remove Windows right-click menu entry | -- |
python bbdrop.py --install-context-menuRight-click any folder and select Upload to imx.to (GUI) to add it to the queue. Remove with --remove-context-menu.
| Host | Auth | Max File Size | Storage | Notes |
|---|---|---|---|---|
| IMX.to | API / Session | Unlimited | Unlimited | Gallery/thumbnail hosting, status checking, gallery rename |
| TurboImageHost | Session | Unlimited | Unlimited | Gallery hosting, pycurl-based uploads |
| Host | Auth | Max File Size | Storage | Notes |
|---|---|---|---|---|
| FileBoom | API | 10 GiB | 20 TiB* | Multi-step, deduplication |
| Filedot | Session | Varies | 10 TiB | CAPTCHA handling, CSRF protection |
| Filespace | Cookie | Varies | 50+ GiB (varies) | Cookie-based auth, storage monitoring |
| Katfile | API | Varies | Varies | Session-based upload |
| Keep2Share | API | 10 GiB | 20 TiB* | Multi-step, deduplication |
| Rapidgator | API / Token | 5 GiB | 4+ TiB (varies) | MD5 verification, polling |
| TezFiles | API | Varies | 20 TiB* | Multi-step, deduplication |
* 20 TiB combined storage shared between FileBoom, Keep2Share, and TezFiles.
All hosts support automatic retry, connection pooling, and token caching.
- Upload engine -- concurrent workers, batch processing, drag-and-drop queue, resume, duplicate detection, progress tracking
- Multi-host pipeline -- upload to 2 image hosts and 7 file hosts with host-agnostic ABC architecture
- BBCode templates -- 18 placeholders, multiple templates, switch on the fly
- Cover photos -- automatic cover detection by filename pattern, dimension, and file size; per-host cover gallery support
- Archive management -- create ZIP/7Z archives with configurable compression and split support; extract ZIP, 7Z, RAR, TAR
- Disk space monitoring -- tiered warnings with adaptive polling, pre-flight checks before uploads and archive creation
- Proxy system -- per-host SOCKS5/HTTP proxy support with 3-level resolver (global, category, service)
- Statistics -- upload history, bandwidth tracking, per-host metrics
- Online monitoring -- check availability of previously uploaded files
- Credential storage -- OS keyring with CSPRNG-based Fernet encryption
- Hook system -- run external scripts on upload events with positional placeholders and JSON output parsing
- GUI -- PyQt6, dark/light themes, system tray, single-instance mode, keyboard shortcuts, custom tabs
Config file: ~/.bbdrop/bbdrop.ini
Data directory: ~/.bbdrop/
Templates: ~/.bbdrop/*.template.txt
File host credentials are configured in Settings > File Hosts. Use Test Connection to verify.
BBCode placeholders (18)
| Placeholder | Description |
|---|---|
#folderName# |
Gallery or folder name |
#width# |
Average width |
#height# |
Average height |
#longest# |
Longest dimension |
#extension# |
Common format |
#pictureCount# |
Number of images |
#folderSize# |
Total size |
#galleryLink# |
Image host gallery URL |
#allImages# |
BBCode for all images except cover |
#cover# |
BBCode for cover image |
#hostLinks# |
File host download links |
#custom1# -- #custom4# |
User-defined fields |
#ext1# -- #ext4# |
External link fields (from hooks) |
| Feature | Implementation |
|---|---|
| Credential Storage | Fernet (AES-128-CBC + HMAC-SHA256) encryption with CSPRNG master key, stored in OS Keyring (Windows Credential Manager / macOS Keychain / Linux Secret Service) |
| Transport Security | TLS 1.2+ with SSL certificate verification via certifi CA bundle |
| Token Management | Encrypted token caching with configurable TTL and automatic refresh |
| Database Security | Parameterized SQL queries, SQLite WAL mode |
| Thread Safety | 60+ threading locks protecting shared state |
| Timing Attack Prevention | Constant-time password comparison via secrets.compare_digest() |
| Input Validation | Path normalization, SQL wildcard escaping, column whitelist validation |
pyinstaller bbdrop.specSystem requirements
- OS: Windows 10+, Linux (Ubuntu 20.04+, Fedora 35+), macOS 15+
- Python: 3.12+ (when running from source)
- RAM: 512 MB minimum, 2 GB recommended
- Disk: 100 MB minimum, 500 MB recommended (logs/cache)
Bug reports and feature requests: GitHub Issues.
MIT -- see LICENSE.