pocket-casts

Download YouTube videos and upload them to Pocket Casts Files for offline viewing. For personal use with content you own or have rights to.

⭐2stars🔀0forks📁View on GitHub🕐Updated Jan 8, 2026

When & Why to Use This Skill

This Claude skill automates the end-to-end process of downloading YouTube videos and uploading them directly to the Pocket Casts Files library. By integrating powerful tools like yt-dlp with the Pocket Casts API, it enables users to bridge the gap between video platforms and podcast management apps, facilitating seamless offline viewing and personalized content curation.

Use Cases

  • Offline Commuting: Download educational YouTube videos or long-form interviews and sync them to Pocket Casts for viewing during flights or commutes without data usage.
  • Personal Learning Library: Convert YouTube-based tutorials and lectures into a mobile-friendly podcast format, allowing for organized, on-the-go learning within a dedicated media player.
  • Content Archiving: Efficiently move Creative Commons content or personal video recordings into a centralized cloud-based library for cross-device access on iOS, Android, and Web.
namepocket-casts
descriptionDownload YouTube videos and upload them to Pocket Casts Files for offline viewing. For personal use with content you own or have rights to.
version1.0.0
authoremmanuelem

Pocket Casts YouTube Uploader

Download YouTube videos and upload them to Pocket Casts Files for offline viewing.

Usage

~/skills/pocket-casts/scripts/upload.sh "YOUTUBE_URL"

Or with a custom title:

~/skills/pocket-casts/scripts/upload.sh "YOUTUBE_URL" "Custom Title"

Prerequisites

Required

  • yt-dlp - YouTube downloader (via uv: uvx yt-dlp)
  • ffmpeg - Video processing (apt install ffmpeg)
  • curl - HTTP requests (usually pre-installed)
  • jq - JSON parsing (apt install jq)
  • deno - JavaScript runtime for yt-dlp challenges:
    curl -fsSL https://deno.land/install.sh | sh
    
    Add to PATH: export PATH="$HOME/.deno/bin:$PATH"

Setup

  1. Create credentials directory:

    mkdir -p ~/.clawdbot/credentials/pocket-casts
    chmod 700 ~/.clawdbot/credentials/pocket-casts
    
  2. Add Pocket Casts refresh token:

    Get your refresh token from browser dev tools while logged into pocketcasts.com, then:

    cat > ~/.clawdbot/credentials/pocket-casts/config.json << 'EOF'
    {
      "refreshToken": "YOUR_REFRESH_TOKEN_HERE"
    }
    EOF
    chmod 600 ~/.clawdbot/credentials/pocket-casts/config.json
    

    The refresh token lasts ~1 year. Access tokens are fetched automatically.

  3. Add YouTube cookies (required for most videos):

    YouTube's bot detection requires cookies from a logged-in browser session.

    • Install "Get cookies.txt LOCALLY" browser extension (or similar)
    • Go to youtube.com while logged in
    • Export cookies via the extension
    • Save to ~/.clawdbot/credentials/pocket-casts/cookies.txt
    chmod 600 ~/.clawdbot/credentials/pocket-casts/cookies.txt
    

How It Works

  1. Downloads video via yt-dlp --remux-video mp4
  2. Refreshes Pocket Casts access token using stored refresh token
  3. Requests presigned upload URL from Pocket Casts API
  4. PUTs file to S3 via presigned URL
  5. Deletes local video file

Environment Variables

  • CLAWDBOT_CREDENTIALS - Override credentials directory (default: ~/.clawdbot/credentials)

Notes

  • Files appear in the Pocket Casts "Files" tab
  • Videos play natively in the app (iOS/Android/Web)
  • Max file size depends on your Pocket Casts subscription (~2GB for Plus)
  • Cookies may need refreshing if YouTube blocks requests

This skill is provided for personal, fair-use purposes only.

  • YouTube Terms of Service prohibit downloading videos except via official means. Downloading may violate YouTube's ToS depending on your jurisdiction and intended use.
  • Pocket Casts Terms require that you own or have the rights to any media you upload to your Files library.
  • Copyright law varies by country. Downloading and storing copyrighted content without permission may be illegal in your jurisdiction.

By using this skill, you accept full responsibility for ensuring your use complies with all applicable terms of service and laws. The authors disclaim any liability for misuse.

Recommended uses: Personal recordings, Creative Commons content, videos you created, or content where the creator has explicitly permitted downloading.