# Stealth Browser Controller 🕵️♂️
Feeling insecure using Selenium, playwright, puppeteer, etc? Let's make things simple.
A Python package for browser automation that mimics human-like behavior with natural mouse movements and realistic typing patterns without using any browser automation libraries.
## 🌟 Features
- Human-like mouse movements and clicks
- Natural typing patterns
- Image-based element detection
- Easy-to-use browser control
## 🚀 Installation
```bash
pip install stealth-browser-controller
```
## 🎮 Quick Start
```python
from stealth_browser_controller import StealthBrowserController
# Create a browser instance
browser = StealthBrowserController("google-chrome")
# browser = StealthBrowserController("path/to/your/browser/executable")
# Open a website
browser.open("https://www.google.com")
# Find an element by image and input text
search_input = browser.find_element_by_image("path/to/search_input.png")
if search_input:
search_input.input_text("Hello, World!")
# Find an element by image and click it
search_button = browser.find_element_by_image("path/to/search_button.png")
if search_button:
search_button.click()
# Close the browser
browser.close()
```
## 📚 Documentation
### Browser Class
The main class for controlling the browser. Supports:
- Opening URLs
- Finding elements by image
- Typing text
- Mouse movements
- Scrolling
- Key presses
### Element Class
Represents elements on the page. Supports:
- Clicking (single, double, right-click)
- Text input
- Visibility checking
## 🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
## 📝 License
This project is licensed under the MIT License - see the LICENSE file for details.
Raw data
{
"_id": null,
"home_page": "https://github.com/sarperavci/stealth-browser-controller",
"name": "stealth-browser-controller",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": null,
"author": "Sarper AVCI",
"author_email": "sarperavci20@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/b4/54/06956c5f1e74750dd755f36b2860b087b97bc125372f57c30788ddc7d3a6/stealth_browser_controller-0.1.5.tar.gz",
"platform": null,
"description": "# Stealth Browser Controller \ud83d\udd75\ufe0f\u200d\u2642\ufe0f\n\nFeeling insecure using Selenium, playwright, puppeteer, etc? Let's make things simple.\n\nA Python package for browser automation that mimics human-like behavior with natural mouse movements and realistic typing patterns without using any browser automation libraries.\n\n## \ud83c\udf1f Features\n\n- Human-like mouse movements and clicks\n- Natural typing patterns\n- Image-based element detection\n- Easy-to-use browser control\n\n## \ud83d\ude80 Installation\n\n```bash\npip install stealth-browser-controller\n```\n\n## \ud83c\udfae Quick Start\n\n```python\nfrom stealth_browser_controller import StealthBrowserController\n\n# Create a browser instance\nbrowser = StealthBrowserController(\"google-chrome\")\n# browser = StealthBrowserController(\"path/to/your/browser/executable\")\n\n# Open a website\nbrowser.open(\"https://www.google.com\")\n\n# Find an element by image and input text\nsearch_input = browser.find_element_by_image(\"path/to/search_input.png\")\nif search_input:\n search_input.input_text(\"Hello, World!\")\n\n# Find an element by image and click it\nsearch_button = browser.find_element_by_image(\"path/to/search_button.png\")\nif search_button:\n search_button.click()\n# Close the browser\nbrowser.close()\n```\n\n## \ud83d\udcda Documentation\n\n### Browser Class\nThe main class for controlling the browser. Supports:\n- Opening URLs\n- Finding elements by image\n- Typing text\n- Mouse movements\n- Scrolling\n- Key presses\n\n### Element Class\nRepresents elements on the page. Supports:\n- Clicking (single, double, right-click)\n- Text input\n- Visibility checking\n\n## \ud83e\udd1d Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## \ud83d\udcdd License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n",
"bugtrack_url": null,
"license": null,
"summary": "A stealthy browser automation tool with only screen and mouse",
"version": "0.1.5",
"project_urls": {
"Homepage": "https://github.com/sarperavci/stealth-browser-controller"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "57bf61cf7b7decefe74abd004a8a7d7f8b3ab9dfe26dd08538fbca8e4b777581",
"md5": "e566e74827862ad2b91ad1759eb764a2",
"sha256": "524ab1f2ef2b4f040f318860f63c3fd83d57d762aa3115062ef9317b2a476f2f"
},
"downloads": -1,
"filename": "stealth_browser_controller-0.1.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e566e74827862ad2b91ad1759eb764a2",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 5278,
"upload_time": "2025-01-22T00:26:24",
"upload_time_iso_8601": "2025-01-22T00:26:24.916242Z",
"url": "https://files.pythonhosted.org/packages/57/bf/61cf7b7decefe74abd004a8a7d7f8b3ab9dfe26dd08538fbca8e4b777581/stealth_browser_controller-0.1.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b45406956c5f1e74750dd755f36b2860b087b97bc125372f57c30788ddc7d3a6",
"md5": "cb4a5292eb1311099c44c5557a907141",
"sha256": "86abd39ffc7175208d20f280931d243519a1816b1b2b7ca98932ab0df291b726"
},
"downloads": -1,
"filename": "stealth_browser_controller-0.1.5.tar.gz",
"has_sig": false,
"md5_digest": "cb4a5292eb1311099c44c5557a907141",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 13574,
"upload_time": "2025-01-22T00:26:27",
"upload_time_iso_8601": "2025-01-22T00:26:27.071995Z",
"url": "https://files.pythonhosted.org/packages/b4/54/06956c5f1e74750dd755f36b2860b087b97bc125372f57c30788ddc7d3a6/stealth_browser_controller-0.1.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-22 00:26:27",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "sarperavci",
"github_project": "stealth-browser-controller",
"github_not_found": true,
"lcname": "stealth-browser-controller"
}
JSON
