🚨[IMPORTANT]🚨 KNOWN ISSUES/FAQ

[pukkandan]

Some known common issues. Make sure to always check this before opening issues. Duplicates of these will be strictly treated as spam!

High priority issues

• [TikTok] Failed to parse JSON/ No video formats found #9506

Recently solved bugs

Use Nightly or Master builds, pip install from master, or wait for release

• [crunchyroll] stream info HTTP Error 403 (even with cookies+user-agent/impersonation) #9745
• Crunchyroll vo_adaptive_hls No Video Formats Found #9453
• [crunchyroll] Error 403 Forbidden for all URLs #7442

Update to latest version

• [youtube] YouTube said: ERROR - Precondition check failed - HTTP Error 400: Bad Request #9316
• kick.com videos - HTTP Error 403: Forbidden #6748
• Intermittent "Incomplete data received" errors when downloading YouTube playlist JSON #8206
• [Youtube] Unable to extract uploader id #6247

Bugs

• YouTube: Skipping player responses from android clients (got player responses for video "aQvGIIdgFDM" instead of "BaW_jenozKc") #9554
  • The warning can be ignored, or pass --extractor-args "youtube:player_client=ios,web"
• Youtube cookies expire within hours #8227
  • Workarounds
• [YouTube] comments are not downloading #9358
• [twitch] Cannot download more than 100 VODs from a channel when providing a /channel/videos URL #7058
  • Do not pass cookies to yt-dlp
• [facebook] Cannot parse data #4311
• [tiktok:user] Failed to parse JSON #3776
• Instagram User - Unable to Extract #4394
• [instagram] "General metadata extraction failed" / extractor needs better fallback(s) #7165
• Instagram: Can't download public Reel, "Unable to extract username" #5967
• --ap-mso DTV Broken: Unable to extract post url #2188
• [ytmusic] Parse metadata from music.youtube.com #622 / [Youtube] Can't download "Music Charts" at format 141 #5546
  • Metadata from youtube.com is used for ytmusic
• Twitch live streams have out of sync audio and lowered pitch #4280
  • Use --fixup never
• Cannot download video from udemy #1164
• --trim-filenames fails to clip file name properly when there is a dot in a video title #2314
  • Use -o %(title).200B.%(ext)s
• [teachable] ERROR: Unable to find Video URL https://edu.ecomsuccess.pk/courses/enrolled/903296 #3564
• Unicode "|" character is being replaced in filenames on filesystems that support it  #4547
• CeskaTelevize broken #6539
• iQIYI extractor can't find any video #2740
• [Viu] URLs are using generic extractor instead of Viu extractor #6482
• [Ixigua] ERROR: Failed to get SSR_HYDRATED_DATA #5374
• Douyin always errors saying fresh cookies are needed, even when passing them #9667

External issues

• [Discord bot] Music stops in the middle #8854
• 2024.04.09 YouTube: ERROR: unable to download video data: HTTP Error 403: Forbidden #7860
  • Your IP has been blocked from being granted valid video URLs by Youtube.
  • Passing logged-in cookies refreshed within the past 30 minutes works around this
• [youtube] Skipping player response / HTTP Error 429: Too Many Requests / Video Not Available #7143
  • Your IP has been blocked by YouTube. Mostly appears to impact DC IPs.
  • Can try --force-ipv6 or --force-ipv4 to switch b/w IPv4 and IPv6 IPs if you have them.
• --cookies-from-browser errors when Chrome/chromium-based browser is open in Windows #7271
  • Try after closing chrome completely OR
  • Launch chrome from command line w/ chrome.exe --disable-features=LockProfileCookieDatabase
  • Alternatively, you can install the ChomeCookieUnlock yt-dlp plugin
• FFMPEG Reports "Invalid data found when processing input" on Youtube Video after postprocessing #8641
  • Regression in ffmpeg 6.1. Upgrade to ffmpeg 6.1.1 or to master build revision N-112916 or later
• ffmpeg cannot properly seek in Youtube's iOS m3u8 streams #7824
  • Use -S proto:https or --extractor-args "youtube:player_client=android,web"
• [Youtube] Did not get any data blocks for format 22 #3372
  • The format is damaged at server-side - select another format
• --mark-watched fails with urlopen error #8149
  • Disable pi-hole or whitelist s.youtube.com
• ERROR: Postprocessing: Conversion failed! (yt_dlp.postprocessor.ffmpeg.FFmpegPostProcessorError) #871
  • It is a bug in ffmpeg. Use https://github.com/yt-dlp/FFmpeg-Builds
• Chapter Embedding Results in Unnamed Chapters When Using Recent FFmpeg Builds #6859
  • ffmpeg regression. Use https://github.com/yt-dlp/FFmpeg-Builds or upgrade to 6.1.1 release
• yt-dlp is detected as a virus #25
  • It's a false positive. Complain to your vendor. There is nothing we can do
• Incomplete Data Recieved #1787
  • Broken from Youtube's side. If downloading comments, use -i to ignore the error
• Wrong year in metadata in M4A, MP4, FLAC format #3087
  • Workaround: --parse-metadata "%(release_year,upload_date).4s:(?P<meta_date>.+)"
• No package metadata was found for yt-dlp #5941
  • pip install -U setuptools wheel

FAQ

See https://github.com/yt-dlp/yt-dlp/wiki/FAQ

• Filename too long
  • -o %(title).200B.%(ext)s
• [Question] odd ba* format selection? #979 (comment)
  • Generally do not use ba*
• Fix playlist_index's inconsistent behavior #302
  • Check playlist_autonumber and --compat-option playlist-index
• yt-dlp python module not compiling with pyinstaller #3845
  • Use pyinst.py
• Subtitle file is not deleted after being embedded #630 (comment)
  • Use --compat-option no-keep-subs
• --download-sections/--sponsorblock-remove does not cut at exact point #4216 / YouTube Clip Downloads have unintented extra beginning part with no video #5080
  • Use --force-keyframes-at-cuts
• Duplicating pull request from youtube-dl to yt-dlp #4202
• How to check in browser if the video is DRM protected
• --cookies-from-browser for a chrome/firefox like browser or non-default install location #2903
• What are yt-dlp's error codes? #4262 (comment)
• Extractor option language for crunchyrollbeta #4640
• Ability to strip Emoji from downloaded file  #4836 / File names use "full-width" special characters: '？' vs '?' #5014
• [Youtube] Extract exact timestamps #1803
• [Feature Request] Crop to square thumbnail when embedding in MP3s #429
• Download only videos with subtitles
  • --parse-metadata "%(subtitles.\:.0.ext|)s:^(?!\[\])(?P<has_subs>.)" -v --match-filter has_subs
• How do I rename previously-downloaded files with nothing but the youtube video ID? #5692
• Remove specific fields from info-json - [Suggestion] Redact formats in info json with an option #455 (comment)
• About subtitles in mp4 container - Convert webvtt subtitles in mp4 into useable format #5833 (comment)
• Find the API option for a CLI argument #5859 (comment)
  • Use https://github.com/yt-dlp/yt-dlp/blob/master/devscripts/cli_to_api.py
• [YouTube] youtube:skip=translated_subs doesn't work for some videos. #3875
• Youtube bestvideo and vp9 preference. #1232 (comment)
• repo: git log broken by SSH signature #7322
• How to force a conversion to a specific video codec? #7607 (comment)
• How to download youtube videos in mp4 format? #8880

PS: These are just the most common issues at the moment. Make sure to search for duplicates in general before opening issues. Looking at this is not an excuse to not search for other duplicates!