Audio Capture

Complete technical documentation for FlowPick audio detection and download, covering audio formats, podcast detection, metadata extraction, batch download, and troubleshooting.

FlowPick automatically detects audio content on webpages, supporting common streaming formats (HLS/DASH) and direct audio files. Audio resources are displayed in a dedicated tab in the popup window for easy filtering and download.


Detection Principles

Audio detection uses the same webRequest API as video detection:

  1. Request Monitoring: Extension intercepts all network requests, identifies audio resources based on Content-Type
  2. Manifest Parsing: For HLS/DASH streams, parses manifest to extract audio track info
  3. Metadata Extraction: Extracts basic metadata from response headers (file size, format, etc.)
  4. Resource Display: Detected audios are listed under the dedicated "Audio" tab

Detection Timing:

  • After extension installation, need to refresh target page before detection can begin
  • Audio usually loads when user clicks play; recommend playing for a few seconds before opening extension
  • Some websites use lazy loading; need to trigger playback before audio can be detected

Supported Audio Formats

Streaming Protocols

ProtocolManifest FileContent-TypeDescription
HLS.m3u8application/x-mpegurlHLS audio stream
DASH.mpdapplication/dash+xmlDASH audio stream

Direct Audio Files

Content-TypeExtensionDescription
audio/mpeg.mp3Most universal audio format
audio/mp4.m4aAAC container
audio/webm.webaWebM audio
audio/ogg.oggOgg Vorbis
audio/wav.wavUncompressed WAV
audio/flac.flacLossless FLAC
audio/aac.aacPure AAC
audio/x-m4a.m4aiTunes audio

Podcast Detection

Podcast platforms typically use standard audio formats (MP3/AAC), making them easy to detect with FlowPick.

Podcast Platform Support

PlatformFormatNotes
Apple PodcastsMP3/M4AStandard RSS feed
SpotifyEncryptedMay not be directly detectable
Google PodcastsMP3Standard format
Independent PodcastsMP3/AACUsually direct links
YouTube MusicDASH/HLSVideo+audio separated
For detailed podcast download workflow, see Use Cases — Podcast & Audio.

Batch Download of Podcast Episodes

Podcast list pages often contain multiple episodes that can be downloaded in batches:

  1. Open podcast list page
  2. Play each episode briefly to trigger audio loading (some sites auto-load)
  3. Open FlowPick, switch to Audio tab
  4. Select needed episodes using checkboxes
  5. Click "Download Selected" button
Some podcast platforms use dynamic URLs or encrypted streams, which may not be detectable by FlowPick. In this case, you can try using online tools or other methods.

Metadata Extraction

When detecting audio files, FlowPick extracts available metadata:

MetadataSourceExample
File SizeContent-Length header12.5 MB
MIME TypeContent-Type headeraudio/mpeg
File NameURL path inferenceepisode-001.mp3
Source DomainRequest URLcdn.example.com

Limitations:

  • Cannot extract ID3 tags (artist, album, duration) without downloading file
  • Cannot get actual audio duration without parsing entire file
  • Some servers don't return Content-Length header

Download Behavior

Direct Audio Files

For direct audio files (MP3, M4A, etc.):

  • Browser downloads original file directly
  • No conversion or processing needed
  • File saved to default download directory

Streaming Audio

For HLS/DASH audio streams:

  1. Parse manifest to get fragment list
  2. Concurrently download all fragments
  3. Merge fragments into single file
  4. If output format is MP4/M4A, perform remuxing

Use Cases

Background Music Download

Many websites use background music (BGM):

  • Game websites' background music
  • Personal homepage's ambient music
  • Product demo pages' background music
  • Interactive media's sound effects

These audios are usually loaded when page opens, can be detected immediately after refreshing page.

Podcast Episode Collection

Collect favorite podcast episodes locally:

  1. Open episode page
  2. Play briefly to trigger audio load
  3. Detect and download in FlowPick
For complete podcast download guide, see Use Cases — Podcast & Audio.

Audiobook Download

Audiobook platforms usually provide audio files:

  • Usually standard MP3/M4A format
  • Sometimes split into chapters
  • Can be downloaded chapter-by-chapter

Live Stream Recording

Some live platforms provide recorded replay:

  • Replays usually stored as standard audio files
  • Can be detected and downloaded like regular audio files
  • Some platforms use special protection

Best Practices

Filter Unwanted Resources

Audio detection may pick up some unwanted resources:

Resource TypeHow to Handle
Notification soundsFilter by file size (usually very small)
Ad audioManually exclude or filter by domain
UI sound effectsFilter by file size
Background musicDecide whether to download based on needs

Combine with Video Download

Some content has both video and audio versions:

  • Podcasts sometimes have video versions
  • Some courses provide separate video and audio tracks
  • Choose appropriate type based on needs

File Naming

Downloaded audio files are named based on URL. If you want better naming:

  • Manually rename after download
  • Use file manager to batch rename
  • Some download managers support custom naming rules

Troubleshooting

Audio Not Detected

CauseSolution
Page not refreshedRefresh page and wait for audio to load
Audio not playedClick play button, play for a few seconds
Uses Web Audio APISome sites use programmatic audio generation, not network requests
Encrypted streamDRM-protected audio cannot be detected

Downloaded File Cannot Play

CauseSolution
Incomplete downloadRe-download, ensure network stable
Unsupported formatTry converting with FFmpeg or other tools
Corrupted fileOriginal file may have issues

File Size Shows as Unknown

Some servers don't return Content-Length header:

  • This is normal, doesn't affect download
  • Actual size only known after download completes
  • Streaming audio especially prone to this situation
If above methods don't resolve issue, please check Common Issues Troubleshooting. For technical limitations, see Known Limitations.