सामग्री पर जाएँ

yt-dlp errors समझाए गए: हर एक का मतलब और काम करने वाला समाधान

लेखक Tunelio टीमप्रकाशित

YouTube पर yt-dlp की लगभग हर failure की तीन में से एक जड़ है: पुराना build, गायब JavaScript runtime, या ऐसा IP जिस पर YouTube भरोसा नहीं करता। पहले नीचे की तीन commands चलाएँ; ये ज़्यादातर शिकायतें हल कर देती हैं। फिर catalogue में अपना सटीक error message ढूँढें — हर entry में कारण, पहली कोशिश और उस error की पूरी गाइड है।

सार्वभौमिक प्राथमिक उपचार (सबसे पहले यह करें)

yt-dlp -U                                   # या: pip install -U yt-dlp   (distro package महीनों पीछे हैं)
curl -fsSL https://deno.land/install.sh | sh  # JS runtime — 2025 से YouTube के लिए ज़रूरी
yt-dlp -4 --rm-cache-dir -vU "URL"             # IPv4, साफ़ cache, verbose: देखें कहाँ fail होता है

-v output ऊपर से नीचे पढ़ें: debug header version, मिला JS runtime और ffmpeg दिखाता है; पहला WARNING या ERROR बताता है कौन-सा चरण fail हुआ — info request (YouTube ने वीडियो का वर्णन नहीं किया), media download (वर्णन किया पर file देने से मना), या post-processing (ffmpeg)। नीचे का catalogue इसी तरह बँटा है।

Info-चरण errors: YouTube आपसे बात नहीं करेगा

“Sign in to confirm you’re not a bot”

YouTube ने आपकी request को automation माना — data-center या IPv6 पता, PO token नहीं, session नहीं, बहुत ज़्यादा volume। क्रम: अपडेट, JS runtime, -4, फिर private window में spare account की cookies, फिर PO-token provider, फिर residential exit। अकेली cookies कम ही टिकती हैं।

→ पूरी गाइड: “Sign in to confirm you’re not a bot” ठीक करें

“Unable to extract …”, “nsig extraction failed”, “Some formats may be missing”

YouTube ने player code बदला और आपका yt-dlp नया signature हल नहीं कर पाता, या उसे चलाने के लिए JavaScript runtime नहीं है। अपडेट करें (stable न आया हो तो nightly) और Deno लगाएँ; पुराना YTNsigDeno plugin हो तो हटाएँ। पुराने build पर इसे कोई flag ठीक नहीं करता।

→ पूरी गाइड: yt-dlp अपडेट कैसे करें

“Video unavailable”, “Private video”, “HTTP Error 404: Not Found”

वीडियो हट गया, private है, region या member प्रतिबंधित है — या ID में typo। URL browser में जाँचें: वहाँ भी fail हो तो yt-dlp में कुछ मदद नहीं करेगा। download के दौरान 404 का मतलब signed media URL expire हुआ (-c से दोबारा extract करें); playlist में मृत entries skip करने को --ignore-errors जोड़ें।

→ पूरी गाइड: HTTP Error 404 के कारण और समाधान

“Cookies are no longer valid”, “could not find … cookies database”, age-restricted / members-only

session cookies बदलती और expire होती हैं; जिस browser को आप इस्तेमाल करते रहे उससे export की file तुरंत बासी है, और मुख्य account की cookies उसे प्रतिबंधित करवा सकती हैं। spare account की private window से एक बार export करें, बंद करें, --cookies cookies.txt दें। age-gated और members-only वीडियो को उस account की cookies चाहिए जो उन्हें देख सकता है।

→ पूरी गाइड: cookies सुरक्षित export और इस्तेमाल

Media-चरण errors: YouTube ने वीडियो बताया पर file देने से मना

“HTTP Error 403: Forbidden” (अक्सर पहले chunk के बाद)

signed media URL उस client, IP या PO token से मेल नहीं खाता जिसकी YouTube को उम्मीद थी। अपडेट करें और JS runtime लगाएँ, IPv4 force करें, -f से itag force करना बंद करें (-S sorting लें), दूसरा player client आज़माएँ, PO token दें; cookies आख़िर में — वे media 403 पैदा कर सकती हैं। data-center और IPv6 पते इसे कहीं ज़्यादा पाते हैं।

→ पूरी गाइड: 403 Forbidden के कारण और fix क्रम

“Requested format is not available”

force किया itag इस वीडियो के लिए मौजूद नहीं या आपके client के लिए PO token के पीछे है। -F से format देखें, फिर ID की जगह पसंद बताएँ: -S "res:1080,ext:mp4"। 1080p+ पूरी तरह गायब हो तो ffmpeg (merge के लिए) या PO token कारण है।

→ पूरी गाइड: ffmpeg, merging और 1080p क्यों गायब

बहुत धीमे download (कुछ KB/s), रुकना, throttling

throttled speed ग़लत “n” parameter पर YouTube का जवाब है — लगभग हमेशा पुराना build या गायब JS runtime, आपका connection नहीं। पहले अपडेट; फिर fragmented format में --concurrent-fragments 4 मदद करता है। bulk run पर rate-limiting अलग है: sleep flags जोड़ें।

→ पूरी गाइड: yt-dlp अपडेट करना

Proxy errors: “Unable to connect to proxy”, “Missing dependencies for SOCKS support”, proxy से भी bot check

scheme और port जाँचें (remote DNS के लिए socks5h://), SOCKS के लिए yt-dlp[default] लगाएँ, और याद रखें exit की reputation आपके सर्वर जैसी ही score होती है — datacenter proxy वही 403 और bot check विरासत में लेते हैं; residential exit काम करते हैं पर पूरा वीडियो उनसे गुज़रता है।

→ पूरी गाइड: YouTube के ख़िलाफ़ सच में काम करने वाले proxy

Post-processing errors: ffmpeg

“ffmpeg not found”, “You have requested merging … but ffmpeg is not installed”

ffmpeg के बिना yt-dlp चुपचाप सबसे अच्छा single-file format (आमतौर पर 720p) save करता है और MP3 नहीं बना सकता। install करें (apt/brew/winget), नया terminal खोलें, या --ffmpeg-location दें। yt-dlp -v में ffmpeg लाइन जाँचें।

→ पूरी गाइड: ffmpeg install करें और yt-dlp को बताएँ

“Postprocessing: Conversion failed!”, output .mp3 की जगह .webm

corrupt partial download, बहुत पुराना ffmpeg, या ffmpeg बिल्कुल गायब। .part file हटाएँ, दोनों tools अपडेट करें, -x --audio-format mp3 --audio-quality 0 से retry करें — या --audio-format best से मूल Opus/AAC रखें और transcode छोड़ें।

→ पूरी गाइड: yt-dlp से MP3

→ क्या रखें: WebM/Opus, M4A या MP3

Code में errors: Python में DownloadError, जमे async server

yt-dlp failures को yt_dlp.utils.DownloadError में लपेटता है जिसके अंदर मूल संदेश होता है — text पर match करें (“Sign in to confirm”, “HTTP Error 403”, “Private video”)। यह synchronous है और प्रति extraction ~1.2 s CPU लेता है; event loop पर बुलाने से सर्वर जम जाता है — thread pool में चलाएँ और concurrency सीमित रखें।

→ पूरी गाइड: Python से yt-dlp

→ yt-dlp को API के पीछे रखना: self-host बनाम hosted

क्या इसे चलाना सुरक्षित / क़ानूनी भी है?

yt-dlp ख़ुद open source है और official release या pip से सुरक्षित है; Windows build पर antivirus flag PyInstaller के false positive हैं। जोखिम नक़ली download साइटें, मुख्य account की cookies और अविश्वसनीय plugin हैं। क़ानूनी पहलू इस पर निर्भर है कि आप क्या download करते हैं और कहाँ रहते हैं।

→ पूरी गाइड: क्या yt-dlp सुरक्षित है?

ग़लतियाँ जो एक error को स्थायी बना देती हैं

  • bot check या 403 को tight loop में retry करना — IP को हमेशा के लिए flag करवाने का सबसे तेज़ तरीका।
  • सर्वर पर निजी Google account की cookies देना।
  • -S sorting की जगह पुराने tutorial के itag force करना (-f 137+140)।
  • पिछले साल का distro package चलाना और अपडेट की जगह forum पढ़ना।
  • सस्ते data-center proxy घुमाना और अलग reputation की उम्मीद करना।

कब yt-dlp ठीक करना बंद करें

मुट्ठी भर निजी download के लिए प्राथमिक उपचार की commands और ऊपर की गाइड काफ़ी हैं। yt-dlp किसी bot, app या pipeline के अंदर चले तो ऊपर की हर error बार-बार का operations काम बन जाती है — अपडेट, runtime, PO token, cookie rotation, residential proxy, ffmpeg CPU। hosted API हर request पर download URL लौटाता है और यह सब सर्वर-साइड रखता है। Tunelio हमारी अपनी सेवा है; इसे तौलकर पढ़ें। नए account को 100 free credits।

→ yt-dlp का विकल्प: hosted API कब सही है

स्रोत

  • yt-dlp README और wiki — options reference, FAQ, PO token guide, cookies guide।
  • yt-dlp issue tracker — #14680 और #17395 (403), bot-check और nsig thread।
  • हमारे अपने माप (Tunelio extraction fleet, 2026): data-center IP पर challenge दर, IPv6 इनकार, प्रति extraction CPU।
API डॉक्स पढ़ें →100 फ्री क्रेडिट लें

सामान्य सवाल

yt-dlp errors का सबसे आम कारण क्या है?

पुराना build। YouTube हर कुछ हफ़्तों में player बदलता है; एक महीने से पुराना yt-dlp 403, throttling, bot check या गायब format से fail होता है। सबसे पहले अपडेट करें।

yt-dlp laptop पर क्यों चलता है पर सर्वर पर नहीं?

IP reputation: data-center और IPv6 पते संभावित bot माने जाते हैं। पहले IPv4 force करें; काफ़ी न हो तो residential exit या hosted API।

क्या मुझे ffmpeg और Deno चाहिए?

पूरे YouTube support के लिए हाँ: Deno (या Node/Bun) YouTube के JavaScript challenge हल करता है; ffmpeg 1080p+ stream merge करता है और audio convert करता है।

कुछ fail होते ही cookies जोड़ दूँ?

नहीं। cookies सिर्फ़ login-दीवार वाला मामला ठीक करती हैं और media 403 या account पर पाबंदी ला सकती हैं। पहले अपडेट, JS runtime और IPv4; spare account की cookies आख़िर में।

संबंधित गाइड