Skip to content

Image Scanning & Link Checking

BBDrop has two scanning features: pre-upload image scanning (validates images before upload) and the link scanner (checks if uploaded galleries are still online).

Image Scanning

When you add a gallery to the queue, BBDrop automatically scans the images to validate them and calculate dimensions. This data feeds into template placeholders like #width#, #height#, and #pictureCount#.

How It Works

  1. Images are checked for corruption using fast detection (imghdr library with PIL fallback)
  2. A sample of images is opened to calculate average dimensions
  3. Corrupt or invalid files are excluded from the upload

Settings

Configure scanning behavior in Settings > Image Scan:

Corruption checking:

  • Use fast corruption checking — Enabled by default. Uses imghdr for quick validation, falling back to PIL for uncertain files.

Dimension sampling — Instead of opening every image (slow for large galleries), BBDrop samples a subset:

  • Fixed count — Sample a set number of images (default: 25)
  • Percentage — Sample a percentage of all images (default: 10%)

Exclusions — Skip certain images from the dimension sample:

  • Skip first image — Often a cover or poster
  • Skip last image — Often credits or a logo
  • Skip images smaller than X% — Exclude images below a size threshold relative to the largest image (filters out thumbnails and previews)
  • Skip filename patterns — Comma-separated wildcards (e.g., cover*, thumb*, poster*)

Statistics:

  • Exclude outliers — Remove images outside 1.5x the interquartile range
  • Average method — Mean (arithmetic average) or Median (default, more robust to outliers)

The link scanner checks whether your uploaded galleries and images are still accessible online.

Opening the Scanner

Click the Link Scan button in the quick settings panel to open the Link Scanner Dashboard.

Status Overview

The dashboard shows counts for:

  • Online — All images accessible
  • Offline — No images accessible
  • Partial — Some images missing
  • Never checked — Not yet scanned

Running a Scan

Choose a scan scope based on when galleries were last checked:

  • Scan 7+ Days — Galleries not checked in the last 7 days
  • Scan 14+ Days, 30+ Days, 60+ Days, 90+ Days, 1+ Year
  • Scan All — Every completed gallery

Quick actions:

  • Rescan Offline/Partial — Re-check only galleries currently marked as offline or partial
  • Scan Never Checked — First-time check for unchecked galleries

Results

After scanning, the gallery table's online column shows the status. You can also check individual galleries by right-clicking and selecting Check Online Status.

Scan statistics (total scans, galleries checked, online/offline counts) are available in Tools > Statistics.

Note

The link scanner currently supports IMX.to galleries. Scanning runs in the background — you can close the dashboard and results will still be saved.

Cover Photos

BBDrop can automatically detect cover images in your galleries and handle them separately — different thumbnail size, different upload host, or exclusion from the main gallery.

Enable cover detection in Settings > Covers.

Detection Methods

Three detection methods are available (can be combined):

  • By filename — glob patterns like cover*, poster*, *_cover.* (case-insensitive, comma-separated)
  • By dimensions — images whose area differs significantly from the gallery average (configurable threshold)
  • By file size — images within a specific KB range

Cover Upload Options

  • Upload host — which image host receives the cover (can differ from the gallery's host)
  • Thumbnail format — per-host thumbnail settings for covers
  • Max covers per gallery — limit how many covers are detected
  • Skip duplicates — don't upload a cover if it's identical to a gallery image

Hooks Integration

Cover data is available in hooks via %cv (cover source path) and %cu (cover URL after upload).