Usage Guide

Complete usage guide for FlowPick, covering both extension and online tool methods, from basic detection to advanced download strategies.

FlowPick provides two usage methods: Browser Extension and Online Tool. This document covers the complete workflow for both.


Quick Start (30 Seconds)

  1. Open any webpage containing video (e.g., Bilibili) and play for a few seconds
  2. Click the FlowPick icon in the browser toolbar
  3. Click the download button next to the resource you want to download in the popup
  4. Wait for the download to complete
Don't want to install an extension? Open M3U8 Downloader or DASH Downloader directly, paste the stream URL, and start downloading.

Extension Usage

Detecting Media

FlowPick detects media resources on pages by monitoring browser network requests. Detection results are automatically categorized by type:

TabContents
Media StreamsVideo streams (M3U8, MPD, etc.)
VideoMP4, MOV, FLV, WMV and other video files
AudioMP3, AAC, M4A, OGG and other audio files
ImageJPG, PNG, WebP, SVG and other image files

Detection Tips:

  • Play video/audio for a few seconds first to ensure media requests have been sent
  • If nothing is detected, refresh the page and play again
  • Some websites use dynamic loading; drag the progress bar to trigger more fragment requests
  • Encrypted HLS streams (with EXT-X-KEY tags) can also be detected—FlowPick will auto-decrypt them
For HLS/DASH stream detection principles and encryption handling mechanisms, see Video Sniffing. For troubleshooting when media is not detected, see Common Issues Troubleshooting — Media Detection Issues.

Previewing Media

Preview content before downloading to confirm it's the resource you want to save:

  • Click the Play icon → Built-in player preview for video/audio
  • Click the Eye icon → Preview images
  • Preview supports real-time playback of HLS and DASH streams

Downloading a Single Resource

  1. Find the target file in the resource list
  2. Click the Download icon on the right
  3. For regular files (MP4, MP3, etc.), the browser downloads directly
  4. For streams (M3U8, MPD), FlowPick automatically downloads all fragments and merges them into a single file

Batch Download

  1. Check the checkboxes to the left of multiple resources
  2. Click the Download Selected button at the top
  3. All selected resources will be added to the download queue in sequence
  4. View progress for each task in the download management panel
For batch download queue management, concurrency control, and state transitions, see Batch Download.

Filtering Resources

When there are many resources on a page, use filters to quickly locate targets:

FilterDescriptionExample
By TypeShow only video, audio, or imagesView only videos
By File SizeSet minimum/maximum file size rangeExclude thumbnails smaller than 100KB
By DurationFilter by video/audio durationView only videos longer than 1 minute
By FormatFilter by file extensionView only .mp4 files

Quality Selection

For adaptive streams (HLS/DASH), FlowPick lists all available qualities:

QualityResolutionUse Case
Low360pAudio only, mobile networks
Standard480pSmall screen devices
HD720pLaptop viewing
Full HD1080pLarge screen viewing
OriginalHighest availableBest quality needed

After selecting quality, FlowPick downloads only fragments of the corresponding resolution, saving time and storage space.


Online Tool Usage

Online tools require no extension installation, suitable for temporary use or scenarios where extensions cannot be installed.

M3U8 Downloader

For HLS streams (.m3u8 URLs):

  1. Open M3U8 Downloader
  2. Paste the M3U8 URL in the input box
  3. Click the Parse button—the tool will analyze stream information
  4. Select quality and output format
  5. Click Start Download

How to Get M3U8 URL:

  • Open browser Developer Tools (F12) → Network tab → Filter m3u8
  • After playing the video, find .m3u8 files in the request list
  • Right-click and copy the link address

DASH Downloader

For DASH streams (.mpd URLs):

  1. Open DASH Downloader
  2. Paste the MPD URL in the input box
  3. Click the Parse button
  4. Select video and audio tracks separately
  5. Click Start Download—the tool will auto-merge audio and video
Online tools are subject to browser same-origin policy restrictions. If the streaming server has not configured CORS headers, direct download may not be possible. In such cases, we recommend using the browser extension. For detailed feature comparison between extension and online tools, see Online Tools — Comparison with Extension.

Download Management

Download Queue

All download tasks are managed in a unified queue:

  • Concurrency Control: Number of simultaneous download tasks is limited by the concurrent thread count in settings
  • Queue Ordering: Tasks added earlier execute first
  • Pause/Resume: Can pause individual tasks or all tasks
  • Cancel: Cancelled tasks clean up downloaded temporary files
For the FIFO model of download queues and state management mechanisms, see Batch Download — Queue Management.

Progress Monitoring

Each download task displays real-time progress information:

InformationDescription
Progress PercentageDownloaded fragments / Total fragments
Download SpeedCurrent real-time speed (KB/s or MB/s)
Downloaded SizeCompleted file size
Remaining TimeEstimated remaining time based on current speed
Fragment StatusDownload status of each fragment (waiting/downloading/completed/failed)

Download Completion

After download completes:

  • Browser shows a download completion notification (can be disabled in settings)
  • File is saved in the browser's default download directory or your specified directory
  • For streams, the merged file is saved in your chosen format (MP4/TS)

Format Conversion

FlowPick includes built-in format conversion based on FFmpeg WASM, completed in the browser without uploading files.

Supported Conversions

Source FormatTarget FormatDescription
TSMP4Remuxing, fastest speed, no re-encoding
M3U8 FragmentsMP4Auto-merge after download and remux
MPD FragmentsMP4Auto-merge after download and remux
TS to MP4 is remuxing, not transcoding—it only changes the container format without re-encoding audio/video, so it's fast with no quality loss. See Format Conversion for details.

Settings

Click the gear icon in the popup to access settings. Common settings:

SettingDefaultDescription
Concurrent Threads2Number of fragments downloaded simultaneously
Output FormatMP4Output format after stream merging
Auto DetectionOffAuto-detect media when page loads
Minimum File Size0Ignore files smaller than this size
Download NotificationOnShow notification when download completes
For complete configuration item descriptions and recommended values, refer to Configuration Reference.

Keyboard Shortcuts

ShortcutAction
Alt+Shift+FOpen FlowPick popup
Alt+Shift+DDownload all detected media

You can customize shortcuts in the browser's extensions management page (chrome://extensions): Click the menu in the upper left → Keyboard Shortcuts → Find FlowPick and modify.

For the complete list of shortcuts, customization methods, and scope descriptions, see Keyboard Shortcuts.

Usage Tips

Video Sites

  • Wait 3-5 seconds for video to start playing before opening FlowPick
  • If not detected, drag the progress bar to different positions to trigger more fragment requests
  • Encrypted videos (such as some paid courses) require the extension's webRequest permission to obtain keys
  • Higher quality streams have more fragments and take longer to merge
For AES-128 decryption principles for encrypted streams, see Video Sniffing — Encryption Detection. For limitations with DRM-protected content, see Known Limitations — DRM Protected Content.

Audio/Podcasts

  • Play audio first to trigger network requests
  • Podcasts usually have multiple audio formats available—prioritize AAC or MP3
  • Downloaded audio files retain original metadata (ID3 tags)
For complete audio capture feature documentation, see Audio Capture.

Images

  • Use size filtering to exclude icons and thumbnails (recommend minimum 50KB)
  • Batch download works well for gallery sites
  • Supports modern image formats like WebP, AVIF
For complete image download feature documentation, see Image Download.

Large File Downloads

FlowPick's browser extension fully supports large file downloads, automatically selecting the optimal approach through smart write strategies, easily handling GB-level streaming media files.

Core Capabilities:

  • No File Size Limit: Streaming writes via File System Access API, theoretically supports files of any size
  • Constant Memory Footprint: In streaming write mode, memory usage is unaffected by file size—won't cause browser crashes due to large files
  • Smart Strategy Fallback: Automatically detects browser capabilities and switches between FSA → StreamSaver → Blob write strategies

Recommended Browsers:

BrowserMinimum VersionLarge File SupportRecommendation
Chrome86+FSA streaming write, no size limitHighly Recommended
Edge86+FSA streaming write, no size limitHighly Recommended
Firefox111+StreamSaver streaming writeRecommended
Safari15+Blob mode, memory limitedUsable
For the best large file download experience, we strongly recommend using the latest version of Chrome or Edge browsers. These browsers fully support File System Access API, enabling streaming writes with constant memory footprint—even downloading 10GB+ files won't cause browser lag or crashes.

Precautions During Download:

  • Do not close the tab during download, otherwise it will be interrupted
  • Keep screen on to avoid system sleep interrupting network connection
  • For very large files (>5GB), use wired network for more stable download speed
  • Ensure sufficient remaining disk space
For detailed comparison of three-tier write strategies and fallback logic, see Download Engine Architecture — Strategy Comparison Summary. For API support details across browsers, see Browser Compatibility.
More scenario-based usage guides are available in the Use Cases documentation series, covering online courses, live replays, podcast audio, gallery downloads, and other specific scenarios.