Skip to main content

A stealthy browser automation tool with only screen and mouse

Project description

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

pip install stealth-browser-controller

🎮 Quick Start

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

stealth_browser_controller-0.1.6.tar.gz (20.0 kB view details)

Uploaded Source

Built Distribution

stealth_browser_controller-0.1.6-py3-none-any.whl (5.3 kB view details)

Uploaded Python 3

File details

Details for the file stealth_browser_controller-0.1.6.tar.gz.

File metadata

File hashes

Hashes for stealth_browser_controller-0.1.6.tar.gz
Algorithm Hash digest
SHA256 50db5979ba2c9779e111604b8446d525c121f6985a7e24cdb4ae5983c969705c
MD5 85464fedf326acf28fe984710bef5e81
BLAKE2b-256 4b6c938a18d5f3cfa4d6d2eb2be958f52e2127bb1643611c09cffa4af41c67a1

See more details on using hashes here.

File details

Details for the file stealth_browser_controller-0.1.6-py3-none-any.whl.

File metadata

File hashes

Hashes for stealth_browser_controller-0.1.6-py3-none-any.whl
Algorithm Hash digest
SHA256 1486868dd7894fbc0b024225508fb9e0f4bda641dd33a2c57db8444016c02825
MD5 d3934a4e69d3f6b41ec08658318c666e
BLAKE2b-256 3581e8a30e361dca2e472f56b44270eda0e91755cb80204cb0a24d620e6ce8c5

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page