Chuyển đến nội dung
VI
Lấy khóa API
Duyệt tài liệu

Hướng dẫn

Các lệnh yt-dlp dùng hằng ngày

Sao chép lệnh cho video, âm thanh, phụ đề, tập dữ liệu và tiếp tục thu thập.

Trên trang này

Thiết lập và lệnh các hiệp ước

Bắt đầu từ những nghiện đêm và hoàn toàn hiện tại
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
deno --version
ffmpeg -version
python -m yt_dlp --list-impersonate-targets

Các công thức tải về sử dụng Deno và --impersonate="" như một dòng cơ bản. Điều này yêu cầu curl-cffi và cho phép nó chọn một dấu vân tay trình duyệt có sẵn. Linux/macOS lệnh sử dụng Bash syntax; cho một công nhân có kế hoạch, cũng làm cho các phụ thuộc này có sẵn trong môi trường dịch vụ đó.

Các ví dụ cuối cùng này sử dụng cài đặt Python của yt-dlp. Sử dụng Python môi trường ảo của bạn, hoặc thay thế Python -m yt_dlp với lệnh tự động yt-dlp. Sử dụng Linux trước tiên, với các lựa chọn thay thế macOS và Windows trong hướng dẫn cài đặt. Cài đặt FFmpeg/ffprobe để kết hợp và Deno cho YouTube thách thức giải quyết. Thay thế URL ví dụ với nguồn của bạn.

Công ướcTại sao nó quan trọng
URL và templateCác shell khác giải thích các nhân vật như &, không gian và parentheses.
Lưu %(ext)s trong tên fileCác phương tiện truyền thông được chọn và sau khi xử lý xác định sự mở rộng.
Sử dụng --no-playlist cho một đồng hồ URLMột video được liên kết từ danh sách phát không nên mở rộng công việc của bạn bất ngờ.
Kiểm tra cấu hình được tiết kiệm của bạnVí dụ có thể thừa hưởng một cấu hình toàn cầu. Sử dụng --ignore-config cho một bài kiểm tra riêng biệt.
Windows .bat: dấu hiệu phần trăm mẫu đôiSử dụng %(id)s trong một tập tin bộ, nhưng %(id)s trong các tập tin PowerShell tương tác và cấu hình bình thường.

Video chất lượng và MP4

Baseline: tối đa, Deno và FFmpeg, với --impersonate="". công thức sử dụng Bash; thay thế URL mẫu với nguồn của bạn.

Tải xuống 1 video với tùy chọn mặc định
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -P downloads \
  -o "%(id)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Chọn dòng có sẵn bằng cách sử dụng các tùy chọn mặc định của yt-dlp. container không nhất thiết là MP4.
Danh sách các định dạng có sẵn
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  -F "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Kiểm tra codec và audio-only/video-only hàng. ID định dạng số không phải là chính sách xuất khẩu di động.
Ưu tiên 1080p
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -S "res:1080" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Một ưu tiên: nếu không có định dạng ở hoặc dưới mục tiêu có sẵn, phân loại có thể chọn một trên đó.
+ Tăng tối đa 1080p
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  -f "bv*[height<=1080]+ba/b[height<=1080]" "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Một bộ lọc: thất bại khi không có định dạng tương ứng. giữ cho sự lựa chọn của codec nguồn.
H.264 video và AAC âm thanh trong MP4
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  -f "bv[vcodec^=avc1][height<=1080]+ba[acodec^=mp4a]/b[vcodec^=avc1][acodec^=mp4a][height<=1080]" \
  --merge-output-format mp4 "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Chọn codec nghiêm ngặt. yêu cầu các định dạng phù hợp và FFmpeg cho sự kết hợp dòng riêng biệt.

AI Dataset: MP4 + Captions + Metadata

Video + âm thanh tốt nhất, MP4, captions và metadata
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  -f "bestvideo+bestaudio/best" --merge-output-format mp4 --remux-video mp4 \
  --write-info-json --write-subs --write-auto-subs --sub-langs "en" --sub-format "vtt/best" \
  --sleep-subtitles 5 --concurrent-fragments 1 -P dataset -o "%(id)s/%(id)s.%(ext)s" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
FFmpeg kết hợp dòng nguồn. MP4 giữ codec nguồn; kiểm tra sự tương thích của decoder và ghi lại bao phủ riêng biệt.

Tính năng tải về: aria2c

2 kết nối, bản địa DASH/HLS
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist --downloader aria2c \
  --downloader "dash,m3u8:native" --downloader-args "aria2c:-x 2 -s 2 -j 1" \
  --concurrent-fragments 1 -P downloads "https://www.youtube.com/watch?v=jNQXAC9IVRw"
aria2c yürütülebilir dosyası gerekir. Bağlantı sayısını artırmadan önce tek bir videoyu indirmeyi doğrulayın. 403 hatası görülürse sayıyı hemen azaltın.

aria2 có triển khai mạng riêng. yt-dlp curl-cffi không cấu hình dấu vân tay aria2. Nếu chỉ có trình tải xuống bên ngoài thất bại, hãy sử dụng --downloader bản địa và so sánh cùng một nguồn và đường dẫn proxy.

Âm thanh và MP3

Lưu dòng âm thanh ban đầu
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -f ba -P audio \
  -o "%(id)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Không MP3 chuyển đổi. hữu ích khi đường ống chuyển đổi hoặc tái phát của bạn chấp nhận codec ban đầu.
Chuyển đổi thành MP3 với tỷ lệ bit mục tiêu
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -f ba -x \
  --audio-format mp3 --audio-quality 192K -P audio \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
FFmpeg. 192K kiểm soát mã hóa xuất; nó không khôi phục chất lượng nguồn.
Tốt hơn M4A mà không có mã hóa
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -f "ba[ext=m4a]" -P audio \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Thất bại nếu không có định dạng âm thanh M4A duy nhất có sẵn. thêm /ba chỉ nếu ứng dụng của bạn chấp nhận các container nguồn khác.
MP3 với metadata và cover
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -f ba -x \
  --audio-format mp3 --embed-metadata --embed-thumbnail -P audio \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Các bước metadata/thumbnail là thêm post-processing. kiểm tra file cuối cùng, không chỉ chuyển nhượng hook.

Captions và Subtitles

Danh sách các tuyến đường có sẵn
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  --list-subs "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Đọc các thẻ ngôn ngữ được cung cấp bởi nguồn này trước khi chọn --sub-langs.
Tải xuống chỉ các tiêu đề tiếng Anh cung cấp
python -m yt_dlp --js-runtimes deno --impersonate="" --skip-download --write-subs \
  --sub-langs "en.*" --sub-format "vtt/best" -P captions -o "%(id)s.%(ext)s" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Nó không rơi trở lại các bản ghi tự động và không tải xuống phương tiện truyền thông.
Cũng cho phép cài đặt tiếng Anh tự động
python -m yt_dlp --js-runtimes deno --impersonate="" --skip-download --write-subs \
  --write-auto-subs --sub-langs "en.*" --sub-format "vtt/best" -P captions \
  -o "%(id)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"
en.* có thể tương ứng với nhiều biến thể tiếng Anh. Điều này thu thập các đường đi có sẵn; nó không chạy nhận thức ngôn ngữ.
Chuyển đổi các đường dẫn được chọn sang SRT
python -m yt_dlp --js-runtimes deno --impersonate="" --skip-download --write-subs \
  --write-auto-subs --sub-langs "en" --convert-subs srt -P captions \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Yêu cầu FFmpeg. chọn mã ngôn ngữ khác từ --list-subs nếu cần.
Nhúng các tiêu đề cung cấp trong MKV
python -m yt_dlp --js-runtimes deno --impersonate="" --write-subs --sub-langs "en" \
  --embed-subs --remux-video mkv -P downloads "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Tải về phương tiện truyền thông, yêu cầu cung cấp tiếng Anh dưới tiêu đề và nhập theo dõi có sẵn. kiểm tra xem liệu theo dõi đó có tồn tại trước.

Yêu cầu tất cả các ngôn ngữ ghi lại có thể làm tăng đáng kể số lượng yêu cầu và tệp. Giữ các ngôn ngữ được yêu cầu rõ ràng cho công việc thường xuyên. Giữ ID nguồn và ngôn ngữ trong hồ sơ dữ liệu của bạn để các bản sao không bị tách ra khỏi phương tiện mà họ mô tả.

Metadata và đường xuất

Nhập dữ liệu metadata của một video như JSON
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  --dump-json "https://www.youtube.com/watch?v=jNQXAC9IVRw" > video.json
Simulates download by default, but performs extraction. Hướng dẫn thay thế video.json.
Viết một trang web đầy đủ metadata mà không có phương tiện truyền thông
python -m yt_dlp --js-runtimes deno --impersonate="" --skip-download --write-info-json \
  -P metadata -o "%(id)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Tạo một .info.json bên. Đây là dữ liệu khai thác hoạt động; các trường dự án trước khi tiết lộ nó công khai.
Tải xuống chỉ mini
python -m yt_dlp --js-runtimes deno --impersonate="" --skip-download --write-thumbnail \
  -P thumbnails -o "%(id)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Tiết kiệm các chi tiết có sẵn trong định dạng nguồn của nó. --convert-thumbnails jpg thêm một bước chuyển đổi khi JPEG được yêu cầu.
in phương tiện truyền thông cuối cùng sau khi xử lý
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  --print after_move:filepath -P downloads -o "%(id)s.%(ext)s" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Không giống như một giai đoạn mặc định --print, một after_move in chờ cho một tải xuống thực sự và chuyển động cuối cùng của nó.
Đề xuất các con đường hoàn thành cho một biểu hiện
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  --print-to-file after_move:filepath completed-paths.txt -P downloads \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Thêm, để rút lại có thể tạo ra các bản ghi lặp lại. xử lý nó như một sổ ghi chép hoàn thành, không phải là một bản ghi được phân tán.

Thời gian và các chương

Tải xuống 5 qua 10
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  --download-sections "*00:00:05-00:00:10" -o "clips/%(id)s-%(section_start)s.%(ext)s" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Yêu cầu FFmpeg. một giới hạn clip có thể phù hợp với các khung khóa có sẵn; xác minh kết quả khi thời gian chính xác là quan trọng.
Re-coding xung quanh yêu cầu cắt
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  --download-sections "*00:00:05-00:00:10" --force-keyframes-at-cuts \
  -o "clips/%(id)s-%(section_start)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Thêm công việc mã hóa lại để cải thiện cắt ở các giới hạn được yêu cầu. Kiểm tra thời gian kết quả và audio/video phù hợp.
Chia một video được chia thành các tập tin
python -m yt_dlp --split-chapters -o "chapter:%(id)s-%(section_number)03d.%(ext)s" \
  "https://www.youtube.com/watch?v=YOUR_VIDEO_ID"
Sử dụng video với các metadata chương. Các phần xuất phát được tách ra từ bản gốc đầy đủ tải xuống; không gian đĩa ngân sách cho cả hai.

Sử dụng chính sách xuất khẩu hoặc lưu trữ khác nhau cho clip và video đầy đủ. một bản ghi lưu trữ cấp nguồn không mã hóa các lần được chọn start/end, vì vậy một lưu trữ chia sẻ có thể xóa một clip sau đó bạn dự định tạo.

Danh sách game và danh sách URL

Tải về danh sách URL được biết đến
python -m yt_dlp --no-playlist --batch-file urls.txt -P collection -o "%(id)s.%(ext)s"
Tạo một tệp UTF-8 với một URL xem mỗi dòng. --no-playlist áp dụng để xem URL bao gồm bối cảnh danh sách phát.
Kiểm tra danh sách phát trên YouTube mà không cần video hoàn chỉnh
python -m yt_dlp --flat-playlist \
  --dump-json "https://www.youtube.com/playlist?list=YOUR_PLAYLIST_ID" > playlist.jsonl
Một JSON đối tượng mỗi nhập. các nhập phẳng có thể bỏ qua thời gian và định dạng chi tiết.
Tải về 5 bài đăng đầu tiên
python -m yt_dlp --playlist-items 1:5 -P collection -o "%(playlist_index)03d-%(id)s.%(ext)s" \
  "https://www.youtube.com/playlist?list=YOUR_PLAYLIST_ID"
Danh sách phát trực tuyến chỉ số hiển thị lệnh, không phải danh tính. giữ ID video trong tên file.
Giới hạn các video đủ điều kiện theo ngày và thời gian
python -m yt_dlp --dateafter 20260101 --match-filters "!is_live & duration <= 1800" \
  --batch-file urls.txt
Yêu cầu các mục không sống với thời gian được biết đến lên đến 30 phút, ngày vào hoặc sau tháng 1 1, 2026.
Ngừng sau 10 tải xuống mới
python -m yt_dlp --download-archive archive.txt --max-downloads 10 --batch-file urls.txt
Giới hạn kiểm soát các tập tin mới được tải xuống, không phải số lượng yêu cầu listing/extraction xảy ra.

Archives and phục hồi

Tóm lại một bộ sưu tập với chính sách tương tự
python -m yt_dlp --download-archive archive.txt --continue --no-abort-on-error -P collection \
  -o "%(id)s.%(ext)s" --batch-file urls.txt
ID hoàn thành được bỏ qua. tải về một phần tái xuất nơi được hỗ trợ. sử dụng cùng các đường lưu trữ và xuất khẩu như công việc ban đầu.
Hòa bình một công nhân và ràng buộc nghỉ hưu của mình
python -m yt_dlp --sleep-requests 1 --sleep-interval 5 --max-sleep-interval 10 --retries 3 \
  --fragment-retries 3 --socket-timeout 30 --batch-file urls.txt
Thêm giới hạn nhân viên cấp độ quoi khi nhiều quá trình chia sẻ một con đường hoặc phiên.
Cap Transfer Bandwidth - Độ phân giải
python -m yt_dlp --js-runtimes deno --impersonate="" --limit-rate 2M \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Kiểm soát tỷ lệ chuyển giao phương tiện. nó không điều chỉnh số lượng yêu cầu khai thác.
Giảm sự cạnh tranh của các mảnh bản địa
python -m yt_dlp --js-runtimes deno --impersonate="" --concurrent-fragments 1 \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Bắt đầu với một mảnh cùng một lúc khi điều tra 403s. các quy trình lao động khác vẫn thêm yêu cầu tương đương của riêng họ.

cấu hình và tên filename

Chỉ tải bộ sưu tập rõ ràng của bạn config
python -m yt_dlp --ignore-config --config-locations yt-dlp-work.conf --batch-file urls.txt
Config được đặt tên rõ ràng cũng được tải lên với --ignore-config. Sử dụng các con đường đầy đủ cho các công việc được lên lịch.
Tên có thể đọc với danh tính ổn định
python -m yt_dlp --js-runtimes deno --impersonate="" -P downloads \
  -o "%(channel_id)s/%(upload_date)s-%(title).150B [%(id)s].%(ext)s" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Tiêu đề được truncated thành 150 byte trong mẫu này. ID phân biệt các tiêu đề lặp hoặc thay đổi.
Sử dụng một thư mục tạm thời riêng biệt
python -m yt_dlp --js-runtimes deno --impersonate="" -P "home:downloads" -P "temp:work" \
  -o "%(id)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Đảm bảo rằng cả hai thư mục đều có đủ không gian; các hệ thống tệp khác nhau có thể yêu cầu một bản sao.

Đối với bộ sưu tập lâu đời, quyết định xem tên file có phải là khóa ứng dụng dễ đọc hoặc ổn định. Tên kênh và tiêu đề có thể thay đổi. Channel/video ID là chìa khóa tốt hơn cho việc phân tán, với các trường mô tả được lưu trữ trong metadata.

Cookie và đường chạy

Sử dụng hồ sơ trình duyệt có truy cập
python -m yt_dlp --js-runtimes deno --impersonate="" \
  --cookies-from-browser "chrome:Profile 1" \
  --no-playlist "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Thay thế Profile 1 với hồ sơ trình duyệt thực tế của bạn.Hãy sử dụng cookie session chỉ khi cần thiết, và giữ chúng riêng tư.
Đọc một tệp cookie riêng tư hiện có
python -m yt_dlp --js-runtimes deno --impersonate="" --cookies private/youtube-cookies.txt \
  --no-playlist "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Yêu cầu định dạng cookie của Netscape. Một JSON xuất không tương đương.
Sử dụng một Deno có thể thực hiện bên ngoài PATH của nhân viên
python -m yt_dlp --js-runtimes "deno:/opt/deno/bin/deno" --impersonate="" \
  --no-playlist "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Thay thế con đường với Deno binary cài đặt cho nhân viên của bạn.

Chẩn đoán và xác minh

Kiểm tra một chiết xuất sạch
python -m yt_dlp --js-runtimes deno --impersonate="" --ignore-config --verbose --simulate \
  --no-playlist "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Xóa cấu hình giả định và không lưu bất kỳ phương tiện truyền thông nào. nó vẫn thực hiện yêu cầu khai thác và không chứng minh rằng một chuyển giao sẽ thành công.
Chụp một hồ sơ chẩn đoán riêng tư
python -m yt_dlp --js-runtimes deno --impersonate="" --ignore-config --verbose --simulate \
  --no-playlist "https://www.youtube.com/watch?v=jNQXAC9IVRw" > diagnostic.log 2>&1
Bản chuyển hướng thay thế log. Redact cookie/header giá trị, proxy xác nhận và ký URL trước khi chia sẻ.
Kiểm tra lưu lượng chảy và thời gian
ffprobe -v error -show_entries format=duration,size:stream=codec_type,codec_name,width,height -of json "YOUR_OUTPUT_FILE"
Sử dụng con đường cuối cùng, sau khi xử lý. ffprobe đọc các đầu; nó không phân tách mỗi khung.
Xóa tệp được lưu mà không tạo ra kết quả
ffmpeg -v error -i "YOUR_OUTPUT_FILE" -f null -
Một kiểm tra sâu hơn đọc toàn bộ tệp. kiểm tra tình trạng xuất và tin nhắn.
Cập nhật gói Python và kiểm tra phiên bản của nó
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
python -m yt_dlp --version