Thinkific-Downloader/.env.example at main · ByteTrix/Thinkific-Downloader · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
# Thinkific-Downloader Environment Configuration
# 🔧 IMPORTANT: See ENV_SETUP.md for complete step-by-step setup instructions
# Copy this file to .env and fill in your actual values

# ===============================================
# REQUIRED AUTHENTICATION
# ===============================================
# ⚠️  NEED HELP? Follow the complete guide: ENV_SETUP.md

# For downloading all content, use the course link.
COURSE_LINK="https://your-thinkific-site.com/api/course_player/v2/courses/your-course-name"

# Client date header - Get this from browser Developer Tools Network tab
CLIENT_DATE="2025-09-23T07:42:31.512Z"

# Browser session cookie - Get this from browser Developer Tools Application/Storage tab
# IMPORTANT: Keep this secret and never share it!
COOKIE_DATA="_thinkific_session=YOUR_SESSION_COOKIE_HERE"

# ===============================================
# BASIC SETTINGS
# ===============================================

# Quality Available: "Original File", "1080p", "720p", "540p", "360p", "224p"
# Recommended: "720p" for good quality and reasonable file size
VIDEO_DOWNLOAD_QUALITY="720p"

# Set download directory (defaults to ./downloads)
# All course content will be downloaded to this directory
OUTPUT_DIR="./downloads"

# ===============================================
# ENHANCED FEATURES
# ===============================================

# Number of concurrent downloads (default: 3, recommended: 1-3)
# ⚠️  CRITICAL: Thinkific has ~3 requests/sec rate limit - DO NOT exceed 3!
# Higher values may cause API errors and skipped files
CONCURRENT_DOWNLOADS=3

# Delay between downloads in seconds (default: 1.0)
# Increase if you encounter rate limiting issues
DOWNLOAD_DELAY=1.0

# Number of retry attempts for failed downloads (default: 3)
RETRY_ATTEMPTS=3

# Rate limiting in MB/s (default: unlimited)
# Set a value to limit download speed (e.g., RATE_LIMIT_MB_S=5.0)
# RATE_LIMIT_MB_S=

# File validation after download (default: true)
# Validates file integrity and size
VALIDATE_DOWNLOADS=true

# Resume partial downloads (default: true)
# Automatically resume interrupted downloads
RESUME_PARTIAL=true

# Debug mode (default: false)
# Enable detailed logging for troubleshooting
DEBUG=false

# Download subtitles/captions when available (default: true)
SUBTITLE_DOWNLOAD_ENABLED=true

# ===============================================
# ADVANCED SETTINGS
# ===============================================

# Set to true to enable ffmpeg presentation merging (requires ffmpeg installed)
# This combines multi-part presentations into single video files
FFMPEG_PRESENTATION_MERGE=false

# ===============================================
# OPTIONAL FEATURES (LEGACY SUPPORT)
# ===============================================

# For selective content downloads, use a custom JSON file listing only the lessons you want to download.
# See SELECTIVE_DOWNLOAD.md for details and examples.
# Specify the file name below. Ex. COURSE_DATA_FILE="my-selective-lessons.json"
COURSE_DATA_FILE=""

# Set to true to download all available video formats/qualities
# Warning: This will significantly increase download size and time
# ALL_VIDEO_FORMATS=false

# Log level (DEBUG, INFO, WARNING, ERROR)
# LOG_LEVEL="INFO"