captchium


Namecaptchium JSON
Version 1.1.3 PyPI version JSON
download
home_pagehttps://github.com/d3kxrma/captchium
SummaryPython library for solving Google reCAPTCHA challenges
upload_time2024-09-22 10:06:11
maintainerNone
docs_urlNone
authordekxrma
requires_pythonNone
licenseMIT
keywords python recaptcha captcha solver selenium
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Captchium

Captchium is a Python library for solving Google reCAPTCHA challenges using audio recognition. It provides a convenient way to automate CAPTCHA solving in web scraping or automation tasks.

## Installation

To install Captchium, you can use pip:

```shell
pip install captchium
```

## Usage

Here's an example of how to use Captchium:

```python
from selenium.webdriver.chrome.service import Service
from selenium.webdriver.common.by import By
from selenium import webdriver
from captchium import Captchium
from driverium import Driverium

# Create a web driver instance
driver_options = webdriver.ChromeOptions()
service = Service(Driverium().get_driver())
driver = webdriver.Chrome(service=service, options=driver_options)

# Initialize Captchium with the web driver instance
captchium = Captchium(driver, recognize_service="google")

# Solve the CAPTCHA challenge within an iframe
iframe = driver.find_element(By.TAG_NAME, "iframe")
captchium.solve(iframe)

# Continue with your automation task
# ...
```

To use the `solve` function, you need to pass the iframe element that opens after clicking on the CAPTCHA. This can be done by locating the iframe element using Selenium's `find_element` method and passing it as an argument to the `solve` function.

**Do not pass this iframe to the function**

![Not this iframe ](https://i.imgur.com/oSyw2qx.png)

**Pass this iframe**

![This iframe](https://i.imgur.com/uF0AtlI.png)

## Supported Audio Recognition Services

Captchium currently supports two audio recognition services: Google and Vosk. By default, it uses the Google service. You can specify the service when initializing Captchium:

```python
captchium = Captchium(driver, recognize_service="vosk", model_path="path/to/model")
```

Please note that if you choose the Vosk service, you need to download the Vosk model from [https://alphacephei.com/vosk/models](https://alphacephei.com/vosk/models) and unpack it as 'model' in the current folder or specify the path to the model using the model_path parameter.

## Contributing

Contributions are welcome! If you find any issues or have suggestions for improvements, please open an issue or submit a pull request on the [Captchium GitHub repository](https://github.com/d3kxrma/captchium).

## License

Captchium is licensed under the MIT License. See the [LICENSE](https://github.com/d3kxrma/captchium/blob/main/LICENSE) file for more information.

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/d3kxrma/captchium",
    "name": "captchium",
    "maintainer": null,
    "docs_url": null,
    "requires_python": null,
    "maintainer_email": null,
    "keywords": "python, recaptcha, captcha, solver, selenium",
    "author": "dekxrma",
    "author_email": "qqdjnuxez@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/c7/4f/fc55cace44b350f52f24fec2eb2dbfece56cb2064e77e066bf17e41c2af7/captchium-1.1.3.tar.gz",
    "platform": null,
    "description": "# Captchium\r\n\r\nCaptchium is a Python library for solving Google reCAPTCHA challenges using audio recognition. It provides a convenient way to automate CAPTCHA solving in web scraping or automation tasks.\r\n\r\n## Installation\r\n\r\nTo install Captchium, you can use pip:\r\n\r\n```shell\r\npip install captchium\r\n```\r\n\r\n## Usage\r\n\r\nHere's an example of how to use Captchium:\r\n\r\n```python\r\nfrom selenium.webdriver.chrome.service import Service\r\nfrom selenium.webdriver.common.by import By\r\nfrom selenium import webdriver\r\nfrom captchium import Captchium\r\nfrom driverium import Driverium\r\n\r\n# Create a web driver instance\r\ndriver_options = webdriver.ChromeOptions()\r\nservice = Service(Driverium().get_driver())\r\ndriver = webdriver.Chrome(service=service, options=driver_options)\r\n\r\n# Initialize Captchium with the web driver instance\r\ncaptchium = Captchium(driver, recognize_service=\"google\")\r\n\r\n# Solve the CAPTCHA challenge within an iframe\r\niframe = driver.find_element(By.TAG_NAME, \"iframe\")\r\ncaptchium.solve(iframe)\r\n\r\n# Continue with your automation task\r\n# ...\r\n```\r\n\r\nTo use the `solve` function, you need to pass the iframe element that opens after clicking on the CAPTCHA. This can be done by locating the iframe element using Selenium's `find_element` method and passing it as an argument to the `solve` function.\r\n\r\n**Do not pass this iframe to the function**\r\n\r\n![Not this iframe ](https://i.imgur.com/oSyw2qx.png)\r\n\r\n**Pass this iframe**\r\n\r\n![This iframe](https://i.imgur.com/uF0AtlI.png)\r\n\r\n## Supported Audio Recognition Services\r\n\r\nCaptchium currently supports two audio recognition services: Google and Vosk. By default, it uses the Google service. You can specify the service when initializing Captchium:\r\n\r\n```python\r\ncaptchium = Captchium(driver, recognize_service=\"vosk\", model_path=\"path/to/model\")\r\n```\r\n\r\nPlease note that if you choose the Vosk service, you need to download the Vosk model from [https://alphacephei.com/vosk/models](https://alphacephei.com/vosk/models) and unpack it as 'model' in the current folder or specify the path to the model using the model_path parameter.\r\n\r\n## Contributing\r\n\r\nContributions are welcome! If you find any issues or have suggestions for improvements, please open an issue or submit a pull request on the [Captchium GitHub repository](https://github.com/d3kxrma/captchium).\r\n\r\n## License\r\n\r\nCaptchium is licensed under the MIT License. See the [LICENSE](https://github.com/d3kxrma/captchium/blob/main/LICENSE) file for more information.\r\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "Python library for solving Google reCAPTCHA challenges",
    "version": "1.1.3",
    "project_urls": {
        "Homepage": "https://github.com/d3kxrma/captchium",
        "Source": "https://github.com/d3kxrma/captchium"
    },
    "split_keywords": [
        "python",
        " recaptcha",
        " captcha",
        " solver",
        " selenium"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "5be1af62e34275ceadb81a55fb11cb08be061c4d3eb00a92ab1c1ddea16489bd",
                "md5": "1df0ab70109032aa532d4482a7e4dc89",
                "sha256": "3ad21ebba54336f7ec2f287a0af7578226a9de002a46ceacdbb62e3ed33cf1b8"
            },
            "downloads": -1,
            "filename": "captchium-1.1.3-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "1df0ab70109032aa532d4482a7e4dc89",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 5309,
            "upload_time": "2024-09-22T10:06:10",
            "upload_time_iso_8601": "2024-09-22T10:06:10.548623Z",
            "url": "https://files.pythonhosted.org/packages/5b/e1/af62e34275ceadb81a55fb11cb08be061c4d3eb00a92ab1c1ddea16489bd/captchium-1.1.3-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "c74ffc55cace44b350f52f24fec2eb2dbfece56cb2064e77e066bf17e41c2af7",
                "md5": "f807c8af7bfb8ad0a4fd352e79e40b4a",
                "sha256": "3673a527880ed737f409bcc7ae2b097794cf697535c76b8c79facfbabd1bfbf2"
            },
            "downloads": -1,
            "filename": "captchium-1.1.3.tar.gz",
            "has_sig": false,
            "md5_digest": "f807c8af7bfb8ad0a4fd352e79e40b4a",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 4879,
            "upload_time": "2024-09-22T10:06:11",
            "upload_time_iso_8601": "2024-09-22T10:06:11.909128Z",
            "url": "https://files.pythonhosted.org/packages/c7/4f/fc55cace44b350f52f24fec2eb2dbfece56cb2064e77e066bf17e41c2af7/captchium-1.1.3.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-09-22 10:06:11",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "d3kxrma",
    "github_project": "captchium",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "captchium"
}
        
Elapsed time: 0.35835s