-
Notifications
You must be signed in to change notification settings - Fork 68
Errors
This page contains an overview of all the errors in youtube-dl-gui. Where possible a cause and solution is given as well.
- No authentication
- Members-only content
- Private or non-existent playlist
- Private or removed video
- No connection could be made
- Unable to extract initial data
- Too many requests (429)
- Possible broken extractor (404)
- URL not supported
- Incomplete video ID
- No write permission
- Unable to launch YTDL
- SSL verification failed
- Max fragment retries reached
- Connection timed out
- Connection reset
- File in use by another process
- Unhandled error
Trigger: ERROR: private video || ERROR: This video is only available for registered users
Cause: This error occurs when ytdl tries to download a video that is private and or requires you to be logged in.
Solution: Try authenticating using cookies. For more info about this see the tutorial.
Trigger: ERROR: Join this channel to get access to members-only content
Cause: This error occurs when a video is for members only and thus cannot be accessed without authentication.
Solution: If you are a member of this content creator, try authenticating using cookies. For more info about this see the tutorial.
Trigger: ERROR: The playlist does not exist
Cause: This error occurs when a playlist you are trying to download does not exist or is made private.
Solution: If you are certain the playlist exists you may have to authenticate using cookies. For more info about authentication see the tutorial.
Trigger: metadata.formats is not iterable
Cause: This error occurs when ytdl returns an empty format header. This can mean that the video has not finished processing, is private or may not even exist.
Solution: If you are certain the video exists, wait for the video to finish processing or authenticate using cookies.
Trigger: getaddrinfo failed
Cause: The service you are trying to download from is down. Or your internet/proxy connection may be down.
Solution: Try again at a later time, or fix your connection.
Trigger: ERROR: Unable to extract yt initial data
Cause: At this moment the cause of this error remains unknown. It just happens sometimes and may be a bug of ytdl.
Solution: Try to download the video again, it usually works on the 2nd try.
Trigger: HTTP Error 429
Cause: The service has soft banned or ratelimited you. This can happen when you download too much videos in a short time. The ban usually lasts for no longer than 24 hours.
Solution: Wait for the ban to expire and take it easy next time. If you have a VPN you can also use this to circumvent the ban, although this is not recommended. After all you were softbanned/ratelimited with a reason.
Trigger: HTTP Error 404
Cause: The service you are trying to download from returned a HTTP 404 code. This usually means the extractor ytdl uses for this website is broken.
Solution: Wait for ytdl to fix the broken extractor. This app will automatically update to the latest version of ytdl.
Trigger: Unsupported URL
Cause: The URL you are trying to download is currently not support by ytdl and can't be downloaded as a result.
Solution: If you REALLY feel like ytdl should support the service you are trying to download from, you can open up an issue at their repository.
Trigger: Incomplete YouTube ID
Cause: The URL you are trying to download contains an incomplete video ID.
Solution: Double check the URL and make sure it is correct.
Trigger: unable to open for writing: [Errno 95]
Cause: You do not have write permission for the folder you are trying to download a video to.
Solution: Give yourself write permissions for this folder. Check out this linux tutorial on how to do that.
Trigger: returned an empty object
Cause: You might be missing a dependency that YTDL needs.
Solution: On linux make sure you have python installed. On windows make sure you have the Microsoft Visual C++ 2010 Redistributable Package (x86) installed.
Trigger: SSL: CERTIFICATE_VERIFY_FAILED
Cause: The service you are trying to download from does not have a valid SSL (https) certificate. Or it can't be verified for some reason.
Solution: Try the URL with http instead of https, or wait for the service to restore their SSL (https) certificate.
Trigger: giving up after 10 fragment retries
Cause: The service did not respond with a fragment after 10 tries. A fragment is a part of a video that gets downloaded, after all these fragments are downloaded they get merged into the video. This error happens when YTDL can't download a fragment after 10 tries and it gives up.
Solution: Try again and hope it works this time. This error is mostly caused by an unstable network connection.
Trigger: EOF occurred in violation of protocol
Cause: While setting up a secure SSL connection the connection timed out. Most of the time this is caused by an unstable network.
Solution: Try it again and hope it works this time. Or use http in the URL instead of https.
Trigger: [WinError 10054]
Cause: An unstable network, a server timeout, or a proxy server can cause this error.
Solution: Try it again and hope it works this time. Make sure to disconnect from any proxy servers you are connected to.
Trigger: [WinError 32]
Cause: This can happen if you open a file while it is downloading. It can also happen when a cloud service such as Dropbox or OneDrive is interfering with the file, such as uploading it.
Solution: Download to a folder not synced by a cloud service, or disable the cloud service. Make sure not to open the file until it has been completely downloaded.
Trigger: ERROR:
Cause: An unknown error occurred. To get more info about what went wrong you may click on 'Full error'.
Solution: Report the error to the developer by clicking 'report'.