bbdrop

BBDrop Quick Reference

A concise reference card for common operations and settings.

Starting the Application

# GUI Mode (recommended)
python bbdrop.py --gui

# CLI Mode
python bbdrop.py /path/to/folder --name "Gallery Name"

# Debug Mode (verbose logging)
python bbdrop.py --gui --debug

Keyboard Shortcuts

Shortcut	Action
Ctrl+O	Add folders to queue
Ctrl+N	New tab
Ctrl+W	Close tab
Ctrl+T	New tab
Ctrl+.	Show keyboard shortcuts
F1	Help
Del	Remove selected galleries
Ctrl+A	Select all
Ctrl+Shift+A	Deselect all
Ctrl+C	Copy BBCode output
Ctrl+S	Save settings
Escape	Cancel current operation

Gallery States

State	Icon	Description
Validating	…	Checking folder contents
Scanning	…	Counting images and calculating size
Ready	Green	Scanned and ready to upload
Queued	Blue	Waiting in upload queue
Uploading	Arrow	Currently uploading
Completed	Check	Upload finished successfully
Failed	Red X	Upload failed (check logs)
Paused	Pause	Upload paused by user
Incomplete	Yellow	Partially uploaded

Configuration Files

File	Purpose
`~/.bbdrop/bbdrop.ini`	User settings and preferences
`~/.bbdrop/bbdrop.db`	Queue database (SQLite)
`~/.bbdrop/templates/`	Custom BBCode templates
`~/.bbdrop/logs/`	Application logs

Note: On Windows, ~ refers to %USERPROFILE% (e.g., C:\Users\YourName).

Common CLI Options

--gui              # Launch GUI mode
--name "Name"      # Set gallery name
--thumb-size N     # Thumbnail size (1-6)
--content-type N   # Content type (0=SFW, 1=NSFW)
--debug            # Enable debug logging
--help             # Show all options
--version          # Show version number

CLI Examples

# Upload a folder with custom name
python bbdrop.py "C:\Photos\Vacation" --name "Summer Vacation 2024"

# Upload with specific thumbnail size
python bbdrop.py /path/to/folder --thumb-size 3

# Upload NSFW content
python bbdrop.py /path/to/folder --content-type 1

File Host Support

Premium File Hosts

Host	Auth Type	Status
Fileboom	API Key	Supported
Filedot	Session	Supported
Filespace	Session	Supported
Katfile	API Key	Supported
Keep2Share	API Key	Supported
Rapidgator	Token Login	Supported
Tezfiles	API Key	Supported

Additional Hosts

44+ additional hosts available via the external hooks system.

Supported Image Formats

Standard: JPG, JPEG, PNG, GIF
Additional: BMP, WEBP, TIFF (converted on upload)

Supported Archive Formats

Format	Extension
ZIP	.zip
RAR	.rar
7-Zip	.7z
TAR	.tar
Gzipped TAR	.tar.gz, .tgz
Bzipped TAR	.tar.bz2

Archives are automatically extracted before upload.

BBCode Template Placeholders

Placeholder	Description
`#folderName#`	Gallery display name
`#galleryLink#`	Image host gallery URL
`#pictureCount#`	Number of uploaded images
`#folderSize#`	Total size (formatted)
`#width#`	Average image width
`#height#`	Average image height
`#allImages#`	All image BBCode
`#hostLinks#`	File host download links
`#custom1#`-`#custom4#`	User-defined fields
`#ext1#`-`#ext4#`	External app outputs

See BBCode Templates for conditional logic and full details.

Quick Tips

Drag and Drop: Drag folders directly onto the queue table to add them.
Batch Selection: Use Shift+Click to select a range of galleries.
Right-Click Menu: Access gallery actions via context menu.
System Tray: Minimize to tray for background uploads.
Tab Colors: Assign colors to tabs for visual organization.

Troubleshooting Quick Fixes

Problem	Solution
Upload stuck	Check internet connection, try pause/resume
Login failed	Verify credentials in Settings
Gallery not appearing	Ensure folder contains supported images
Slow uploads	Reduce concurrent uploads in Settings
Database locked	Close other BBDrop instances

Getting Help

F1 Key: Opens built-in help
Ctrl+.: Shows all keyboard shortcuts
Logs: Check ~/.bbdrop/logs/ for detailed error messages
Debug Mode: Run with --debug for verbose output

Version Information

Check your version: python bbdrop.py --version

Current version information and changelog available in the application Help menu.

This site is open source. Improve this page.