YouTube Audio Download

Quick Start

/mk-youtube-get-audio <URL> [output_dir] [browser] [--force]

Parameters

Examples

• /mk-youtube-get-audio https://youtube.com/watch?v=xxx

  - Download with auto cookie fallback

• /mk-youtube-get-audio https://youtube.com/watch?v=xxx ~/Music

  - Save to custom directory

• /mk-youtube-get-audio https://youtube.com/watch?v=xxx /tmp chrome

  - Use Chrome cookies

How it Works

1. Execute:

   {baseDir}/scripts/audio.sh "<URL>" "<output_dir>" "<browser>"

2. First attempt: download without authentication
3. If failed: retry with browser cookies (auto-detect or specified)
4. Parse JSON output to get file path

┌─────────────────────────────┐
│   First attempt (no auth)   │
└──────────────┬──────────────┘
               │
       ┌───────┴───────┐
       │               │
    Success         Failed
       │               │
       ▼               ▼
   [Return]    ┌─────────────────────┐
               │ Retry with cookies  │
               │ chrome → firefox →  │
               │ safari → edge →     │
               │ brave               │
               └──────────┬──────────┘
                          │
                  ┌───────┴───────┐
                  │               │
               Success         Failed
                  │               │
                  ▼               ▼
              [Return]        [Error]

Output Format

{
  "status": "success",
  "file_path": "/tmp/monkey_knowledge/youtube/audio/20091025__VIDEO_ID.m4a",
  "file_size": "5.2M",
  "cached": false,
  "video_id": "dQw4w9WgXcQ",
  "title": "Video Title",
  "channel": "Channel Name",
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "duration_string": "3:32"
}

{
  "status": "success",
  "file_path": "/tmp/monkey_knowledge/youtube/audio/20091025__VIDEO_ID.m4a",
  "file_size": "5.2M",
  "cached": true,
  ...
}

{
  "status": "error",
  "message": "Download failed (tried with and without cookies)"
}

Filename Format

{YYYYMMDD}__{video_id}.{ext}

20091025__dQw4w9WgXcQ.m4a

Browser Cookie Fallback

1. Tries each browser: chrome → firefox → safari → edge → brave
2. For Chrome: tries all profiles (Default, Profile 1, Profile 2, ...)
3. Uses first successful browser/profile combination

chrome

firefox

safari

edge

brave

Use Cases

• Download audio for speech-to-text when video has no subtitles
• Podcast or music download
• Member-only or age-restricted content (with browser cookies)

Notes

• File caching: If audio file already exists for this video, it will be reused (returns

  cached: true

  )
• Force refresh: Use

  --force

  flag to re-download even if cached file exists
• Uses system yt-dlp/jq if available, otherwise auto-downloads on first run
• No ffmpeg required (uses best available format without conversion)
• Output format depends on source (typically m4a, webm, or opus)
• Cookie fallback only activates when initial download fails
• Using cookies may risk YouTube account suspension - use secondary account if needed

Next Step

/mk-youtube-audio-transcribe

file_path

/mk-youtube-audio-transcribe <file_path> [model] [language]

/mk-youtube-get-info

zh

ja