Image Download

Complete technical documentation for FlowPick image detection and download, covering supported formats, smart filtering, batch download, gallery scenarios, and best practices.

FlowPick automatically detects images on webpages and provides intelligent filtering and batch download capabilities. Images are displayed in a dedicated tab with preview thumbnails for easy selection.


Detection Principles

Image detection uses the same webRequest API as video/audio detection:

  1. Request Monitoring: Extension intercepts all network requests, identifies image resources based on Content-Type
  2. Metadata Extraction: Extracts file size, dimensions (if available), format info
  3. Thumbnail Generation: Generates preview thumbnail in popup window
  4. Resource Display: Detected images are listed under dedicated "Images" tab

Detection Timing:

  • After extension installation, need to refresh target page before detection can begin
  • Images usually load when page opens; most can be detected immediately
  • Lazy-loaded images (e.g., loading when scrolling) need to trigger loading first

Supported Image Formats

Content-TypeExtensionDescription
image/jpeg.jpg, .jpegMost common format, photos
image/png.pngLossless compression, supports transparency
image/gif.gifAnimated images
image/webp.webpNext-gen format, better compression
image/svg+xml.svgVector graphics
image/bmp.bmpBitmap format
image/ico.icoIcon files
image/tiff.tiffPrint industry standard
image/avif.avifAdvanced format, excellent compression

Smart Filtering

When many images are detected on a page, filtering helps quickly find target resources.

File Size Filtering

Set minimum file size to filter out small icons and decorative images:

Minimum SizeFiltered OutRetained
No limitNothingAll images
10 KBIcons, small decorationsMost content images
50 KBThumbnails, small illustrationsHigh-quality images
100 KB+Only large imagesHD wallpapers, original photos

Use Cases:

  • Gallery websites: Set minimum 50KB to filter out thumbnails
  • Design resource sites: Set minimum 100KB to get only high-res images
  • General browsing: Set minimum 10KB to remove tiny icons

Format Filtering

Select specific formats to download:

ScenarioRecommended Formats
Need transparencyPNG only
Web optimizationWebP only
Universal compatibilityJPG + PNG
Collect animated GIFsGIF only
Vector graphicsSVG only

Dimension Filtering (Planned)

Future versions will support filtering by image dimensions:

  • Filter out small images below certain width/height
  • Only retain images larger than specified size
  • Useful for collecting wallpaper-sized images

Batch Download Operations

Select Multiple Images

In FlowPick popup:

  1. Each detected image has checkbox on left
  2. Check images you want to download
  3. Click "Download Selected" button at top
  4. All selected images join download queue

Select All / Deselect All

  • Click select-all checkbox at top of list to select/deselect all images
  • Combine with type filter (video/audio/image) for category-based selection
  • Combine with size filter to exclude small files then select all

Selection Strategies

Some tips for efficiently selecting target images:

StrategyOperationUse Case
Filter then Select AllSet size/format filter → Select AllDownload only HD images from gallery
Category Select AllSwitch to "Images" tab → Select AllBatch download from image list
Manual SelectionManually check needed resourcesDownload specific images from course materials
Exclusion MethodSelect All → Uncheck unneeded onesMany resources but only need to exclude a few
Filtering is key to batch download efficiency. Set filters before selecting all to avoid downloading lots of useless resources.

Gallery websites are one of the main use cases for image download feature.

Stock Photo Sites

Sites like Unsplash, Pexels, Pixabay:

  1. Open gallery or search results page
  2. Scroll down to load more images (trigger lazy loading)
  3. Open FlowPick, switch to Images tab
  4. Set minimum size filter (e.g., 100KB) to filter thumbnails
  5. Select needed images and download

Tips:

  • Some sites use lazy loading; scroll to bottom of page first
  • Preview images may be low-res; actual downloads are original quality
  • Respect copyright and usage terms

Social Media Images

Instagram, Twitter/X, Pinterest:

  1. Open profile or post page
  2. Let images fully load
  3. Open FlowPick to detect
  4. Select and download needed images

Notes:

  • Some platforms use special protection
  • May need to log in to see full-size images
  • Respect platform terms of service

Design Resource Sites

Dribbble, Behance, etc.:

  1. Open design work detail page
  2. FlowPick detects images in design works
  3. Can filter by size to get high-res versions

E-commerce Product Images

Taobao, JD, Amazon, etc.:

  1. Open product detail page
  2. Product images will be detected
  3. Can batch download product images
For complete gallery batch download guide, see Use Cases — Image Galleries.

Best Practices

Avoid Downloading Useless Resources

Webpages often contain many unnecessary images:

Image TypeRecommendation
Website logo/iconDon't download (usually very small)
UI decorative elementsDon't download unless needed
Advertisement imagesDon't download
Avatar/thumbnailDecide based on needs
Background imagesUsually not needed
Content imagesDownload these

When downloading images, please note:

  • Copyright Protection: Most images are copyrighted
  • Usage Restrictions: Some images prohibit commercial use
  • Attribution Requirements: Some require attribution
  • Platform Terms: Need to comply with platform terms

Recommendations:

  • For personal collection/study: Generally acceptable
  • For commercial use: Ensure proper licensing
  • For redistribution: Need explicit permission
  • Always check image's license information

File Management

Batch-downloaded images all go to browser default download folder:

  1. Plan ahead: Clean up download folder before downloading, easier to organize later
  2. Use filters: Filter by size/format to exclude unwanted images
  3. Batch operations: When there are many resources, categorize and download in batches

Disk Space Planning

Estimate space needed before downloading:

Image TypeTypical Single SizeEstimated 10Estimated 50
Thumbnail10-50 KB0.1-0.5 MB0.25-2.5 MB
Regular web image50-500 KB0.5-5 MB2.5-25 MB
HD photo1-5 MB10-50 MB50-250 MB
Original quality photo5-20 MB50-200 MB250 MB-1 GB

Troubleshooting

Images Not Detected

CauseSolution
Page not refreshedRefresh page and wait for images to load
Uses lazy loadingScroll page to trigger image loading
Uses CSS backgroundBackground images may not be detectable
Canvas-drawn imagesProgrammatic rendering cannot be detected
Base64 encodedInline data URIs won't appear as network requests

Downloaded Image Is Low Quality

Some sites provide different quality versions:

  • Thumbnail vs original: Detection may pick up thumbnail
  • CDN multi-version: URL parameters control quality
  • Lazy loading: May load low-res version first

Solutions:

  • Try opening image in new tab to get full-quality version
  • Modify URL parameters to request higher quality
  • Some sites need to click "View Original" first

Cannot Find Wanted Image

CauseSolution
Image uses special loading methodNot all loading methods supported
Image dynamically generatedMay be rendered via JavaScript/CSS
Image behind login wallNeed to ensure logged in
Image loaded via WebSocketCurrently unsupported
If above methods don't resolve issue, please check Common Issues Troubleshooting. For technical limitations, see Known Limitations.