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
# vdl configuration file
# Location: $HOME/.config/vdl/config.yaml
# Directory where downloaded files are saved
download_path: ~/Downloads/vdl
# Default output container format
# Options: mp4 | mkv | webm | mp3 | m4a | opus
default_format: mp4
# Default video quality when --quality flag is omitted
# Options: best | 1080 | 720 | 480 | 360 | worst
default_video_quality: 1080
# Platform-specific quality overrides
platform_quality:
youtube: 1080
tiktok: 720
instagram: 720
twitter: 720
spotify: best
# Path where sandboxed binaries are stored
# Do NOT change this unless you know what you are doing
bins_dir: ~/.local/share/vdl/bins
# Optional Netscape cookies file for sites that require authentication
# Set to null to disable
cookies_file: null
# Optional browser name to import cookies from
# Examples: chrome | firefox | brave | edge
# Set to null to disable
cookies_from_browser: null
# Show video metadata preview and prompt before downloading
confirm_before_download: true
# Number of search results to show
search_results_count: 8
# ── Termux / Android ─────────────────────────────────────────
#
# Set to true if running on Android via Termux.
# vdl auto-detects Termux via the TERMUX_VERSION environment
# variable, so you normally do not need to set this manually.
# Set it manually only if auto-detection is not working.
termux_mode: false
# Set to true to disable all animated spinners and progress bars.
# Automatically enabled when termux_mode is true.
# Also useful when piping vdl output to a log file.
no_progress: false