CaptchaSolver

Captcha Solver add-on for NVDA, designed for convenient recognition
of graphic captcha and ASCII graphics on web pages through the service
rucaptcha.com .

What is needed in the beginning?

First you need to create a personal account on the service

and replenish the balance in any convenient way. There is no need to describe it, everything
is intuitive there.

Attention!

  1. There is Google reCAPTCHA on the service, in the login and registration form.
  2. After
    after registering and receiving a personal API key, save all data in a safe place, in case of loss of all information on your own PC or other media.
  3. If you do not use recognition so often, then it will be enough for you to put $1 or 40-50 rubles on the balance.

Add-on Settings

After installing the add-on, follow these steps:

  1. Register on the website rucaptcha.com and top up the balance of the created account in any convenient way, if you haven't done it yet.

  2. On the page https://rucaptcha.com/setting copy your 32-digit API key.
  3. Open:
  4. NVDA menu
  5. And in the settings dialog box that appears, in the "API Key" field, insert the key received in the previous step 2 and click "OK".
  6. Open the NVDA menu/Input parameters/Gestures and in the "Captcha Solver" section, assign any free gesture (keyboard shortcut, touch gesture, etc.) to the "Start recognition process" command.
    It is also recommended to assign a gesture to the "Report account balance" command to control expenses.

Also in the settings you need to pay attention to the following checkboxes:

To save the settings, click the "OK" button, and also save the NVDA configuration with the NVDA+Control+C command.

How to use?

Now, using NVDA object navigation, place the cursor on
an object with a captcha image (as a rule, this is a "graph" type object) and
start the recognition process with a previously configured gesture.
If the "Report image size" flag is set in the settings, then the keyboard shortcut will need to be pressed twice quickly.
After the message about successful sending
captcha images should wait 10-15 seconds
for the recognition result and if everything goes well, NVDA will report it, and the recognized text will appear in the clipboard.

If the captcha is not recognized, then a message will also be received about it.
Funds for unrecognized captchas are returned to the balance.

Which captchas are recognized?

The add-on is designed to recognize a classic captcha with a single string of characters in the image.
Cyrillic captchas are also recognized without problems.
CaptchaSolver Extension
It can also recognize captchas in the form of pseudo-graphics (ASCII graphics).
If the captcha is displayed on the site in the form of ASCII graphics: - this is (a few lines above
the captcha input field consisting of underscores, slashes and vertical
dashes). Use CaptchaSolver to send the area
containing this pseudo-image for recognition and get the correct
result in a few seconds.

How do I find out the balance?

To get information about the account balance, open the NVDA menu, Service,
Captcha
Solver and select the item "Account Balance..."
You can also assign a keyboard shortcut to this action in the input gestures dialog.

Additional Settings

How to thank the developer

If you liked the CaptchaSolver add-on, then you can
thank the author at any time:
by opening the NVDA menu/Service/Captcha
Solver/Donate to the author of CaptchaSolver.

Or you can make a transfer to the following Yoomone wallet:

https://yoomoney.ru/to/410012293543375

Where to download?

You can download the CaptchaSolver add-on at
CaptchaSolver personal page
or in the general directory
All additions
In addition, the add-on can be downloaded on
recent additions page

Note.
The original reference was supplemented by the site administrator NVDA.RU .

Also, help is added in addition and is available from the section "NVDA Menu, Submenu Help" in Russian and English.

Change log

New in version 2022.04.21

  1. The add-on is now compatible with NVDA 2022.1.
  2. The minimum required NVDA version is now 2021.2.
  3. Other minor improvements and fixes.

New in version 2021.06.04

  1. Added compatibility with NVDA 2021.1.
  2. The add-on now requires an NVDA version no lower than 2019.3.
  3. When the "Dimming" function is active in NVDA
    screen", the add-on now blocks attempts to recognize the captcha, with the provision of the appropriate notification to the user.
  4. Restarting plugins by NVDA+Control+F3 no longer causes duplication of the "Captcha Solver" element in the "Service" submenu.

New in version 2019.09.05

  1. Implemented compatibility with Python 3 and NVDA 2019.3.
  2. Other minor fixes and improvements.

New in version 4.0

  1. The minimum required NVDA version is now 2019.1. In earlier versions of the program, the add-on
    it won't work.
  2. Other minor improvements and fixes.

New in version 3.3:

  1. Fixed captcha recognition when the Braille display is running.
  2. Other minor improvements and fixes.

New in version 3.2:

  1. The "Recognize only graphic objects" checkbox has been added to the settings dialog, blocking the recognition of objects that are not graphic elements. The checkbox is selected by default.
  2. Fixed captcha recognition in NVDA 2018.3. In particular, added compatibility
    with wxPython 4.0 phoenix.
  3. CaptchaSolver commands no longer work on a secure desktop.
  4. When installing CaptchaSolver, verification of the NVDA version used has been added. CaptchaSolver will no longer install on NVDA 2017.2 or earlier.
  5. Other minor fixes and improvements.

New in version 3.1:

  1. The "Use HTTPS" checkbox has been removed from the settings dialog. Now CaptchaSolver is accessing the server rucaptcha.com https protocol only.
  2. Fixed a bug when saving settings
    CaptchaSolver in NVDA 2018.2.
  3. CaptchaSolver now requires NVDA version no lower than 2017.3. In earlier versions of NVDA, the add-on will not work.
  4. Other minor improvements and fixes.

New in version 3.0:

  1. Added the ability to send text instructions to the employee to help solve the captcha. For example, if you need to enter only red characters from the captcha image, then you can specify this requirement in the instructions. To use this function in the settings dialog
    CaptchaSolver select the new checkbox "Send text instruction" and then immediately before sending the image to the user, a dialog box will be displayed in which you can enter text for the employee.
  2. The "Report image size" checkbox has been added to the settings dialog, the installation of which will indicate to the add-on, after a single call of the captcha solution command, to first report the dimensions of the navigator object. To start the recognition process itself, call this command twice quickly. Reading
    the size of the navigator object can help in finding the desired object with a captcha and will protect you from accidentally sending the image for recognition.
  3. A combined list "Image language" has been added to the settings dialog, with which you can specify the language of characters on the captcha. For example, if you have a Cyrillic captcha and you want to send it to a Russian-speaking employee for recognition, then you should select "Cyrillic only" in this list. If the "Undefined" option is selected, then the captcha being sent may get
    to an English-speaking employee who cannot solve it.
  4. The menu item "Captcha Solver Settings..." in the Service submenu has been replaced with a submenu with the following elements:
    • Settings... - opens the CaptchaSolver settings dialog.
    • Account balance... - opens a dialog box with information about your account balance.
    • Profile on rucaptcha.com - opens a web page with your profile on rucaptcha.com (authorization required)
    • Donate to the author of CaptchaSolver - opens the Yandex Money wallet page,
    where you can donate to the author of CaptchaSolver any desired amount from a bank card or from your Yandex Money wallet (if there is one).
    • Add-on web page - opens the add-on web page on github.com , where you can always get instructions for use or the source code of the add-on.
  5. On the secure desktop, the CaptchaSolver settings submenu is no longer available.
  6. Other internal changes.

New in version 2.0:

  1. You can now send images of objects for recognition
    any types. This solves the captcha problem in applications such as kavremover, where the object with the confirmation code is not a "GRAPHIC" type object. Because of this, it is recommended to check the current navigator object before sending the image for recognition, in order to be sure that this is exactly the object that is required.
  2. Added checking the display of the navigator object on the screen. Now if the navigator object is outside the screen, the user will be notified about it, and sending the image
    will be canceled. This solves the problem of sending blank images from objects off the screen.
  3. To display the CaptchaSolver settings dialog, NVDA version 2016.4 and higher is now required.
  4. The "Case-sensitive recognition" checkbox has been added to the CaptchaSolver settings dialog. If this flag is set, the employee solving the captcha will be notified that the answer should be entered case-sensitive. It is recommended to check this box only if it is necessary. In most cases , the case of the characters on
    the captcha doesn't matter.
  5. The "Use HTTPS" checkbox has been added to the CaptchaSolver settings dialog, the installation of which will tell the add-on to encrypt all accesses to the server rucaptcha.com . Useful in unsecured networks.
  6. The add-on settings are now located in the captchaSolverSettings.pickle file in the NVDA settings directory. Because of this, after updating CaptchaSolver, you should re-specify the API key in the settings dialog.
  7. Removed the default keyboard shortcuts to start the recognition process and receive
    account balance (NVDA+shift+c and NVDA+shift+control+c, respectively). Now, after installing/updating the add-on, the user must independently assign the desired (free) keyboard shortcuts in the "Captcha Solver" section of the "Input Gestures" dialog.
  8. Other minor improvements and fixes.

Captcha Solver 1.0

First version