Troubleshooting downloads

From Ketarin
Jump to: navigation, search

When trying to download files with Ketarin instead with your browser, you may encounter difficulties, as Ketarin behaves a bit differently than a web browser and some websites may try to prevent download tools from downloading files.

Error: Timeouts when downloading

  • Reasons: Most likely due to aggressive connection settings or because download server is offline/inaccessible.
  • Solutions: Adjust connection preferences for Ketarin from FileSettingsConnection. Increase Connection timeout and number of retries and reduce number of threads. Alternatively if download still gets timeout after few days and even with safe connection settings - contact website owner or host or ask for help in Forum. Alternatively try enabling the option "Do not download this application simultaneously with other applications" for this application.

Error: The downloaded file is not a binary file type

  • Reasons: This error can have various reasons. In many cases, it may just indicate a "file not found" error, or the website redirects you back to the download entry page, if it cannot validate that the download originated from the website. In the first case you should check that the file you are trying to download still exists. In the other case, you may be missing an HTTP referer or need to use a different user agent (rare).
  • Solutions: Try setting "Spoof HTTP referer" to an URL of the website you are downloading from, possibly the page which lists the available downloads is required. Try setting the application specific user agent to a commonly used user agent or to something completely random. If you need to add cookies, use the HTTPX protocol. You can be quite sure that cookies are being used, if you can access the download URL directly in your web browser after having visited the website that contains the download link once. If you can only download the file when clicking the download link on the website, and a direct access is never possible, it is likely that referers are being checked.

Error: The format of the URI could not be determined

  • Reasons: The website may have significantly changed it´s layout and if you use a variable such as {version} to insert a version number into the download URL then too much characters may be entered. Please refer to Basics Example 3 how to properly create the {version} variable and have it scan the website for the correct text.
  • Solutions: Open Rightclick EditVariables{version} for the problematic application and select the correct new start and end parameters where to extract the necessary text from. In case if you use Regex code instead of start/end please adjust your code so it works again.

Error: An exception occurred during a WebClient request

  • Reasons: The reason for this error is currently unknown. It could possibly happen if your download speed is slow or the connection is oversaturated.
  • Solutions: Try again later. The error should have resolved itself.

Error: 404 Not Found

  • Reasons: The requested file was not found on the server. This could be because of number of reasons such as the file was deleted/renamed/moved on the server and your download link no longer corresponds to actual file. Also the website may have significantly changed its layout and if you use a variable such as {version} to insert a version number into the download URL then the wrong text is entered. Please refer to Basics Example 3 how to properly create the {version} variable and have it scan the website for the correct text. You may have a simple spelling error where some number/letter is incorrect in your download URL.
  • Solutions: Go to the website and download the file manually. This allows you to capture the new download URL that you can enter into Ketarin. Open Rightclick EditVariables{version} for the problematic application and select the correct new start and end parameters where to extract the necessary text from. In case if you use Regex code instead of start/end please adjust your code so it works again. Check and fix any spelling errors in application download URL.

Error: 403 Forbidden

  • Reasons: This is most likely due to some changes in the website and there is not much you can do about it. If you are behind an corporate proxy, this can means that the website you're trying to reach or the protocol you are using (for example, ftp) is blocked by your company. Again, there are not much you can do about it.
  • Solutions: Wait a few days and see if the problem is resolved. If not then try setting "Spoof HTTP referer" to an URL of the website you are downloading from, possibly the page which lists the available downloads is required. Try setting the application specific user agent to a commonly used user agent or to something completely random.

Error: 503 Server Unavailable

  • Reasons: The server you are attempting to download the file from is likely offline or inaccessible.
  • Solutions: Wait for reasonable amount of time and try again. Generally this error disappears when the server is up again.

Error: 550 File unavailable

  • Reasons: The requested file was not found on the server. The file was deleted/renamed/moved on the server and your download link no longer corresponds to an actual file.
  • Solutions: Find out the new download link and enter it into Ketarin.

Other issues

  • Ketarin does not reliably determine if there are updates for an application. This may happen if the webserver submits incorrect "last modified" information and also does not reveal the expected file size. In this case, use Use the following variable as indicator for changes to let a variable (for example, a version number) decide whether or not an update needs to be downloaded.
  • If you cannot make sense of the error you get, or you need further details about the server response, you can use an HTTP Web Sniffer.