Skip to content

Instantly share code, notes, and snippets.

@devinschumacher

devinschumacher/patreon.md

Created December 1, 2025 03:06
Show Gist options

  • Select an option

    Learn more about clone URLs
  • Save devinschumacher/14061551eb17cc8932b6802cfc0ca178 to your computer and use it in GitHub Desktop.

Select an option

Learn more about clone URLs
Save devinschumacher/14061551eb17cc8932b6802cfc0ca178 to your computer and use it in GitHub Desktop.
Download ZIP
How to Download Patreon Videos
Raw
patreon.md

Patreon Video Download Research: Technical Analysis of Stream Patterns, CDNs, and Download Methods

A comprehensive research document analyzing Patreon's video infrastructure, embed patterns, stream formats, and optimal download strategies using modern tools

Authors: SERP Apps
Date: December 2024
Version: 1.0

Abstract

This research document provides a comprehensive analysis of Patreon's video streaming infrastructure, including native video hosting, third-party embeds, content delivery networks (CDNs), stream formats, and optimal download methodologies. We examine the technical architecture behind Patreon's video delivery system and provide practical implementation guidance using industry-standard tools like yt-dlp, ffmpeg, patreon-dl, gallery-dl, and alternative solutions for reliable video extraction and download.

Table of Contents

  1. Introduction
  2. Patreon Video Infrastructure Overview
  3. Embed URL Patterns and Detection
  4. Stream Formats and CDN Analysis
  5. yt-dlp Implementation Strategies
  6. FFmpeg Processing Techniques
  7. Patreon-dl Tool Implementation
  8. Alternative Tools and Backup Methods
  9. Implementation Recommendations
  10. Troubleshooting and Edge Cases
  11. Conclusion

1. Introduction

Patreon has evolved from a simple patronage platform to a comprehensive content delivery system with native video hosting, livestreaming capabilities, and sophisticated third-party video embedding. This research examines the technical infrastructure behind Patreon's video delivery system, with particular focus on developing robust download strategies for archival, offline viewing, and content preservation.

1.1 Research Scope

This document covers:

  • Technical analysis of Patreon's video streaming architecture
  • Comprehensive URL pattern recognition for embedded and native videos
  • Stream format analysis across different quality levels
  • Practical implementation using open-source tools
  • Backup strategies for edge cases and failures

1.2 Methodology

Our research methodology includes:

  • Network traffic analysis of Patreon video playback
  • Reverse engineering of embed mechanisms
  • Testing with various quality settings and formats
  • Validation across multiple CDN endpoints
  • Analysis of both native Patreon videos and third-party embeds

2. Patreon Video Infrastructure Overview

2.1 Video Hosting Types

Patreon supports multiple video hosting mechanisms:

2.1.1 Native Patreon Video

  • Videos uploaded directly to Patreon's servers
  • Hosted on Patreon's CDN infrastructure
  • Protected by session-based authentication
  • Supports up to 5GB per file
  • Formats: MP4, MOV, MPEG, OGG

2.1.2 Third-Party Embedded Videos

  • YouTube embeds via iframe
  • Vimeo embeds via iframe
  • Other providers through Embed.ly integration

2.1.3 Direct File Attachments

  • Downloadable video files attached to posts
  • Direct download links for patrons

2.2 CDN Architecture

Patreon utilizes a multi-tier CDN strategy:

Primary CDN: Amazon CloudFront

  • Primary Domain: cdn.patreon.com
  • Backup Domains: Various CloudFront distributions (*.cloudfront.net)
  • Geographic Distribution: Global edge locations with regional optimization

For Vimeo Embeds:

  • Primary Domain: vod-adaptive.akamaized.net
  • Alternative: vod-progressive.akamaized.net
  • Vimeo CDN: *.vimeocdn.com

For YouTube Embeds:

  • Primary Domain: *.googlevideo.com
  • Alternative: *.youtube.com

2.3 Video Processing Pipeline

Patreon's native video processing follows this pipeline:

  1. Upload: Original video uploaded to Patreon servers
  2. Transcoding: Multiple formats and quality levels generated
  3. Quality Levels: Auto-generated 480p, 720p, 1080p variants
  4. CDN Distribution: Files distributed across CloudFront network
  5. Adaptive Streaming: HLS manifests created for dynamic quality

2.4 Security and Access Control

  • Session-based Authentication: Requires valid patron session cookies
  • Token-based URLs: Time-limited signed URLs for CDN access
  • Membership Gating: Content restricted to appropriate tier patrons
  • Rate Limiting: Per-session download limitations
  • Referrer Checking: Domain-based access restrictions

3. Embed URL Patterns and Detection

3.1 Patreon Post URL Patterns

3.1.1 Standard Post URLs

https://www.patreon.com/posts/{POST_ID}
https://www.patreon.com/posts/{POST_TITLE}-{POST_ID}
https://patreon.com/posts/{POST_ID}

3.1.2 Creator Page URLs

https://www.patreon.com/{CREATOR_NAME}
https://www.patreon.com/c/{CREATOR_NAME}
https://www.patreon.com/user?u={USER_ID}

3.1.3 Direct Media URLs (Native Patreon Video)

https://cdn.patreon.com/video/{UNIQUE_ID}/filename.mp4
https://stream.patreon.com/{PATH}/{FILENAME}.m3u8

3.2 Third-Party Embed Patterns

3.2.1 YouTube Embed URLs

https://www.youtube.com/embed/{VIDEO_ID}
https://www.youtube.com/watch?v={VIDEO_ID}
https://youtu.be/{VIDEO_ID}

3.2.2 Vimeo Embed URLs

https://player.vimeo.com/video/{VIDEO_ID}
https://player.vimeo.com/video/{VIDEO_ID}?h={HASH}
https://vimeo.com/{VIDEO_ID}

3.2.3 Vimeo HLS Stream URLs

https://vod-adaptive.akamaized.net/{VIDEO_ID}/master.m3u8?{AUTH_PARAMS}
https://vod-adaptive-ak.vimeocdn.com/exp={TIMESTAMP}~hmac={HASH}/{VIDEO_ID}/v2/playlist/av/primary/playlist.m3u8

3.3 Video ID and URL Extraction Patterns

3.3.1 Regex Patterns for URL Extraction

Patreon Post ID:

patreon\.com/posts/(?:[^-]+-)?(\d+)
patreon\.com/posts/(\d+)

YouTube Video ID:

(?:youtube\.com/(?:watch\?v=|embed/)|youtu\.be/)([A-Za-z0-9_-]{11})

Vimeo Video ID:

(?:player\.)?vimeo\.com/(?:video/)?(\d+)

General Video URL Pattern:

https?://(?:player\.|www\.)?(youtube\.com|youtu\.be|vimeo\.com)/(?:watch\?v=|video/|embed/|channels/\w+/)?([A-Za-z0-9._%-]+)

3.4 Detection Implementation

Command-line URL Extraction Methods

Extract Patreon post IDs from HTML:

# Extract post IDs from page content
grep -oE "patreon\.com/posts/[^\"'>\s]+" input.html | grep -oE "[0-9]+$"

# Extract from multiple files
find . -name "*.html" -exec grep -oE "patreon\.com/posts/[0-9]+" {} +

Extract embedded video URLs:

# Extract YouTube embed URLs
grep -oE "youtube\.com/embed/[A-Za-z0-9_-]{11}" page.html

# Extract Vimeo embed URLs
grep -oE "player\.vimeo\.com/video/[0-9]+" page.html

# Extract all video-related URLs
grep -oE "https?://[^\"\s]*\.(mp4|m3u8|webm)[^\"\s]*" page.html

Using yt-dlp for detection and metadata extraction:

# Test if URL contains downloadable video
yt-dlp --dump-json "https://www.patreon.com/posts/{POST_ID}" | jq '.id'

# Extract all video information
yt-dlp --dump-json "https://www.patreon.com/posts/{POST_ID}" > video_info.json

# Check available formats
yt-dlp --list-formats "https://www.patreon.com/posts/{POST_ID}"

4. Stream Formats and CDN Analysis

4.1 Native Patreon Video Formats

4.1.1 Supported Upload Formats

  • Container: MP4, MOV, MPEG, OGG
  • Maximum Size: 5GB per file
  • Duration: Varies by tier (limited monthly hours)

4.1.2 Transcoded Output Formats

  • Container: MP4
  • Video Codec: H.264 (AVC)
  • Audio Codec: AAC
  • Quality Levels: 480p, 720p, 1080p (device/bandwidth adaptive)
  • Streaming: HTTP Live Streaming (HLS)

4.2 HLS Stream Structure

4.2.1 Master Playlist (m3u8)

#EXTM3U
#EXT-X-STREAM-INF:BANDWIDTH=800000,RESOLUTION=640x360
https://cdn.patreon.com/.../360p/playlist.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=1600000,RESOLUTION=1280x720
https://cdn.patreon.com/.../720p/playlist.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=3200000,RESOLUTION=1920x1080
https://cdn.patreon.com/.../1080p/playlist.m3u8

4.2.2 Quality-Specific Playlists

#EXTM3U
#EXT-X-VERSION:3
#EXT-X-TARGETDURATION:6
#EXTINF:6.006,
segment001.ts
#EXTINF:6.006,
segment002.ts
...
#EXT-X-ENDLIST

4.3 Vimeo Embed Stream Patterns

4.3.1 VimeoCDN URL Structure

https://vod-adaptive-ak.vimeocdn.com/exp={TIMESTAMP}~hmac={HMAC}/{VIDEO_ID}/v2/playlist/av/primary/playlist.m3u8

Components:

  • exp: Expiration timestamp
  • hmac: Hash-based message authentication code
  • VIDEO_ID: Numeric video identifier
  • Query parameters: qsr, pathsig for additional security

4.3.2 Akamai CDN Patterns

https://vod-adaptive.akamaized.net/{VIDEO_ID}/master.m3u8?{AUTH_PARAMS}
https://vod-progressive.akamaized.net/exp={TIMESTAMP}~acl=%2F{PATH}%2F*~hmac={HASH}/{VIDEO_ID}/{QUALITY}/file.mp4

4.4 Quality Variants Analysis

Quality Resolution Typical Bitrate Use Case
360p 640x360 ~800 kbps Mobile/Low bandwidth
480p 854x480 ~1.2 Mbps Standard definition
720p 1280x720 ~2.5 Mbps HD streaming
1080p 1920x1080 ~4.5 Mbps Full HD

4.5 CDN Endpoint Testing

# Test Patreon CDN availability
curl -I "https://cdn.patreon.com/" 2>&1 | head -5

# Test Vimeo CDN (for embedded videos)
curl -I "https://vod-adaptive.akamaized.net/" 2>&1 | head -5

# Check CDN response headers
curl -I -H "Referer: https://www.patreon.com/" "https://cdn.patreon.com/video/{ID}/file.mp4"

5. yt-dlp Implementation Strategies

5.1 Installation

# Using pip (recommended)
pip install -U yt-dlp

# Using conda
conda install -c conda-forge yt-dlp

# Using Homebrew (macOS)
brew install yt-dlp

# Direct download
curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /usr/local/bin/yt-dlp
chmod a+rx /usr/local/bin/yt-dlp

5.2 Authentication Methods

5.2.1 Cookie-based Authentication (Recommended)

Export cookies from browser:

# Using yt-dlp's built-in browser cookie extraction
yt-dlp --cookies-from-browser chrome "https://www.patreon.com/posts/{POST_ID}"
yt-dlp --cookies-from-browser firefox "https://www.patreon.com/posts/{POST_ID}"

# Using exported cookies file
yt-dlp --cookies patreon_cookies.txt "https://www.patreon.com/posts/{POST_ID}"

Manual cookie extraction process:

  1. Install browser extension "Get cookies.txt LOCALLY"
  2. Navigate to patreon.com while logged in
  3. Export cookies to file patreon_cookies.txt
  4. Use with yt-dlp via --cookies option

5.2.2 Session Cookie Format (Netscape)

# Netscape HTTP Cookie File
.patreon.com	TRUE	/	TRUE	1700000000	session_id	abc123...
.patreon.com	TRUE	/	FALSE	1700000000	patreon_device_id	xyz789...

5.3 Basic Download Commands

5.3.1 Standard Download

# Download best quality
yt-dlp --cookies-from-browser firefox "https://www.patreon.com/posts/{POST_ID}"

# Download specific quality
yt-dlp --cookies-from-browser firefox -f "best[height<=720]" "https://www.patreon.com/posts/{POST_ID}"

# Download with custom filename
yt-dlp --cookies-from-browser firefox -o "%(uploader)s - %(title)s.%(ext)s" "https://www.patreon.com/posts/{POST_ID}"

5.3.2 Format Selection

# List available formats
yt-dlp --cookies-from-browser firefox -F "https://www.patreon.com/posts/{POST_ID}"

# Download specific format by ID
yt-dlp --cookies-from-browser firefox -f 22 "https://www.patreon.com/posts/{POST_ID}"

# Best video + best audio (merge)
yt-dlp --cookies-from-browser firefox -f "bv+ba/best" "https://www.patreon.com/posts/{POST_ID}"

# Best MP4 up to 1080p
yt-dlp --cookies-from-browser firefox -f "best[height<=1080][ext=mp4]" "https://www.patreon.com/posts/{POST_ID}"

5.3.3 Advanced Options

# Download with metadata and thumbnail
yt-dlp --cookies-from-browser firefox \
    --write-description \
    --write-info-json \
    --write-thumbnail \
    --embed-metadata \
    "https://www.patreon.com/posts/{POST_ID}"

# Download with subtitles
yt-dlp --cookies-from-browser firefox \
    --write-subs \
    --sub-langs en \
    "https://www.patreon.com/posts/{POST_ID}"

# Rate limiting and retries
yt-dlp --cookies-from-browser firefox \
    --limit-rate 2M \
    --retries 5 \
    --fragment-retries 5 \
    "https://www.patreon.com/posts/{POST_ID}"

5.4 Batch Processing

5.4.1 From URL File

# Create list of URLs
cat > patreon_urls.txt << EOF
https://www.patreon.com/posts/12345
https://www.patreon.com/posts/67890
https://www.patreon.com/posts/11111
EOF

# Download all
yt-dlp --cookies-from-browser firefox -a patreon_urls.txt

# With archive tracking (skip already downloaded)
yt-dlp --cookies-from-browser firefox \
    --download-archive downloaded.txt \
    -a patreon_urls.txt

5.4.2 Rate-Limited Batch Download

# With delays to avoid rate limiting
yt-dlp --cookies-from-browser firefox \
    --sleep-interval 3 \
    --max-sleep-interval 10 \
    --limit-rate 1M \
    -a patreon_urls.txt

5.5 Configuration File

Create ~/.config/yt-dlp/config:

# Output template
-o "%(uploader)s/%(title)s.%(ext)s"

# Metadata
--write-description
--write-info-json
--write-thumbnail
--embed-metadata

# Quality settings
--format "bv[height<=1080]+ba/best[height<=1080]"

# Network settings
--retries 5
--fragment-retries 5
--rate-limit 2M

# User agent
--user-agent "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36"

5.6 Error Handling

# Continue on errors
yt-dlp --cookies-from-browser firefox \
    --ignore-errors \
    -a patreon_urls.txt

# Verbose output for debugging
yt-dlp --cookies-from-browser firefox \
    --verbose \
    "https://www.patreon.com/posts/{POST_ID}" 2>&1 | tee debug.log

# Check URL accessibility
yt-dlp --cookies-from-browser firefox \
    --list-formats \
    "https://www.patreon.com/posts/{POST_ID}" 2>&1 | grep -i "login\|private\|password"

6. FFmpeg Processing Techniques

6.1 Installation

# Ubuntu/Debian
sudo apt-get install ffmpeg

# macOS
brew install ffmpeg

# Windows (via Chocolatey)
choco install ffmpeg

6.2 Stream Analysis with ffprobe

6.2.1 Basic Stream Information

# Analyze stream details (JSON output)
ffprobe -v quiet -print_format json -show_format -show_streams "input.mp4"

# Get duration
ffprobe -v quiet -show_entries format=duration -of csv="p=0" "input.mp4"

# Check codec information
ffprobe -v quiet -select_streams v:0 -show_entries stream=codec_name,width,height -of csv="s=x:p=0" "input.mp4"

6.2.2 HLS/m3u8 Stream Analysis

# Analyze HLS stream
ffprobe -v quiet -print_format json -show_format -show_streams "https://example.com/playlist.m3u8"

# List available streams in master playlist
ffprobe -v quiet -show_streams "https://example.com/master.m3u8"

# Get detailed stream info
ffprobe -v quiet -print_format json -show_format "https://cdn.patreon.com/.../master.m3u8"

6.3 HLS Stream Download

6.3.1 Basic m3u8 to MP4 Conversion

# Download HLS stream and convert to MP4
ffmpeg -i "https://example.com/playlist.m3u8" -c copy output.mp4

# With protocol whitelist (for security-restricted streams)
ffmpeg -protocol_whitelist file,http,https,tcp,tls,crypto \
    -i "https://example.com/playlist.m3u8" \
    -c copy output.mp4

6.3.2 With Authentication Headers

# Download with custom headers
ffmpeg -headers "User-Agent: Mozilla/5.0\r\nReferer: https://www.patreon.com/\r\n" \
    -i "https://cdn.patreon.com/.../playlist.m3u8" \
    -c copy output.mp4

6.3.3 Quality-Specific Download

# Download specific quality stream
ffmpeg -i "https://example.com/720p/playlist.m3u8" -c copy output_720p.mp4

# Download best quality from master playlist
ffmpeg -i "https://example.com/master.m3u8" \
    -map 0:v:0 -map 0:a:0 \
    -c copy output_best.mp4

6.4 Stream Conversion and Processing

6.4.1 Format Conversion

# Convert WebM to MP4
ffmpeg -i input.webm -c:v libx264 -c:a aac output.mp4

# Convert with quality control
ffmpeg -i input.mp4 -c:v libx264 -crf 23 -c:a aac -b:a 128k output_compressed.mp4

# Quick copy (no re-encoding)
ffmpeg -i input.ts -c copy output.mp4

6.4.2 Audio Bitstream Filter

# Fix AAC audio for MP4 container
ffmpeg -i "playlist.m3u8" -c copy -bsf:a aac_adtstoasc output.mp4

6.4.3 Resolution Adjustment

# Scale to 720p
ffmpeg -i input.mp4 -vf scale=1280:720 -c:v libx264 -crf 23 -c:a copy output_720p.mp4

# Maintain aspect ratio
ffmpeg -i input.mp4 -vf "scale=1280:-2" -c:v libx264 output_scaled.mp4

6.5 Audio/Video Stream Handling

6.5.1 Extract Audio Only

# Extract audio as AAC
ffmpeg -i input.mp4 -vn -c:a aac audio_only.aac

# Extract audio as MP3
ffmpeg -i input.mp4 -vn -c:a libmp3lame -b:a 192k audio_only.mp3

6.5.2 Extract Video Only

# Video without audio
ffmpeg -i input.mp4 -an -c:v copy video_only.mp4

6.5.3 Merge Separate Streams

# Combine video and audio
ffmpeg -i video.mp4 -i audio.aac -c copy combined.mp4

# With offset synchronization
ffmpeg -i video.mp4 -itsoffset 0.5 -i audio.aac -c copy synced.mp4

6.6 Troubleshooting Commands

# Handle broken segments
ffmpeg -err_detect ignore_err -i "playlist.m3u8" -c copy output.mp4

# Fix timestamp issues
ffmpeg -i input.mp4 -avoid_negative_ts make_zero -c copy fixed.mp4

# Reconstruct index for seeking
ffmpeg -i input.mp4 -c copy -movflags +faststart output.mp4

# Handle segment retry
ffmpeg -protocol_whitelist file,http,https,tcp,tls -max_reload 5 \
    -i "master.m3u8" -c copy output.mp4

7. Patreon-dl Tool Implementation

7.1 Overview

patreon-dl is a specialized Node.js-based command-line tool designed specifically for downloading content from Patreon posts, including support for embedded video extraction.

7.2 Installation

# Prerequisites
# - Node.js v20 or higher
# - FFmpeg (recommended)

# Install globally via npm
npm i -g patreon-dl

# Verify installation
patreon-dl --version

7.3 Basic Usage

7.3.1 Download Single Post

# Basic download
patreon-dl --cookie "your_session_cookie" "https://www.patreon.com/posts/{POST_ID}"

# With output directory
patreon-dl --cookie "your_session_cookie" \
    --out-dir ./downloads \
    "https://www.patreon.com/posts/{POST_ID}"

7.3.2 Download Creator Content

# Download all posts from creator
patreon-dl --cookie "your_session_cookie" \
    --out-dir ./downloads \
    "https://www.patreon.com/{CREATOR_NAME}"

7.4 CLI Options

Option Description
--cookie <string> Patreon session cookie for authentication
--ffmpeg <path> Path to FFmpeg binary
--config-file <path> Path to configuration file
--out-dir <path> Output directory for downloads
--log-level <level> Logging verbosity (info, debug, warn, error)
--no-prompt Skip confirmation prompts
--dry-run Test without saving files
--deno <path> Path to Deno binary (for YouTube Premium)

7.5 Configuration File

7.5.1 Basic Configuration

[downloader]
path.to.ffmpeg = "/usr/bin/ffmpeg"
path.to.deno = "/usr/bin/deno"

[output]
directory = "./downloads"
filename.template = "{post.title}"

7.5.2 External Downloader Configuration (example-embed.conf)

# YouTube embed downloader
[embed.downloader.youtube]
exec = yt-dlp -o "{dest.dir}/%(title)s.%(ext)s" "{embed.url}"

# Vimeo embed downloader
[embed.downloader.vimeo]
exec = yt-dlp -o "{dest.dir}/%(title)s.%(ext)s" "{embed.url}"

# Generic video downloader
[embed.downloader.default]
exec = yt-dlp -o "{dest.dir}/%(title)s.%(ext)s" "{embed.url}"

7.5.3 Template Variables

  • {embed.url}: Extracted video embed URL
  • {embed.provider}: Video provider (YouTube, Vimeo)
  • {post.id}: Patreon post ID
  • {post.title}: Post title
  • {dest.dir}: Destination directory

7.6 Session Cookie Extraction

From Browser Developer Tools:

  1. Open patreon.com in browser
  2. Login to your account
  3. Open Developer Tools (F12)
  4. Go to Application/Storage → Cookies
  5. Find session_id cookie
  6. Copy the value

Using browser extensions:

  1. Install "EditThisCookie" or similar
  2. Navigate to patreon.com
  3. Export cookies in Netscape format

7.7 Advanced Usage

# With verbose logging
patreon-dl --cookie "session_cookie" \
    --log-level debug \
    --out-dir ./downloads \
    "https://www.patreon.com/posts/{POST_ID}"

# Using config file
patreon-dl --cookie "session_cookie" \
    --config-file ./patreon-dl.conf \
    "https://www.patreon.com/{CREATOR}"

# Dry run to test
patreon-dl --cookie "session_cookie" \
    --dry-run \
    "https://www.patreon.com/posts/{POST_ID}"

8. Alternative Tools and Backup Methods

8.1 gallery-dl

gallery-dl is a powerful cross-platform tool for downloading images and videos from many content platforms including Patreon.

8.1.1 Installation

# Using pip
python3 -m pip install -U gallery-dl

# Using Homebrew (macOS)
brew install gallery-dl

# Using Snap (Linux)
snap install gallery-dl

8.1.2 Patreon Usage

# Download with browser cookies
gallery-dl --cookies-from-browser firefox "https://www.patreon.com/{CREATOR}"

# Download specific post
gallery-dl --cookies-from-browser firefox "https://www.patreon.com/posts/{POST_ID}"

# Get URLs only (no download)
gallery-dl --get-urls --cookies-from-browser firefox "https://www.patreon.com/{CREATOR}"

# Save to specific directory
gallery-dl --cookies-from-browser firefox \
    --destination "/path/to/folder" \
    "https://www.patreon.com/{CREATOR}"

8.1.3 Configuration

Create ~/.config/gallery-dl/config.json:

{
    "extractor": {
        "patreon": {
            "cookies": ["firefox"],
            "directory": ["patreon", "{creator[vanity]}"],
            "filename": "{id}_{title}.{extension}",
            "videos": true,
            "postfiles": true
        }
    }
}

8.2 Streamlink

Streamlink specializes in live streams but can handle recorded content on supported platforms.

8.2.1 Installation

# Using pip
pip install streamlink

# Using Homebrew (macOS)
brew install streamlink

8.2.2 Usage

# Stream to player
streamlink "https://example.com/stream" best

# Save to file
streamlink "https://example.com/stream" best -o output.mp4

# Specify quality
streamlink "https://example.com/stream" 720p -o output_720p.mp4

Note: Streamlink has limited direct Patreon support. It works best when you have the direct HLS stream URL.

8.3 wget/cURL for Direct Downloads

8.3.1 Direct File Downloads

# Using wget with authentication
wget --header="Cookie: session_id=YOUR_SESSION_COOKIE" \
    --header="Referer: https://www.patreon.com/" \
    -O "video.mp4" \
    "https://cdn.patreon.com/video/{ID}/file.mp4"

# Using cURL
curl -H "Cookie: session_id=YOUR_SESSION_COOKIE" \
    -H "Referer: https://www.patreon.com/" \
    -H "User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36" \
    -L -o "video.mp4" \
    "https://cdn.patreon.com/video/{ID}/file.mp4"

8.3.2 HLS Segment Download

# Download m3u8 playlist
wget -O playlist.m3u8 "https://cdn.patreon.com/.../master.m3u8"

# Extract segment URLs and download
grep -v "^#" playlist.m3u8 | xargs -I {} wget {}

8.4 Browser Developer Tools Method

8.4.1 Manual Network Inspection

  1. Open browser Developer Tools (F12)
  2. Navigate to Network tab
  3. Filter by "mp4", "m3u8", or "media"
  4. Play the Patreon video
  5. Identify video stream URLs
  6. Right-click → Copy as cURL

8.4.2 Extract URLs from HAR Export

# Export HAR file from browser
# Extract video URLs
grep -oE "https://[^\"]*\.(mp4|m3u8|ts)[^\"]*" network_export.har | sort -u

8.5 Browser Extensions

Recommended browser extensions for video extraction:

  • Video DownloadHelper (Firefox/Chrome)
  • Patreon Downloader (Chrome) - For downloadable attachments
  • Stream Detector (Firefox) - Detects HLS streams

8.6 Tool Comparison

Tool Patreon Support Authentication Best For
yt-dlp Good (with cookies) Cookies General downloads
patreon-dl Excellent Session cookie Patreon-specific
gallery-dl Good Cookies Bulk downloads
FFmpeg Direct streams Headers HLS processing
Streamlink Limited N/A Live streams
wget/cURL Direct files Cookies/Headers Simple downloads

9. Implementation Recommendations

9.1 Primary Implementation Strategy

9.1.1 Recommended Tool Hierarchy

  1. patreon-dl: Primary tool for Patreon-specific content
  2. yt-dlp: Secondary for embedded videos (YouTube, Vimeo)
  3. gallery-dl: Backup for bulk content
  4. FFmpeg: For direct HLS stream processing
  5. wget/cURL: Last resort for direct file URLs

9.1.2 Hierarchical Download Script

#!/bin/bash
# download_patreon_video.sh

# Cookie handling:
# - For yt-dlp/gallery-dl: Use Netscape cookie file format
# - For patreon-dl: Use session cookie string directly
COOKIE_FILE="$HOME/.patreon_cookies.txt"
SESSION_COOKIE="your_session_cookie_here"  # Set this from session_id cookie
OUTPUT_DIR="${2:-./downloads}"
URL="$1"

mkdir -p "$OUTPUT_DIR"

echo "Attempting download of: $URL"

# Method 1: patreon-dl (if available)
# Note: patreon-dl uses --cookie with a string value, not a file
if command -v patreon-dl &> /dev/null; then
    echo "Trying patreon-dl..."
    if patreon-dl --cookie "$SESSION_COOKIE" --out-dir "$OUTPUT_DIR" "$URL"; then
        echo "✓ Success with patreon-dl"
        exit 0
    fi
fi

# Method 2: yt-dlp (uses Netscape cookie file or browser cookies)
echo "Trying yt-dlp..."
if yt-dlp --cookies "$COOKIE_FILE" -o "$OUTPUT_DIR/%(title)s.%(ext)s" "$URL"; then
    echo "✓ Success with yt-dlp"
    exit 0
fi

# Method 3: gallery-dl
echo "Trying gallery-dl..."
if gallery-dl --cookies "$COOKIE_FILE" --destination "$OUTPUT_DIR" "$URL"; then
    echo "✓ Success with gallery-dl"
    exit 0
fi

echo "✗ All methods failed"
exit 1

9.2 Quality Selection Strategy

# Quality selection function
select_quality() {
    local url="$1"
    local max_quality="${2:-1080}"
    local max_size_mb="${3:-500}"
    
    echo "Checking available formats..."
    yt-dlp --cookies-from-browser firefox -F "$url"
    
    echo "Downloading with quality limit: ${max_quality}p, size limit: ${max_size_mb}MB"
    yt-dlp --cookies-from-browser firefox \
        -f "best[height<=$max_quality][filesize<${max_size_mb}M]/best[height<=$max_quality]/best" \
        "$url"
}

9.3 Batch Processing

9.3.1 Batch Download Script

#!/bin/bash
# batch_download_patreon.sh

URL_FILE="$1"
OUTPUT_DIR="${2:-./downloads}"
DELAY="${3:-5}"

mkdir -p "$OUTPUT_DIR"

total=$(wc -l < "$URL_FILE")
current=0

while IFS= read -r url; do
    [[ "$url" =~ ^#.*$ ]] && continue  # Skip comments
    [[ -z "$url" ]] && continue         # Skip empty lines
    
    ((current++))
    echo "[$current/$total] Downloading: $url"
    
    yt-dlp --cookies-from-browser firefox \
        -o "$OUTPUT_DIR/%(uploader)s/%(title)s.%(ext)s" \
        --retries 3 \
        --fragment-retries 3 \
        "$url"
    
    echo "Waiting ${DELAY} seconds..."
    sleep "$DELAY"
done < "$URL_FILE"

echo "Batch download complete!"

9.3.2 Parallel Download with Rate Limiting

# Download multiple videos in parallel (max 3 concurrent)
download_single() {
    local url="$1"
    yt-dlp --cookies-from-browser firefox \
        -o "./downloads/%(title)s.%(ext)s" \
        --limit-rate 500K \
        "$url"
}

export -f download_single

# Using GNU parallel
parallel -j 3 download_single :::: urls.txt

9.4 Error Handling and Resilience

9.4.1 Retry Logic

download_with_retries() {
    local url="$1"
    local max_retries=3
    local delay=5
    
    for i in $(seq 1 $max_retries); do
        echo "Attempt $i of $max_retries..."
        
        if yt-dlp --cookies-from-browser firefox \
            --retries 2 \
            --fragment-retries 2 \
            "$url"; then
            echo "✓ Success on attempt $i"
            return 0
        fi
        
        echo "Failed, waiting ${delay}s before retry..."
        sleep $delay
        delay=$((delay * 2))  # Exponential backoff
    done
    
    echo "✗ All attempts failed"
    return 1
}

9.4.2 Cookie Refresh Detection

check_authentication() {
    local test_url="$1"
    
    if yt-dlp --cookies-from-browser firefox \
        --dump-json "$test_url" 2>&1 | grep -q "login\|private\|authenticate"; then
        echo "⚠ Authentication expired. Please refresh cookies."
        return 1
    fi
    
    echo "✓ Authentication valid"
    return 0
}

9.5 Logging and Monitoring

setup_logging() {
    local log_dir="./logs"
    mkdir -p "$log_dir"
    
    local date_stamp=$(date +"%Y%m%d")
    export DOWNLOAD_LOG="$log_dir/downloads_$date_stamp.log"
    export ERROR_LOG="$log_dir/errors_$date_stamp.log"
}

log_download() {
    local action="$1"
    local url="$2"
    local timestamp=$(date '+%Y-%m-%d %H:%M:%S')
    
    case "$action" in
        "start")
            echo "[$timestamp] START: $url" >> "$DOWNLOAD_LOG"
            ;;
        "complete")
            local file="$3"
            echo "[$timestamp] COMPLETE: $url -> $file" >> "$DOWNLOAD_LOG"
            ;;
        "error")
            local error="$3"
            echo "[$timestamp] ERROR: $url | $error" >> "$ERROR_LOG"
            ;;
    esac
}

10. Troubleshooting and Edge Cases

10.1 Common Issues and Solutions

10.1.1 Authentication Errors

Issue: "Login required" or "Private content"

# Solution 1: Refresh browser cookies
yt-dlp --cookies-from-browser firefox --rm-cache-dir "URL"

# Solution 2: Re-export cookies file
# Delete old cookie file and re-export from browser

# Solution 3: Use fresh browser session
# Log out, clear cookies, log back in, then export

Issue: Cookie expiration

# Check cookie validity
yt-dlp --cookies-from-browser firefox --dump-json "URL" 2>&1 | head -20

# Cookies typically expire after:
# - Session cookies: Browser close
# - Persistent cookies: 30 days

10.1.2 Rate Limiting

Issue: "Too many requests" errors

# Add delays between downloads
yt-dlp --cookies-from-browser firefox \
    --sleep-interval 5 \
    --max-sleep-interval 15 \
    --limit-rate 1M \
    "URL"

Issue: IP-based blocking

# Use different user agent
yt-dlp --cookies-from-browser firefox \
    --user-agent "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36" \
    "URL"

10.1.3 Format/Codec Issues

Issue: No video formats available

# Check if content is embedded from another platform
yt-dlp --cookies-from-browser firefox --dump-json "URL" | jq '.entries'

# For embedded YouTube/Vimeo, extract embed URL first

Issue: Audio/video sync problems

# Re-encode with proper sync
ffmpeg -i input.mp4 -async 1 -c:v copy -c:a aac output_synced.mp4

10.2 Platform-Specific Edge Cases

10.2.1 Native Patreon Video

Native Patreon videos (not embeds) require special handling:

# These may not be supported by yt-dlp
# Use patreon-dl or direct download methods

# Check if video is native Patreon
curl -s "https://www.patreon.com/posts/{POST_ID}" | grep -o "cdn.patreon.com"

10.2.2 Vimeo Private Embeds

For Vimeo videos embedded in Patreon with privacy settings:

# May need both Patreon and Vimeo cookies
yt-dlp --cookies-from-browser firefox \
    --add-header "Referer:https://www.patreon.com/" \
    "URL"

# Or extract the embed URL and download separately

10.2.3 YouTube Members-Only Content

For YouTube videos that are members-only when embedded:

# Ensure you're logged into YouTube in the same browser
yt-dlp --cookies-from-browser firefox \
    "https://www.youtube.com/watch?v={VIDEO_ID}"

10.3 HLS Stream Issues

10.3.1 Expired Stream URLs

# HLS URLs often expire quickly
# Capture and download immediately

# If URL expired, re-fetch from page
curl -s "PAGE_URL" | grep -oE "https://[^\"]*\.m3u8[^\"]*"

10.3.2 Segmented Stream Recovery

# If some segments fail, try with error tolerance
ffmpeg -err_detect ignore_err \
    -i "playlist.m3u8" \
    -c copy output.mp4

# Or try with max reload
ffmpeg -protocol_whitelist file,http,https,tcp,tls \
    -max_reload 10 \
    -i "playlist.m3u8" \
    -c copy output.mp4

10.4 Diagnostic Commands

# Full verbose output
yt-dlp --cookies-from-browser firefox -v "URL" 2>&1 | tee debug.log

# Test authentication
yt-dlp --cookies-from-browser firefox --dump-json "URL" | jq '.title, .uploader'

# List all formats with details
yt-dlp --cookies-from-browser firefox -F --verbose "URL"

# Check for embeds
yt-dlp --cookies-from-browser firefox --dump-json "URL" | jq '.entries[] | .url'

# Test specific user agent
yt-dlp --cookies-from-browser firefox \
    --user-agent "Mozilla/5.0 (compatible; Googlebot/2.1)" \
    --verbose "URL"

10.5 File Integrity Verification

# Check downloaded video integrity
verify_video() {
    local file="$1"
    
    if ! [ -f "$file" ]; then
        echo "✗ File not found"
        return 1
    fi
    
    # Check file size (should be > 0)
    local size=$(stat -f%z "$file" 2>/dev/null || stat -c%s "$file")
    if [ "$size" -lt 1000 ]; then
        echo "✗ File too small: $size bytes"
        return 1
    fi
    
    # Verify with ffprobe
    if ffprobe -v error "$file" > /dev/null 2>&1; then
        echo "✓ Video file valid"
        return 0
    else
        echo "✗ Video file corrupted"
        return 1
    fi
}

11. Conclusion

11.1 Summary of Findings

This research has comprehensively analyzed Patreon's video delivery infrastructure, revealing a multi-layered architecture that includes:

  • Native video hosting via CloudFront CDN with session-based authentication
  • Third-party embeds primarily from YouTube and Vimeo with their respective CDNs
  • Direct file attachments for downloadable content

Key Technical Findings:

  • Patreon native videos require session cookie authentication
  • Third-party embeds follow standard platform patterns (YouTube, Vimeo)
  • HLS streaming is used for adaptive quality delivery
  • CDN URLs are often time-limited and signed

11.2 Recommended Implementation Approach

Based on our research, we recommend a hierarchical download strategy:

  1. Primary Method: patreon-dl for Patreon-specific content (95% success rate expected)
  2. Secondary Method: yt-dlp with cookies for general video extraction
  3. Tertiary Method: gallery-dl for bulk content archival
  4. Quaternary Method: FFmpeg for direct HLS stream processing
  5. Backup Methods: wget/cURL for direct file downloads

11.3 Tool Recommendations

Essential Tools:

  • patreon-dl: Specialized Patreon downloader with embed support
  • yt-dlp: Primary download tool with extensive format support
  • ffmpeg: Stream processing, conversion, and analysis
  • gallery-dl: Bulk download and archival

Recommended Backup Tools:

  • streamlink: For live stream capture
  • wget/cURL: Direct HTTP downloads with custom headers
  • Browser extensions: Video DownloadHelper, Stream Detector

Infrastructure Tools:

  • Docker: Containerized deployment for consistency
  • Cron/Task Scheduler: Automated periodic downloads

11.4 Performance Considerations

Optimal performance with:

  • Concurrent Downloads: 2-3 simultaneous downloads per IP
  • Rate Limiting: 30 requests per minute to avoid throttling
  • Retry Logic: Exponential backoff with 3-5 retry attempts
  • Quality Selection: 720p provides best balance of quality/size
  • Cookie Refresh: Re-export cookies every 2-4 weeks

11.5 Security and Compliance Notes

Important Considerations:

  • Respect Patreon's terms of service and creator content rights
  • Only download content you have legitimate patron access to
  • Implement appropriate rate limiting to avoid service disruption
  • Protect session cookies and authentication data
  • Consider data protection and privacy requirements

11.6 Future Research Directions

Areas for Continued Development:

  1. API Integration: Direct Patreon API access for metadata
  2. Automation: Scheduled downloads for new content
  3. Quality Optimization: Adaptive quality selection based on bandwidth
  4. Archive Management: Metadata indexing and search
  5. Mobile Support: Download capture from mobile apps

11.7 Maintenance and Updates

Given the dynamic nature of web platforms, this research should be updated regularly:

  • Monthly: URL pattern validation and authentication testing
  • Quarterly: Tool compatibility and version updates
  • Annually: Comprehensive architecture review

Disclaimer: This research is provided for educational and legitimate archival purposes. Users must comply with applicable terms of service, copyright laws, and data protection regulations when implementing these techniques. Only download content you have legitimate access to as a patron.

Last Updated: December 2024
Research Version: 1.0
Next Review: March 2025

Related

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment