Knowledgebase:
JD opens my browser to display captchas
Posted by Jay Downloader, Last modified by pspzockerscene psp on 29 March 2023 03:43 PM

Why does JD open my browser?

Some captcha types require a browser environment (JavaScript, Cookies, ...) to get solved. Others are much easier to solve if we use the browser fo example Googles "reCaptchaV2" and "reCaptchaV3":
test
(Side-Note: Once clicking a reCaptchaV3, it can visually change to look like a reCaptchaV2 at any time.)
reCaptchaV2 and reCaptchaV3 ("Invisible reCaptcha") demo/example: recaptcha-demo.appspot.com
Side-Note: Invisible reCaptcha captchas may actually be invisible in a real browser but when you need to solve such captchas via JDownloader Browser-Solver, they will always be visible due to technical reasons!

hcaptcha demo/example: dashboard.hcaptcha.com/signup

Which software-requirements does browser captcha solving have?

This depends on the kind of installation you have:

Requirements for Headless & myjdownloader users:

Requirements for "normal" JDownloader with GUI

  • A supported browser and our myjdownloader browser addon
  • As long as you're trying to solve the captcha on the same computer where JDownloader is running, a myjd account is not required

Captcha related advanced settings

There are several Advanced Options (Settings->Advanced Settings) to customize the browser solver behavior.
Only change them if you know what you are doing!

  1. Enabled: This will enable/disable the browser solver
  2. Local HTTP Port: The http port of the local webserver
  3. Blacklist Entries: Define which hoster/plugins shall not use the browser solver.  
    Example: [ "uploaded.to-recaptcha" ].
    Note: We strongly recommend to modifiy this value in [Settings->Captcha->Settings Column]
    Note: The format is a json array. 
    * Do not forget the leading and trailing chars: [ and ] 
    * These special characters must be escaped: \ and " --> \ to \\ and " to \"
    * Each parameter in your commandline should be wrapped by " and seperated by a ,
    * Use %s as wildcard for the url
    * Do not press enter to confirm changes. Just unfocus the field by clicking somewhere else.

  4. Auto Open Browser: Should JD open the browser for you, or do you prefer to click a button to open it?
  5. Auto Click: JD can help you to solve some captchas in the browser, by simulating clicks and text inputs in the browser window.
  6. Wait For Map: Is required for the solver priority.  
    Example: {"imagetyperz" : 60000,"dbc" : 60000,"9kw" : 120000,"myjd" : 60000,"jac" : 32000,"cb" : 120000} 
    Note: We strongly recommend to modifiy this value in [Settings->Captcha->Timeouts Column]
    Note: The format is a json object. 
    * Do not forget the leading and trailing chars: { and } 
    * These special characters must be escaped: \ and " --> \ to \\ and " to \"
    * Each parameter in your commandline should be wrapped by " and seperated by a ,
    * Use %s as wildcard for the url
    * Do not press enter to confirm changes. Just unfocus the field by clicking somewhere else.
  7. Black White Listing: Enable/Disable the Blacklist or Whitelist Entries.
  8. Whitelist Entries:  Define which hoster/plugins shall ignore the Blacklist Entries the browser solver.  
    Example: [ "uploaded.to-recaptcha" ]. 
    Note: We strongly recommend to modifiy this value in [Settings->Captcha->Settings Column
    Note: The format is a json array. 
    * Do not forget the leading and trailing chars: [ and ] 
    * These special characters must be escaped: \ and " --> \ to \\ and " to \"
    * Each parameter in your commandline should be wrapped by " and seperated by a ,
    * Use %s as wildcard for the url
    * Do not press enter to confirm changes. Just unfocus the field by clicking somewhere else.
  9. Browser Commandline: We recommend to use the default browser that you use every day. If you want to use a different browser anyway, follow the linked instructions.
  10. Browser Loop: If enabled, JD will use your default browser to improve the captcha detection.

Troubleshooting

Excluding 3rd party browser-addon related issues:
No matter which issue with browser captchas you are having: First disable all of your installed browser addons except our myjdownloader addon and check again!
Sometimes other browser addons can cause issues with browser captchas as they can intervene with our addon at any time and prohibit it from working correctly.

Excluding issues caused by firewalls:
Some firewalls are blocking some localhost related requests by default.
To sensure that that isn't the cause of your problem, temporarily disable your firewall and try again.

For users of browser addons "NoScript" or any kind of adblockers: Meet the following settings to ensure that these addons do not blick our browser solver:

  • Disable NoScript for http://127.0.0.1/
  • Disable AdBlock for http://127.0.0.1/ this may not be required

[Firefox users] Error "Invalid site key" or similar

You might be using an outdated version of our myjdownloader browser addon.
Sometimes, AV software is blocking the auto update of such browser addons.
Uninstall the myjdownloader addon and re-install it using the link provided on this page

Workarounds for myjdownloader browser addon bugs: Use another browser for captcha solving

It can sometimes happen that there are bugs in our browser addon for a specific browser.
Because these addons are never updated at the same time and often have to go through a review process before they are released via the browsers' respective stores, it can be a good idea to at least temporarily switch the browser for testing.
E.g. you are having an issue with browser solving in Chrome: Install Firefox and check if it works then!

Auto-Click doesn't work

Auto-click is only available for reCaptcha captchas - it is not available for hCaptcha or any other type browser captchas.
Specifically about hCaptcha: If you want to have a working auto-click feature for hCaptcha, try this Tampermonkey/Greasemonkey addon.
The following tools/settings can make the JDownloader auto-click fail:

  • Software which interferes with your mouse e.g. screen capture applications or your systems magnifier application e.g. Windows magnifier/zoom
  • Windows display scale setting is set to higher/lower value than 100%
    Solution/workaround: Set your display scale setting back to 100%
    Internal ticket: svn.jdownloader.org/issues/88375
  • Multi monitor setups: If your mouse is on another monitor than the browser window where the click is supposed to happen that may fail. Workaround: Make sure that your mouse pointer is always in the same monitor where your browser captcha browser gets opened
  • Using myjdownloader to control a JD instance that is running on another computer: Because the JDownloader client itself performs the auto-click, it can only work when the captcha is solved on the same device which runs JDownloader itself!

In case your issue is that auto-click keeps clicking on the wrong position, you may disable it as a workaround, see:
Settings -> Advanced Settings -> BrowserCaptchaSolver: Auto Click

Auto-Click happens before the captcha page has finished loading (too early) and thus misses the captcha

This can be a rare occurrence which should only happen on older devices where the browser takes a long time to open.
Once the captcha is supposed to be loaded and rendered, JD is waiting a predefined amount of milliseconds before clicking the checkbox.
You can increase that time value using the following setting:
Settings -> Advanced Settings -> BrowserCaptchaSolver: Auto Click Delay --> Set this to a higher value like 5000 and try again.
It can also help to leave your browser open permanently so that JDownloader doesn't need to fully open/close it each time.
This should be easy to accomplish by simply opening one or two other browser tabs in beforehand so whenever JDownloader prompts for a captcha, it will only open and close a new tab instead of opening and closing the browser itself.



Attachments 
 
 jd2-settings-captchas-in_browser.png (155.92 KB)
 example_reCaptchaV2_with_description.png (7.68 KB)
 example_reCaptchaV3_with_description.png (4.85 KB)
 example_hcaptcha_com_with_description.png (6.40 KB)