download_audio

Download audio from video URLs at maximum speed. Downloads audio ONLY — never video.

Supports YouTube, Vimeo, TikTok, Twitter, SoundCloud, and 1000+ sites.

Speed Optimizations

aria2c multi-connection downloads (16 parallel connections)
Concurrent fragment downloading (4 fragments)
No video download — audio extraction only
No format conversion — native audio format

Example

Request:


{
  "url": "https://youtube.com/watch?v=xxx",
  "output_dir": "~/Downloads"
}

Response:


{
  "success": true,
  "url": "https://youtube.com/watch?v=xxx",
  "output_dir": "/Users/you/Downloads",
  "file": {
    "path": "/Users/you/Downloads/Video Title.webm",
    "filename": "Video Title.webm",
    "size_mb": 14.49
  },
  "aria2c_used": true,
  "message": "Audio downloaded to /Users/you/Downloads/Video Title.webm"
}

Notes

The downloaded file path is ready to pass directly to transcribe_audio or search_audio.

Requires yt-dlp installed. Install with: brew install yt-dlp

For best speed, also install aria2: brew install aria2