Cloudflare Challenge

Occasionally, you might be hit with a Cloudflare verification page blocking itch-dl. This usually does not happen, but if Cloudflare has determined that your client misbehaves (too old OS, shared network, malware/residential proxies on your network), you might be served a captcha page.

Unfortunately, itch-dl is unable to pass that page automatically, but:

• You can pass the challenge yourself in a web browser.
• Copy the cf_clearance cookie using the same instructions as on the API Keys page. (The cookie may start with a random string, not eyJ...)
• Pass the clearance as the --cf-clearance flag or set it in the cf_clearance config value.
• Grab your web browser's user agent and set it with --user-agent or the user_agent config value.

Warnings:

• Do NOT pass the Cloudflare clearance unless you are actively being blocked.
• Cloudflare cookies are short-lived and you may have to pass the challenge again after a few hours.