---
notion-id: 24fca4d7-cb7b-80b8-aa08-e5a5fb1d71cb
---
[https://github.com/yt-dlp/yt-dlp](https://github.com/yt-dlp/yt-dlp)
### 一、配置文件yt-dlp.conf
```shell
# =============================
# Basic download settings
# =============================

# Download best video and audio
-f bestvideo+bestaudio

# Optional output format examples (uncomment the one you want)
# --merge-output-format mkv       # Output MKV format
# --merge-output-format webm      # Output WEBM format
# --merge-output-format mp4       # Output MP4 format

# Restrict filenames for Windows compatibility
#--restrict-filenames
#--windows-filenames

# =============================
# Output directory and filename
# =============================

# Save to "Videos" folder in current directory
# yt-dlp will create the folder if it does not exist
-o ./Videos/%(title)s [%(id)s].%(ext)s

# =============================
# Cookies (for login)
# =============================

# Use cookies file exported from browser to login
--cookies "D:/yt-dlp_win/cookies.txt"

# Alternatively, read cookies directly from Chrome browser (Chrome must be closed)
# --cookies-from-browser chrome

# =============================
# Subtitles
# =============================

# Download auto-generated subtitles
--write-auto-sub

# Specify subtitle language
--sub-lang zh-CN,en

# Optional: embed subtitles into video
# --embed-subs

# =============================
# Error handling and retries
# =============================

# Ignore download errors
--ignore-errors

# Number of retries for failed downloads
--retries 10
--fragment-retries 5

# Optional: do not continue unfinished files
--no-continue

# Optional: do not overwrite existing files
--no-overwrites

# =============================
# Network / proxy settings (optional)
# =============================

# Use proxy for download (example: socks5)
# --proxy socks5://127.0.0.1:1080

# =============================
# Logging and cache
# =============================

# Disable cache to save disk space
--no-cache-dir

# Clean cache after download
--rm-cache-dir

# Optional: write info, description, thumbnail
# --write-info-json
# --write-description
# --write-thumbnail

```
### 二、获取cookies
安装chrome插件`Get cookies.txt LOCALLY`
打开www.youtube.com，注意选择格式 
![[Notion/技术支持/Tools指南/attachments/image.png]]
使用插件**Export**导出`cookies`即可
### 三、yt-dlp脚本.bat
```shell
@echo off
chcp 65001 >nul
setlocal enabledelayedexpansion
color 0B

:: 初始化配置
call :init_config
call :load_config
goto main_menu

:init_config
if not exist "config" mkdir "config"
if not exist "config\config.ini" (
    echo [single] > "config\config.ini"
    echo output_dir=.\video >> "config\config.ini"
    echo format=1080 >> "config\config.ini"
    echo download_type=video >> "config\config.ini"
    echo threads=5 >> "config\config.ini"
    echo. >> "config\config.ini"
    echo [batch] >> "config\config.ini"
    echo output_dir=.\video >> "config\config.ini"
    echo format=1080 >> "config\config.ini"
    echo download_type=video >> "config\config.ini"
    echo threads=3 >> "config\config.ini"
)
if not exist "config\urls.txt" type nul > "config\urls.txt"
if not exist "config\cookies.txt" type nul > "config\cookies.txt"
goto :eof

:load_config
setlocal
set "section="
for /f "usebackq tokens=1,* delims==" %%a in ("config\config.ini") do (
    set "line=%%a"
    set "value=%%b"
    if "!line:[=!" neq "!line!" (
        set "section=!line!"
    ) else if defined section (
        if "!section!"=="[single]" (
            if "%%a"=="output_dir" set "single_output=!value!"
            if "%%a"=="format" set "single_format=!value!"
            if "%%a"=="download_type" set "single_type=!value!"
            if "%%a"=="threads" set "single_threads=!value!"
        ) else if "!section!"=="[batch]" (
            if "%%a"=="output_dir" set "batch_output=!value!"
            if "%%a"=="format" set "batch_format=!value!"
            if "%%a"=="download_type" set "batch_type=!value!"
            if "%%a"=="threads" set "batch_threads=!value!"
        )
    )
)

:: 设置默认值
if not defined single_output set "single_output=.\video"
if not defined single_format set "single_format=1080"
if not defined single_type set "single_type=video"
if not defined single_threads set "single_threads=5"
if not defined batch_output set "batch_output=.\video"
if not defined batch_format set "batch_format=1080"
if not defined batch_type set "batch_type=video"
if not defined batch_threads set "batch_threads=3"

endlocal & (
    set "single_output=%single_output%"
    set "single_format=%single_format%"
    set "single_type=%single_type%"
    set "single_threads=%single_threads%"
    set "batch_output=%batch_output%"
    set "batch_format=%batch_format%"
    set "batch_type=%batch_type%"
    set "batch_threads=%batch_threads%"
)
goto :eof

:main_menu
cls
echo ===== 视频下载工具 ===== 
echo. 
echo [1] 单个视频下载 
echo [2] 批量下载 
echo [0] 退出脚本 
echo. 

set /p choice="请选择功能(0-2): "
if "!choice!"=="1" goto single_video
if "!choice!"=="2" goto batch_videos
if "!choice!"=="0" exit
echo 无效选择，请重新输入 
timeout /t 2 >nul
goto main_menu

:single_video
cls
echo ===== 单个视频下载 ===== 
echo. 
set /p url="请输入视频链接(输入0返回主菜单): "
if "!url!"=="0" goto main_menu
if "!url!"=="" goto single_video

echo. 
echo [1] 使用默认配置 [默认] 
echo [2] 自定义配置 
echo [3] 返回主菜单 
echo. 

set /p config_choice="请选择配置方式(1-3): "
if "!config_choice!"=="2" goto custom_config
if "!config_choice!"=="3" goto main_menu
if "!config_choice!"=="" set "config_choice=1"
call :use_default_config single
goto confirm_download

:use_default_config
if "%1"=="single" (
    set "output_dir=!single_output!"
    set "format=!single_format!"
    set "download_type=!single_type!"
    set "threads=!single_threads!"
) else (
    set "output_dir=!batch_output!"
    set "format=!batch_format!"
    set "download_type=!batch_type!"
    set "threads=!batch_threads!"
)
goto :eof

:custom_config
cls
echo ===== 自定义配置 ===== 
echo. 
set /p output_dir="请输入下载目录(默认.\video): "
if "!output_dir!"=="" set "output_dir=.\video"

echo. 
echo 选择下载类型： 
echo [1] 视频+音频 [默认] 
echo [2] 仅视频^(无音频^) 
echo [3] 仅音频 
set /p type_choice="请选择下载类型(1-3): "
if "!type_choice!"=="2" set "download_type=video_only"
if "!type_choice!"=="3" set "download_type=audio_only"
if "!type_choice!"=="" set "download_type=video"
if "!type_choice!"=="1" set "download_type=video"

if "!download_type!"=="audio_only" (
    echo. 
    echo 选择音频质量： 
    echo [1] 最佳音质 [默认] 
    echo [2] 中等音质 
    echo [3] 较低音质 
    set /p audio_quality="请选择音频质量(1-3): "
    if "!audio_quality!"=="2" set "format=128"
    if "!audio_quality!"=="3" set "format=96"
    if "!audio_quality!"=="" set "format=best"
    if "!audio_quality!"=="1" set "format=best"
    
    echo. 
    set /p threads="请输入下载线程数(1-10，默认5): "
    if "!threads!"=="" set "threads=5"
    goto confirm_download
) else (
    echo. 
    echo 选择视频质量： 
    echo [1] 480P 
    echo [2] 720P 
    echo [3] 1080P [默认] 
    echo [4] 2160P^(4K^) 
    set /p quality="请选择视频质量(1-4): "
    if "!quality!"=="1" set "format=480"
    if "!quality!"=="2" set "format=720"
    if "!quality!"=="" set "format=1080"
    if "!quality!"=="3" set "format=1080"
    if "!quality!"=="4" set "format=2160"
    
    echo. 
    set /p threads="请输入下载线程数(1-10，默认5): "
    if "!threads!"=="" set "threads=5"
    goto confirm_download
)

:confirm_download
cls
echo ===== 下载配置确认 ===== 
echo. 
echo 视频链接: !url! 
echo 下载目录: !output_dir! 

if "!download_type!"=="video" (
    echo 下载类型: 视频+音频
    echo 视频质量: !format!P
) else (
    if "!download_type!"=="video_only" (
        echo 下载类型: 仅视频^(无音频^)
        echo 视频质量: !format!P
    ) else (
        if "!download_type!"=="audio_only" (
            echo 下载类型: 仅音频
            if "!format!"=="best" (
                echo 音频质量: 最佳音质
            ) else (
                echo 音频质量: !format!kbps
            )
        )
    )
)

echo 下载线程: !threads! 

:: 检查cookies.txt文件状态
set "cookies_empty=1"
for /f "usebackq delims=" %%a in ("config\cookies.txt") do set "cookies_empty=0"
if !cookies_empty!==0 (
    echo Cookies状态: 已配置 ^(使用 config\cookies.txt^)
) else (
    echo Cookies状态: 未配置 ^(config\cookies.txt为空^)
)

echo. 
echo [1] 开始下载(默认) 
echo [2] 返回主菜单 
echo. 

set /p confirm="请选择(1-2): "
if "!confirm!"=="2" goto main_menu

call :download_video
echo. 
echo 脚本运行完成，按任意键返回主菜单... 
pause >nul
goto main_menu

:batch_videos
cls
echo ===== 批量下载 ===== 
echo. 

if not exist "config\urls.txt" (
    echo urls.txt文件不存在，已创建空文件 
    type nul > "config\urls.txt"
    timeout /t 2 >nul
    goto main_menu
)

set "urls_empty=1"
for /f "usebackq delims=" %%a in ("config\urls.txt") do set "urls_empty=0"
if !urls_empty!==1 (
    echo urls.txt文件为空，请添加视频链接 
    timeout /t 2 >nul
    goto main_menu
)

call :use_default_config batch

set /a url_count=0
for /f %%i in ('type "config\urls.txt"^|find /v /c ""') do set /a url_count=%%i

echo 检测到!url_count!个视频链接 
echo. 
echo 当前配置： 
echo 下载目录: !output_dir! 

if "!download_type!"=="video" (
    echo 下载类型: 视频+音频
    echo 视频质量: !format!P
) else (
    if "!download_type!"=="video_only" (
        echo 下载类型: 仅视频^(无音频^)
        echo 视频质量: !format!P
    ) else (
        if "!download_type!"=="audio_only" (
            echo 下载类型: 仅音频
            if "!format!"=="best" (
                echo 音频质量: 最佳音质
            ) else (
                echo 音频质量: !format!kbps
            )
        )
    )
)

echo 下载线程: !threads! 

:: 检查cookies.txt文件状态
set "cookies_empty=1"
for /f "usebackq delims=" %%a in ("config\cookies.txt") do set "cookies_empty=0"
if !cookies_empty!==0 (
    echo Cookies状态: 已配置 ^(使用 config\cookies.txt^)
) else (
    echo Cookies状态: 未配置 ^(config\cookies.txt为空^)
)

echo. 
echo [1] 开始下载(默认) 
echo [2] 返回主菜单 
echo. 

set /p batch_choice="请选择(1-2): "
if "!batch_choice!"=="2" goto main_menu

set "url=-a config\urls.txt"
call :download_video
echo. 
echo 脚本运行完成，按任意键返回主菜单... 
pause >nul
goto main_menu

:download_video
cls
echo ===== 开始下载 ===== 
echo. 

:: 根据下载类型设置不同的格式过滤器
if "!download_type!"=="video" (
    set "filter=bv[height<=!format!][ext=mp4]+ba[ext=m4a]/best"
    set "output_format=mp4"
) else if "!download_type!"=="video_only" (
    set "filter=bv[height<=!format!][ext=mp4]/bv[height<=!format!]/best[height<=!format!]"
    set "output_format=mp4"
) else if "!download_type!"=="audio_only" (
    if "!format!"=="best" (
        set "filter=ba[ext=m4a]/ba/best[ext=m4a]/best"
    ) else (
        set "filter=ba[abr<=!format!][ext=m4a]/ba[abr<=!format!]/best[abr<=!format!]"
    )
    set "output_format=mp3"
)

:: 设置文件命名模板
if "!download_type!"=="audio_only" (
    set "output_template=!output_dir!/%%(uploader)s - %%(title)s.%%(ext)s"
) else (
    set "output_template=!output_dir!/%%(uploader)s - %%(title)s [%%(height)sp].%%(ext)s"
)

:: 检查cookies.txt是否存在且非空
set "cookies_empty=1"
for /f "usebackq delims=" %%a in ("config\cookies.txt") do set "cookies_empty=0"

if !cookies_empty!==0 (
    if "!download_type!"=="audio_only" (
        yt-dlp -f "!filter!" --extract-audio --audio-format mp3 --concurrent-fragments !threads! -o "!output_template!" --cookies "config\cookies.txt" !url! || (
            echo Cookie可能已失效，尝试不使用Cookie下载... 
            echo. 
            yt-dlp -f "!filter!" --extract-audio --audio-format mp3 --concurrent-fragments !threads! -o "!output_template!" !url!
        )
    ) else (
        yt-dlp -f "!filter!" --merge-output-format !output_format! --concurrent-fragments !threads! -o "!output_template!" --cookies "config\cookies.txt" !url! || (
            echo Cookie可能已失效，尝试不使用Cookie下载... 
            echo. 
            yt-dlp -f "!filter!" --merge-output-format !output_format! --concurrent-fragments !threads! -o "!output_template!" !url!
        )
    )
) else (
    if "!download_type!"=="audio_only" (
        yt-dlp -f "!filter!" --extract-audio --audio-format mp3 --concurrent-fragments !threads! -o "!output_template!" !url!
    ) else (
        yt-dlp -f "!filter!" --merge-output-format !output_format! --concurrent-fragments !threads! -o "!output_template!" !url!
    )
)

if errorlevel 1 (
    echo 下载失败！ 
    timeout /t 3 >nul
) else (
    echo 下载完成！ 
    timeout /t 3 >nul
)
goto :eof
```