# Captcha

### Creating Harvesters and Providers

Many sites require a captcha to be solved upon checkout, which needs to be handled. Click **Captcha** in the top navigation bar to go to the captcha page and get started.

<figure><img src="https://1337991942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJECbanqeNDYnO0P6V06z%2Fuploads%2FQUtTZq7YEmOnV8cCG1hY%2Fimage.png?alt=media&#x26;token=78a13e22-8e46-4be3-bc30-336da5906dda" alt=""><figcaption></figcaption></figure>

### Harvesters

To begin creating a harvester, click the blue **Add** icon in the top left corner while the **Harvesters** tab is active. This will open a window where you can create a harvester with additional settings.

* **Name:** Enter a name for your harvester.
* **Proxy (optional):** Enter a proxy here if you want Valor to use a specific proxy to solve the captcha. If left blank, no proxy will be used.

{% hint style="danger" %}
For most sites, Valor will use the proxy assigned to your task to solve captchas by default. Check the module guides to see which sites use this behavior. If the module you are running uses the task proxy for captcha solving, it is highly recommended to leave the harvester proxy blank if you only plan to use the harvester for that site.
{% endhint %}

* **Enabled Modules:** Select which modules you would like to use the harvester for.
* **Enabled Categories:** Select which categories of captcha in the module you would like to use the harvester for.
* **Open on Demand:** Enable this setting to have Valor automatically open your captcha harvester if it is closed and a running task needs a captcha to be solved. This is useful if you forget to open the harvester beforehand.
* **Open On Launch:** Enabling this setting will automatically open your captcha harvesters each time you open Valor for easier access.
* **Quantity:** Enter the number of harvesters you would like to create using the selected settings.

<figure><img src="https://1337991942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJECbanqeNDYnO0P6V06z%2Fuploads%2FzWMLcdfu2Y9IDPg6Gyv6%2Fimage.png?alt=media&#x26;token=8196193b-2ae5-47d6-bc87-ba1afc002816" alt=""><figcaption></figcaption></figure>

Once finished, click **Create,** and the settings will appear in the captcha table.

<figure><img src="https://1337991942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJECbanqeNDYnO0P6V06z%2Fuploads%2FAuT9XerQvaVxVSXKP6WZ%2Fimage.png?alt=media&#x26;token=86e538b1-d445-4cdb-aa61-df22be12a25c" alt=""><figcaption></figcaption></figure>

Once your harvester has been created, you can click the **Gmail** button on that row to sign in to your Gmail account. This can help you receive easier captcha challenges. A window will open where you can log in to your Gmail account. After you are logged in, you can close the window, and the login session will be saved. If you ever want to log the harvester out, simply delete it and create it again.

{% hint style="danger" %}
Gmail login is only beneficial for Google reCAPTCHA. If the modules you are running do not use this type of captcha, you do not need to sign in to Gmail.
{% endhint %}

After finalizing your harvester settings, click the **Open All** button or the **Play** button on an individual row to open your harvester window.

<figure><img src="https://1337991942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJECbanqeNDYnO0P6V06z%2Fuploads%2Fo6Om27fq1VXblU30aXTZ%2Fimage.png?alt=media&#x26;token=287e432f-1118-473d-a47f-49a3e81eab36" alt=""><figcaption></figcaption></figure>

Once your harvester is on "Waiting For Captcha...", it is ready.

* **AI:** When enabling this setting, Valor will attempt to auto-solve some types of captcha.

{% hint style="danger" %}
This feature is not guaranteed to work and only supports a small number of captcha types. Refer to the discord **#**��**│announcements** for the current status on this feature.
{% endhint %}

* **Testing Type:** If you want to test a captcha, click the blue **Play** button.
* **Reload Captcha:** If your harvester ever gets stuck while solving a captcha, click this button to refresh the page and try again.

{% hint style="danger" %}
Harvester windows should not be minimized if a captcha is needed.
{% endhint %}

### Providers

Valor also supports third-party captcha providers for supported captcha types. To begin creating a provider, click the blue **Add** icon in the top left corner while the **Providers** tab is active. This will open a window where you can add your provider settings. Be sure your provider is enabled and properly configured before running tasks.

* **Name:** Enter a name for your provider.
* **Provider:** Select the captcha provider you want to use.
* **API Key:** Enter the API key from your captcha provider account.

{% hint style="info" %}
Refer to the third-party captcha provider’s documentation for instructions on how to obtain your API key.
{% endhint %}

* **Enabled Modules:** Select which modules you want this provider to be used for.
* **Enabled Categories:** Select which captcha categories this provider should be used for.

{% hint style="danger" %}
Third-party providers do **NOT** work for hCaptcha, so keep that in mind when setting modules and categories.
{% endhint %}

* **Max Concurrency:** Enter the maximum number of captcha requests this provider can handle at the same time. This setting is used so you can split the solvers over multiple providers.

{% hint style="info" %}
If you are only using one provider, set **Max Concurrency** to a number higher than your normal task count so all captcha requests can be sent to that provider at the same time. For example, if needed, you can set it to `999`.
{% endhint %}

* **Enabled:** Turn this on if you want Valor to use this provider. If this is disabled, the provider will be saved but will not be used.

<figure><img src="https://1337991942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJECbanqeNDYnO0P6V06z%2Fuploads%2FxBH9GyllhrHl9Ndm3LkK%2Fimage.png?alt=media&#x26;token=e2bc02ff-f623-4658-af71-0068a44b5941" alt=""><figcaption></figcaption></figure>

Once finished, click **Create**, and the provider will appear in the providers table.

<figure><img src="https://1337991942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJECbanqeNDYnO0P6V06z%2Fuploads%2FhGpKhsQa1TpmmJYpSBhi%2Fimage.png?alt=media&#x26;token=f7387c9f-6182-42d9-aa09-e2b83a792fac" alt=""><figcaption></figcaption></figure>

### Import/Export

You can also import and export Harvesters