ข้ามไปยังเนื้อหา
TH
รับคีย์ API
เรียกดูเอกสาร

คู่มือ

วิธีใช้ yt-dlp

คู่มือดาวน์โหลดที่เน้น Linux ครอบคลุมการติดตั้งรุ่น nightly รูปแบบไฟล์ คำบรรยาย ชุดข้อมูล และการทำงานเก็บข้อมูลต่อหลังหยุดชะงัก

ในหน้านี้

ติดตั้งฐานการใช้งานประจําวัน

เริ่มต้นด้วย Nightly + Deno + FFmpeg. ใช้สภาพแวดล้อมเสมือนของโครงการและเปิดใช้งานการกําหนดเองเบราว์เซอร์ด้วย --impersonate="" การตั้งค่า Linux ด้านล่างติดตั้งเครื่องมือ macOS และ Windows ตัวเลือกในแท็บ

ตัวอย่าง Ubuntu / Debian ด้วย Python 3.11+ ติดตั้งเครื่องมือระบบสร้างสภาพแวดล้อมเสมือนโครงการแล้วติดตั้งในเวลากลางคืนและพิเศษของมัน Run Deno ของติดตั้งเป็นผู้ใช้เดียวกันที่เจ้าของงาน

ทํางาน Linux
sudo apt-get update
sudo apt-get install -y python3 python3-venv ffmpeg aria2 curl unzip
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
curl -fsSL https://deno.land/install.sh -o /tmp/install-deno.sh
sh /tmp/install-deno.sh
export PATH="$HOME/.deno/bin:$PATH"
deno --version
python -m yt_dlp --version
เครื่องมือสิ่งที่มันทําตรวจสอบ
Python 3.11+แพคเกจ Python และตัวอย่างในชุดนี้python --version
ใหม่ล่าสุด yt-dlp คืน + ปล่อย,curl-cffi พิเศษเครื่องสกัด YouTube อัปเดตที่ตรงกับ EJS Solver และการสนับสนุนการกําหนดเองของเบราว์เซอร์python -m yt_dlp --version
FFmpeg และ ffprobeรวมการไหลแปลงเสียงตัดคลิปและตรวจสอบสื่อที่บันทึกไว้ffmpeg -version / ffprobe -version
Deno 2.3+ (จําเป็นในกระแสทํางานนี้)การทํางานของท้าทาย YouTube ติดตั้งมันบนแต่ละคนไม่เพียง แต่เครื่องพัฒนาของคุณdeno --version

ติดตั้งตัวดําเนินการได้ [default] จัดส่ง EJS สคริปต์ Deno เป็นแยก FFmpeg และ ffprobe ยังต้องอยู่ใน PATH ของพนักงาน

ดู Baseline ทั้งหมด
deno --version
ffmpeg -version
ffprobe -version
python -m pip show yt-dlp yt-dlp-ejs curl-cffi
python -m yt_dlp --list-impersonate-targets
คําสั่งสุดท้ายควรระบุเป้าหมายของเบราว์เซอร์ที่มีอยู่ หากเป้าหมายไม่สามารถเข้าถึงได้ตรวจสอบว่า curl-cffi จะติดตั้งในสภาพแวดล้อมเสมือนนี้
การทดสอบการสกัดด้วย Deno และตัวอักษรเบราว์เซอร์
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose \
  --simulate "https://www.youtube.com/watch?v=jNQXAC9IVRw"
ตรวจสอบ JS runtime และ request-handler สาย การทดสอบการสกัด การติดตามมันด้วยการถ่ายโอนจริง

พื้นฐานการทํางานของ FlashData รวมถึง --impersonate="": มันช่วยให้ curl-cffi เลือกหน้าแปลนเบราว์เซอร์ที่มีอยู่ นี่จะเปลี่ยนคําขอการพิมพ์หน้าต่าง ไม่ให้คุกกี้การเข้าสู่ระบบแก้ไขปัญหาของ JavaScript หรือเปลี่ยน IP การออก หากตัวเลือกนี้ช้าทายเส้นทางทํางานหรือนําไปสู่ข้อผิดพลาดแล้วทําทดสอบแบบวิดีโอเดียวโดยไม่มีการทดสอบและรักษาการตั้งค่าทํางาน

ตรวจสอบการปล่อยก่อนที่จะวางไว้บนพนักงาน

รับการดําเนินการจากหน้าการปล่อยของโครงการอย่างเป็นทางการหรือติดตั้งแพคเกจ Python จากแหล่งแพคเกจที่เผยแพร่ หากคุณดาวน์โหลดไบนารีแบบแยกต่างหากเปรียบเทียบ SHA-256 กับชื่อไฟล์ที่ตรงกับใน SHA2-256SUMS ของเวอร์ชันนั้น บันทึกการปล่อยและตรวจสอบด้วยภาพของพนักงานของคุณเพื่อให้คุณสามารถระบุสิ่งที่ทํางานได้อย่างแม่นยํา

Hash the ดาวน์โหลดไฟล์
sha256sum yt-dlp

การเปรียบเทียบค่าตรวจสอบจะใช้ได้เฉพาะเมื่อค่าที่คาดหวังมาจากการปล่อยที่เชื่อถือได้ไม่ใช่กระจกที่ไม่รู้จักเดียวกันกับค่าที่สามารถดําเนินการได้ หากซอฟต์แวร์ความปลอดภัยเป็นไฟล์ตรวจสอบแหล่งและรายงานก่อนที่จะทําข้อจํากัด การมีข้อมูลที่มีอยู่ด้วยแหล่งที่มาเปิดเท่านั้นไม่ใช่หลักฐานว่าปลั๊กอินไบนาหรือบุคคลที่สามใด ๆ ที่ดาวน์โหลดจะปลอดภัย

การจัดการไฟล์การกําหนดค่าที่แบ่งปันเป็นรหัสเพื่อตรวจสอบ: ตัวเลือกเช่น --exec สามารถเปิดตัวคําสั่งและปลั๊กอินเพิ่มรหัสไปยังกระบวนการดาวน์โหลด ปรับปรุงคุกกี้เบราว์เซอร์, การรับรองโปรกซี่และ URL ที่ลงทะเบียนออกจากตัวอย่างการกําหนดค่าและรายงานวินิจฉัย

ดาวน์โหลดวิดีโอ

ใช้วิดีโอสั้น ๆ ก่อน ระบุ URL เพิ่ม --no-playlist และระบุไฟล์โดย ID วิดีโอ คําสั่งพิมพ์เส้นทางสุดท้ายหลังจากผสมและหลังการประมวลผล

วิดีโอเดียวโฟลเดอร์ออก
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -P downloads \
  -o "%(id)s.%(ext)s" --print after_move:filepath \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
เส้นทางพิมพ์คือไฟล์หลังจากผสมและหลังการประมวลผล เปิดเส้นทางนี้ อย่าคิดว่าไฟล์จะสิ้นสุดลงใน .mp4

ไม่มีรูปแบบที่เกินไป yt-dlp เลือกการไหลที่มีความต้องการ แหล่งที่มีคุณภาพสูงมักจะมีวิดีโอและเสียงที่แยกต่างหากดังนั้นการถ่ายโอนสองครั้งที่ติดตามโดยการผสมผสานของ FFmpeg เป็นปกติ ไฟล์กลางและไฟล์ .part อาจปรากฏในขณะที่งานจะทํางาน

เลือกคุณภาพและโค้ด

ตรวจสอบรูปแบบวิดีโอนี้
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  -F "https://www.youtube.com/watch?v=jNQXAC9IVRw"

เลือกนโยบายไม่ใช่ ID รูปแบบที่คัดลอก ตรวจสอบความละเอียดการเข้ารหัสและติดตามที่แยก audio/video ID รูปแบบสามารถแตกต่างกันระหว่างแหล่งข้อมูล

ตัวเลือกหรือตัวเลือกหมายความว่าเมื่อใช้
บีวี + บีวีเลือกวิดีโอเพียงการไหลและเสียงเพียงการไหล FFmpeg รวมพวกเขาคุณต้องการทั้งสองเส้นและสามารถผสมผสานในท้องถิ่น
A/Bลองตัวเลือก A แล้ว B ถ้า A ไม่ได้ใช้ได้กําหนดการลดลงอย่างชัดเจนแทนที่จะคิดว่าแหล่งแต่ละแหล่งมีรูปแบบเดียวกัน
[height<=1080]ปล่อยให้มีการไหลสูงกว่า 1080 พิกเซลการเชื่อมต่อที่แข็งขึ้นเป็นข้อกําหนด
-S res:1080ความละเอียดที่ต้องการขึ้นไป 1080 คุณสามารถเลือกหนึ่งที่ใหญ่กว่าเมื่อไม่มีที่อยู่ด้านล่าง1080p เป็นความต้องการมากกว่าเพดานที่แข็ง
--merge-output-format mp4เลือกภาชนะเมื่อรวมกระแสแยกคุณได้เลือกการไหลที่เข้ากันได้ มันไม่สามารถรหัสผ่าน
ปกป้องรหัสแหล่งข้อมูลด้วยหลังคาที่แข็ง 1080p
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  -f "bv*[height<=1080]+ba/b[height<=1080]" -P downloads \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
นี้สามารถผลิต WebM, MP4 หรือคอนเทนเนอร์ที่สนับสนุนอื่น ๆ มันไม่ประสบความสําเร็จถ้าไม่มีรูปแบบที่ตรงกับเพดานมันไม่ดาวน์โหลดอย่างเงียบ 4K

สําหรับเครื่องแก้ไขหรือเครื่องเล่นที่ต้องการวิดีโอ H.264 และเสียง AAC กรองโค้ดเหล่านี้และผสมกับ MP4 MP4 เป็นภาชนะ: ระหว่างในภาชนะ MP4 สามารถยังคงมีตัวเข้ารหัสโปรแกรมของคุณไม่สามารถ decode

คําขอ H.264 + AAC, จนถึง 1080p
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 -P downloads "https://www.youtube.com/watch?v=jNQXAC9IVRw"
หากคดเคกที่ต้องการไม่สามารถใช้ได้ตัวเลือกที่เข้มงวดนี้จะผิดพลาด การตัดสินใจว่าจะยอมรับคดเคกแหล่งที่มาหรือ transcode ใด ๆ ไม่ต้องลบข้อกําหนดโดยการฉุกเฉิน

Remuxing ระบายน้ําไหลโดยไม่ต้องรหัสใหม่ การแปลงการเปลี่ยนแปลงของตัวเข้ารหัสและใช้ CPU ในขณะที่อาจเปลี่ยนคุณภาพ ใช้ --remux-video เมื่อการไหลจะเข้ากับภาชนะเป้าหมายแล้ว ใช้การแปลง FFmpeg ที่จะถูกนํามาใช้เมื่อ decoder downstream ต้องใช้ codecs อื่น ๆ

การบันทึกเสียงหรือ MP3

หากท่อการถ่ายโอนของคุณยอมรับรหัสเสียงแหล่งที่มาดาวน์โหลดการไหลโดยตรง นี่จะหลีกเลี่ยงการแปลงที่ขาดทุนที่ไม่จําเป็น MP3 เป็นประโยชน์เมื่อผู้บริโภคต้องการอย่างเฉพาะเจาะจง; ระดับสูง MP3 ไม่สามารถกู้คืนรายละเอียดที่หายไปในแหล่งข้อมูล

รักษาเสียงที่ดีที่สุดที่พร้อมใช้งาน
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"
รอตู้แหล่งและโค้ดทั่วไป M4A/AAC หรือ WebM/Opus.
แปลงเสียงเป็น MP3
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -f ba -x \
  --audio-format mp3 --audio-quality 0 -P audio -o "%(id)s.%(ext)s" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
ต้องใช้ FFmpeg --audio-quality 0 เลือกการตั้งค่าคุณภาพตัวเลือกที่ดีที่สุดของคุณ ใช้อัตราบิตเช่น 192K เมื่อคุณต้องการการกําหนดค่า downstream ของคุณ

การบันทึก captions และ metadata

การเก็บรวบรวมที่มีประโยชน์ต้องการมากกว่าชื่อ filenames เก็บ ID วิดีโอ URL หลักชื่อระยะเวลาและตัวอักษรที่มีอยู่เพื่อให้คุณสามารถค้นหาการเก็บรวบรวมและติดตามสินทรัพย์กลับไปยังแหล่งของมัน เริ่มต้นโดยการจัดอันดับเส้นทางของบันทึก; การขอ en ไม่หมายความว่าวิดีโอแต่ละคนมีเส้นทางภาษาอังกฤษ

ตรวจสอบการจับภาพแล้วบันทึกการติดตามภาษาอังกฤษโดยไม่ต้องสื่อ
python -m yt_dlp --list-subs "https://www.youtube.com/watch?v=jNQXAC9IVRw"
python -m yt_dlp --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"
--write-subs เลือกหัวข้อที่จัดหา --write-auto-subs นอกจากนี้ยังอนุญาตให้การจับภาพอัตโนมัติ ซึ่งจะรับติดตามที่มีอยู่และไม่ส่งวิดีโอที่มีไม่มี
Media ด้วยข้อมูลโลหะและขนาดเล็ก
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist --write-info-json \
  --write-thumbnail -P downloads -o "%(id)s.%(ext)s" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"

ไฟล์ .info.json เป็นข้อมูลการดําเนินงานรายละเอียดและไม่ใช่การตอบสนอง API สาธารณะที่สะอาด มันสามารถรวมถึง URL ของสื่อที่หมดอายุและฟิลด์ที่เกี่ยวข้องกับคําขอ ปกป้องหน้าจอด้านบนเต็มรูปแบบพร้อมกับการเก็บรวบรวมและส่งออกเพียงฟิลด์ที่ระบบ Downstream ของคุณต้องการ หากคุณต้องการ SRT แทน VTT เพิ่ม --convert-subs srt และให้แน่ใจ FFmpeg มี

สร้างรายการ AI Dataset

สําหรับการฝึกอบรมตัดสินใจเกี่ยวกับสื่อและข้อความออกจากกัน ข้อกําหนดทั่วไปคือวิดีโอและเสียงที่ดีที่สุดที่มีอยู่รวมเป็น MP4 กับการจับภาพและข้อมูลการสกัดที่กําหนดเองที่เก็บไว้ภายใต้ ID วิดีโอเดียวกัน พื้นที่การแก้ปัญหาที่ใช้งานได้สําหรับการตรวจสอบเป็นข้อกําหนดที่ผิดปกติสําหรับชุดข้อมูลที่มีคุณภาพแหล่งข้อมูล

ดาวน์โหลดรายการชุดข้อมูลทั้งหมด
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" \
  --print after_move:filepath "https://www.youtube.com/watch?v=jNQXAC9IVRw"
ตัวอย่าง Bash. FFmpeg รวมการไหลแยกต่างหาก; --remux-video ยังครอบคลุมการไหลรวม. ใช้แท็กภาษาที่ถูกต้องจาก --list-subs; เปลี่ยน en กับภาษาที่คุณต้องการชุดข้อมูล.

เริ่มต้นด้วยภาษาที่ถูกต้อง ในการตรวจสอบสดของเรา, en.* เลือก en, en-en และ en-de; ระยะทางที่สามกลับ 429 ก่อนที่จะเริ่มดาวน์โหลดสื่อ ข้อผิดพลาดการเขียนสามารถหยุดรายการในขั้นตอนนี้ หลังจากที่การเย็น, ถอนเส้นทางที่ต้องการเท่านั้น, หรือแบ่งสื่อและงานบันทึกถ้าการเก็บรวบรวมของคุณต้องรักษาการเข้าถึงสื่อเคลื่อนไหว.

การ / ดีที่สุด Fallback ช่วยให้มีการไหลรวม video/audio เมื่อเส้นทางแยกต่างหากไม่สามารถใช้ได้ ลบการลบนี้หากสัญญาการเก็บรวบรวมของคุณต้องการแหล่งข้อมูล bestvideo และ bestaudio ที่แยกต่างหาก MP4 ไม่หมายความ H.264: สูตรนี้เก็บรหัสแหล่งที่เลือก ใช้ตัวเลือกที่เข้มงวด H.264/AAC ด้านบนถ้าการฝึกอบรมของคุณ decoder ต้องการ codecs หรือ transcode เป็นขั้นตอนที่แยกออกบันทึก

ไฟล์ที่คาดหวังเมื่อมี track ภาษาอังกฤษ
dataset/VIDEO_ID/
  VIDEO_ID.mp4
  VIDEO_ID.info.json
  VIDEO_ID.en.vtt
ปลั๊กอินชื่อเสียงใช้แท็กภาษาจริง ไม่มีไฟล์ชื่อเสียงจะถูกสร้างขึ้นเมื่อติดตามที่ขอไม่ได้มีอยู่ อย่าระบุการครอบคลุมข้อความเสร็จสิ้นเพียงเพราะ MP4 หมดอายุ
เงื่อนไขการตัดสินใจเก็บ
คุณภาพแหล่งที่มาที่มีอยู่สูงสุดใช้ bestvideo + bestaudio, บันทึกรหัสแหล่งและตรวจสอบการไหลผสมด้วย ffprobe
ภาษาไทยปกป้องเซ็กซ์และภาษา VTT/SRT พร้อมกับ ID วิดีโอ การแสดงข้อความแบบเรียบจะแสดงให้เห็นถึงเวลาที่จําเป็นสําหรับการปรับแต่งคลิป
ไม่มีคำอธิบายภาพบันทึกข้อความที่หายไปอย่างชัดเจน หมายเลขเสียงที่บันทึกไว้ไปยังขั้นตอนการแปลของคุณหากข้อความเป็นสิ่งจําเป็น
การรับรองสําหรับหลายภาษาคําถามเฉพาะภาษาที่ต้องการ สารสถักเพิ่มเติมแต่ละครั้งเพิ่มคําขอและสามารถพบ 429 โดยไม่คํานึงถึงสื่อ
การส่งข้อความ + การส่งข้อความใช้ไฟล์ไฟล์ชุดข้อมูลที่แยกและสํารองข้อมูลที่มีสถานการณ์สื่อ metadata และ caption หนึ่งรายการไฟล์ไม่สามารถพิสูจน์ให้เห็นว่าทุกหน้าที่จําเป็นมีอยู่

อย่าใช้ไฟล์ที่สร้างขึ้นโดยสื่อก่อนหน้านี้เท่านั้นสําหรับการใช้งานนโยบายใหม่นี้: วิดีโอที่เก็บไว้อาจถูกลบก่อนการเก็บรวบรวมภาพถ่ายที่หายไป หรือดําเนินการนโยบายชุดข้อมูลด้วยเอกสารของตัวเองหรือวางแผนการแก้ไขข้อความที่แยกต่างหากสําหรับ IDs ที่ขาดข้อความ เก็บแคปซูลเดิม หากรูปแบบของคุณต้องการข้อความที่สะอาดโปรดสอดคล้องให้ทําตามขั้นตอนการประมวลผลที่ได้รับการแก้ไข

ปรับปรุงการส่งผ่านการส่งผ่านโดยไม่ต้องกังวล IP

aria2c สามารถช่วยเมื่อการเชื่อมต่อเดียวจะนําไปสู่การเชื่อมต่อที่ไม่น่าเชื่อถือหรือความช้าสูง มันไม่สามารถแก้ไขคําขอผู้เล่นที่ปฏิเสธหรือ IP ออกแบบ ก่อนอื่นทําให้ดาวน์โหลดที่บ้านทํางานบนแหล่งเดียว จากนั้นเปรียบเทียบเวลาการถ่ายโอนและข้อผิดพลาดกับจํานวนเล็ก ๆ ของการเชื่อมต่อ aria2

เริ่มต้นด้วยสองเชื่อมต่อต่อ HTTP การถ่ายโอน
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 -o "%(id)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"
ติดตั้ง aria2 ก่อนหน้านี้ ปล่อยให้ DASH/HLS กับดาวน์โหลดที่บ้านที่นี่เพื่อให้การแข่งขันส่วนที่อยู่ชัดเจน
การควบคุมสิ่งที่ จํากัด
aria2c -x 2การเชื่อมต่อกับเซิร์ฟเวอร์เดียวสําหรับการดาวน์โหลด
aria2c -s 2การแบ่งที่ต้องการสําหรับไฟล์เดียว การแบ่งขึ้นอยู่กับขนาดไฟล์และสนับสนุนเซิร์ฟเวอร์
aria2c -j 1รายการที่เกี่ยวข้องภายใน aria2 การเรียกใช้, ไม่ใช่คนอื่น yt-dlp
--concurrent-fragments 1Fragment ดาวน์โหลดภายในดาวน์โหลด native DASH/HLS
งานของคุณ Queueวิดีโอที่ใช้งานทั้งหมดแบ่งปันโฮสต์เดียวกันหรือ IP ออกแบบโปรกซี่

curl-cffi การกําหนดเองเป็นของคําขอของ yt-dlp มันไม่กําหนดตัวอักษรของ aria2 TLS หากดาวน์โหลดที่บ้านทํางาน แต่ aria2 ได้รับ 403 กลับไปที่ที่บ้านก่อนที่จะเปลี่ยนการตั้งค่าเครื่องประดับที่ไม่เกี่ยวข้อง ปกป้องการสกัดและการถ่ายโอนภายนอกในเซสชั่น proxy ที่เดียวกัน

ในการทํางานของ FlashData การเพิ่มความแข่งขันอย่างรุนแรงเกินไปสามารถทําให้เส้นทางทํางานเริ่มกลับ 403 ทันที หากสิ่งนี้เกิดขึ้นหยุดงานอื่น ๆ ไปกลับไปยังคนหนึ่งและเชื่อมต่อหนึ่งแล้วทดสอบ อย่าตอบแทนโดยเพิ่ม aria2 ส่วนแบ่งมากขึ้นหรือยึดกลับของกระแสที่ปฏิเสธเดียวกันใน parallel หาก IP ที่ยังคงถูกปฏิเสธในโหลดต่ําใช้การทํางานของ IP ที่เปลี่ยน 403

การถ่ายโอนชาวบ้านที่รักษารวมสําหรับเปรียบเทียบ
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  --downloader native --concurrent-fragments 1 --limit-rate 2M \
  --sleep-requests 2 --sleep-interval 5 --max-sleep-interval 10 \
  -P diagnostics "https://www.youtube.com/watch?v=jNQXAC9IVRw"
2M เป็นสายเคเบิลแบนด์วิดธ์วินิจฉัยไม่ได้เป็นข้อ จํากัด ของ YouTube ระยะทางเพิ่มขึ้นเพียงหลังจากที่เส้นทางทํางาน

การจัดเก็บ

สําหรับชุดที่รู้จักเล็ก ๆ สร้าง UTF-8 urls.txt ด้วย URL ที่ดูหนึ่งต่อเส้น สําหรับรายการการเล่น YouTube ก่อนอื่นระบุ ID ของมันเป็นตัวอักษร การสกัดแบบแบนตรวจสอบรายการการเล่นโดยไม่ต้องทําการสกัดเต็มสําหรับแต่ละวิดีโอ มันเป็นประโยชน์สําหรับการตรวจสอบช่วง แต่รายการของมันอาจขาดระยะเวลารูปแบบและรายละเอียดความพร้อมใช้งาน

สร้างรายการเล่น YouTube Manifesto
python -m yt_dlp --flat-playlist --print "https://www.youtube.com/watch?v=%(id)s" \
  "https://www.youtube.com/playlist?list=YOUR_PLAYLIST_ID" > urls.txt
แทน YOUR_PLAYLIST_ID ตรวจสอบ urls.txt ก่อนที่จะเริ่มการถ่ายโอนสื่อ การนําทางใหม่จะแทนที่ตัวอักษรนี้หากคุณเรียกใช้มันอีกครั้ง

เพื่อทดสอบการเก็บรวบรวมช็อตเลือกรายการรายการเล่นหลายรายการที่มี --playlist-items 1:5 บัตร / วิดีโอของช่องเป็นจุดเริ่มต้นที่ชัดเจนมากขึ้นสําหรับวิดีโอที่อัพโหลดกว่าหน้าแรกช่องที่ไม่เห็นได้ชัด อย่าใช้คําสั่งซื้อรายการเล่นเป็นความระบุตัวตน: รายการสามารถใส่ใหม่หรือลบได้

ฟิล์มใช้ผลกระทบ
--playlist-items 1:55 รายการแรกในรายการปัจจุบันมีประโยชน์สําหรับการทดสอบขนาดเล็กไม่ใช่จุดตรวจสอบที่ทนทาน
--dateafter 20260101ปล่อยให้เข้าสู่ระบบที่วันที่หรือหลังเดือนกุมภาพันธ์ 1, 2026การกรองวันที่อาจต้องใช้การสกัดต่อวิดีโอ
--match-filters "!is_live & duration <= 1800"ต้องการรายการที่ไม่สดที่มีระยะเวลาที่รู้จักในเวลาสูงสุด 30 นาทีการเข้าสู่ระบบที่มีระยะเวลาที่ไม่รู้จักไม่ตรงกับกรองที่เข้มงวดนี้
--download-archive archive.txtSkip IDs ที่บันทึกไว้แล้วโดยการดาวน์โหลดก่อนหน้านี้ทํางานผ่านชื่อที่เปลี่ยนแปลงและตําแหน่ง playlist

การจัดเก็บข้อมูลได้อย่างปลอดภัย

เก็บต่อไปนี้เป็น yt-dlp-work.conf ในโฟลเดอร์การเก็บข้อมูลของคุณนอกเหนือจาก urls.txt มันกําหนดนโยบายการผลิตครั้งเดียวให้เก็บรวบรวมของตัวเองและ จํากัด retries บันทึกไฟล์ออกและไฟล์นี้พร้อมกัน: ไฟล์บันทึกความสําเร็จโดยผู้สกัดและ ID ไม่ได้โดยจํานวนการตรวจสอบหรือสถานที่ของไฟล์ปัจจุบัน

yt-dlp-work.conf
# YouTube worker baseline
--js-runtimes deno
--impersonate=""
--concurrent-fragments 1

# Output policy
--no-playlist
-f "bv*[height<=1080]+ba/b[height<=1080]"
-P downloads
-o "%(channel_id)s/%(id)s.%(ext)s"
--write-info-json

# Resume and remember completed media
--continue
--download-archive archive.txt
--no-abort-on-error

# Bound each attempt and spread out work
--retries 5
--fragment-retries 5
--socket-timeout 30
--sleep-requests 1
--sleep-interval 5
--max-sleep-interval 10

# Append paths only after the final move
--print-to-file after_move:filepath completed-paths.txt
การกําหนดค่าข้อความเรียบ, ตัวเลือกหนึ่งต่อเส้น ขั้นตอนในตัวอย่างนี้เป็นเรื่องเกี่ยวกับแผนที่ทํางาน ใช้เส้นทางที่สมบูรณ์เมื่อโปรแกรมเริ่มต้นที่อื่น ๆ
การดําเนินการการเก็บรวบรวม
python -m yt_dlp --ignore-config --config-locations yt-dlp-work.conf --batch-file urls.txt
--ignore-config จะลบการกําหนดค่า user/system ระบุไว้ และไฟล์ --config-locations ที่จัดหาอย่างชัดเจนยังคงโหลด

ทํางานตามคําสั่งเดียวกันหลังจากหยุด ID ที่เสร็จสิ้นจะถูกลบและการถ่ายโอนส่วนที่สามารถเรียกคืนได้ยังคงอยู่ที่ได้รับการสนับสนุน ความผิดพลาดในการสกัดสามารถแก้ไขได้ในขั้นตอนต่อไป ไฟล์ส่วนที่กําหนดเองเป็นสถานะที่เป็นประโยชน์ อย่าลบพวกเขาเป็นขั้นตอนการคืนเงินแบบปกติ

--no-abort-on-error ยังคงผ่านการเข้าถึงที่ไม่สามารถใช้ได้ แต่การทํางานยังคงสามารถออกจาก nonzero และข้อผิดพลาดหลังการประมวลผลต้องระวัง อย่าเพิ่ม --ignore-errors เพียงแค่เพื่อให้ได้งานสีเขียว: มันสามารถรักษาความผิดพลาดหลังการประมวลผลเป็นดาวน์โหลดที่ประสบความสําเร็จ ตรวจสอบรายงานและผลลัพธ์ที่เสร็จสิ้นก่อนประกาศการเก็บรวบรวมเสร็จสิ้น

ตรวจสอบไฟล์เสร็จสิ้น

ไฟล์ completed-paths.txt เป็นข้อมูลเริ่มต้นที่ใช้งานได้ การทดสอบผลสุดท้ายจริงแทนที่จะเป็นวิดีโอเพียงการไหลในเวลา ffprobe อ่านคอนเทนเนอร์และข้อมูลโลหะการไหล; การเข้ารหัสผ่านแยกต่างหากจะจับปัญหาที่หัวที่สามารถอ่านได้เท่านั้นจะหายไป

ตรวจสอบไฟล์เสร็จสิ้น
ffprobe -v error -show_entries format=duration,size:stream=codec_type,codec_name,width,height -of json "downloads/CHANNEL_ID/VIDEO_ID.mp4"
เปลี่ยนเส้นทางด้วยหนึ่งจาก completed-paths.txt ตรวจสอบระยะเวลาที่คาดหวังการไหล audio/video ที่จําเป็นและโค้ดที่เข้ากันได้กับตัวทําความสะอาด
การตรวจสอบการตกแต่งเต็มรูปแบบ
ffmpeg -v error -i "downloads/CHANNEL_ID/VIDEO_ID.mp4" -f null -
อ่านและ decode the whole file without creating a new media output. ตรวจสอบสถานะออกเช่นเดียวกับข้อความ; นี้ใช้เวลานานกว่า ffprobe.
ค้นหาวิธีแก้ไข
เท่านั้นไฟล์ .part หรือไฟล์ Stream ส่วนที่แยกอยู่ตรวจสอบข้อผิดพลาด transfer/merge และรีไซเคิลงานเดิม อย่าลบไฟล์แบบกลางที่สมบูรณ์
วิดีโอเล่นโดยไม่มีเสียงตรวจสอบรูปแบบที่เลือกและ ffprobe Streams รูปแบบวิดีโอเท่านั้นต้องเลือกเสียงและผสม
MP4 จะไม่เปิดในตัวแก้ไขของคุณตรวจสอบโค้ดไม่เพียง แต่การขยายตัว เลือกสตรีมที่เข้ากันได้หรือ transcode ระบุอย่างชัดเจน
ไฟล์ที่เก็บไว้ แต่ไม่มีไฟล์ในท้องถิ่นตรวจสอบว่าไฟล์คือ moved/deleted. คอมเพลิดเพลินกับสํารองข้อมูลก่อนที่จะเปลี่ยนรายการของไฟล์

9 การย้ายคําสั่งที่ได้รับการพิสูจน์ไปยังงานที่วางแผน

การดําเนินการคําสั่งทั้งหมดอย่างประสบความสําเร็จด้วยมือก่อนที่จะวางแผน บันทึกทั่วไปเริ่มต้นด้วย PATH และไดเรกทอรีทํางานที่แตกต่างกัน ให้มันเส้นทาง Python เต็มของสภาพแวดล้อมเสมือนเส้นทางการกําหนดค่าเต็มและไดเรกทอรีทํางานที่ชัดเจน นอกจากนี้ยังให้ FFmpeg และเวลาทํางานของ JavaScript มีสําหรับกระบวนการนี้

  • ใช้คนเดียวสําหรับ collection/archive. อย่าปล่อยให้การทํางานของวันอาทิตย์เกินไปการทํางานของวันนี้กับผลลัพธ์เดียวกัน
  • ใน Linux ใช้ timer/service หรือ cron entry ด้วย directory และ lock เช่น flock ปล่อยบันทึกนอกโฟลเดอร์สื่อและหมุนพวกเขา
  • ใน macOS ใช้การเปิดตัวพร้อมเส้นทางที่สามารถดําเนินการได้และทํางานได้
  • ใน Windows Task Scheduler, ปรับแต่งโปรแกรมเพื่อสภาพแวดล้อม python.exe, Arguments to -m yt_dlp และตัวเลือกการกําหนดค่าและชุดและเริ่มต้นไปที่โฟลเดอร์การเก็บรวบรวม
  • ระยะเวลาบันทึก start/end รุ่นที่สามารถดําเนินการได้ปรากฏตัวของแหล่งข้อมูลสถานะออกและ completed/failed ค่าใช้จ่าย การออกแบบไม่ Zero ไม่หมายความว่ารายการใด ๆ จะล้มเหลว
  • เก็บไฟล์คุกกี้และใบรับรองปลายทางออกจากกล่องเก็บข้อมูลการกําหนดค่าที่แบ่งปัน ให้งานเพียงใบรับรองที่ต้องการ

ตัวเลือกนอนใน config จะทํางานภายในกระบวนการเดียว 10 คนที่ใช้การตั้งค่าเดียวกันยังคงผลิต 10 กระแสคําขอที่ผ่านการกระแทก เพิ่ม --concurrent-fragments เปลี่ยนความแข่งขันของ fragments ในภายในการดาวน์โหลดไม่ใช่จํานวนวิดีโอในแถบงานของคุณ

เลือกคู่มือข้อผิดพลาดที่เหมาะสม

ปรับปรุงสภาพแวดล้อม Python
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
python -m yt_dlp --version

เมื่อแหล่งที่ทํางานก่อนหน้านี้แตกแล้วปรับปรุงให้เร็วที่สุดคืนแรกรวมถึงสารเติมแต่งที่ตรงกัน สําหรับการใช้งานไบนารีแบบแยกต่างหาก yt-dlp --update-to ในตอนเย็น -U เท่านั้นอยู่บนช่องปัจจุบัน การทํางานในช่องว่างเล็ก ๆ หลังจากปรับปรุงแต่ละครั้งแล้วสร้างขึ้นใหม่ของพนักงานและบันทึกการแก้ไขเพื่อให้เรือไม่ผสมตัวอย่างอย่างเงียบสงบ

Sumpotomเริ่มที่นี่
Requested format is not availableรายการรูปแบบและตรวจสอบกรองที่เข้มงวดของคุณก่อนที่จะเปลี่ยนการถอน
ffmpeg not found / ffprobe and ffmpeg not foundตรวจสอบ PATH จากบัญชีผู้ทํางานหรือชาร์จจริง
การท้าทาย JavaScript / การแจ้งเตือนการทํางานที่หายไปตรวจสอบการตรวจจับเวลาทํางานและแพคเกจ EJS ที่ตรงกันข้าม
HTTP 403 ในระหว่างการถ่ายโอนการระบุผู้เข้าพักที่ปฏิเสธและสถานการณ์แยกจากการถ่ายโอนสื่อ
HTTP 429ปิด IP ที่ได้รับผลกระทบให้มีการคูลดอนและอัตราการร้องขอต่ํากว่า extraction/caption
Sign in to confirm you’re not a botปิดชุดและวินิจฉัยแหล่งหนึ่งเซสชั่นและเครือข่าย

เมื่อการผลิตอยู่ในท่อคลาวด์

หากคุณต้องการเป็นเจ้าของดาวน์โหลดแล้วการทํางานที่ด้านบนจะช่วยให้คุณสามารถควบคุมไฟล์รูปแบบและประมวลผลได้ หากแอพของคุณต้องการสื่อที่เสร็จสิ้นที่ส่งไปยังจัดเก็บ FlashData ให้การติดตาม YouTube ดาวน์โหลดงานการจัดการ bot, การนําทางโปรกซี่และ retries การสมัครของคุณส่งการตั้งค่าแหล่งและผลผลิตแล้วเก็บรหัสการทํางานและบันทึกการจัดส่ง

วัสดุการอ้างอิง

ตัวเลือก upstream เป็นแหล่งที่มาของความจริงสําหรับรุ่นที่ติดตั้งของคุณ ใช้ส่วนเหล่านี้เมื่อเปลี่ยนนโยบายการเก็บรวบรวมหรืออัปเดตภาพของผู้ทํางาน