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.8.tar.gz (5.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

stealth_browser_controller-0.1.8-py3-none-any.whl (6.3 kB view details)

Uploaded Python 3

File details

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

File metadata

File hashes

Hashes for stealth_browser_controller-0.1.8.tar.gz
Algorithm Hash digest
SHA256 8ae63cd767b5721dfe69c6826f69d29cf606bc3c955137b7449c629b281ea45c
MD5 cc94c3df7def468a9039cb1807bf9a91
BLAKE2b-256 4258db81c0959e59e7fa48b5455625dc600448347360bdac10e8a0a4af870bab

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for stealth_browser_controller-0.1.8-py3-none-any.whl
Algorithm Hash digest
SHA256 1f10b4ba54cf86ad7c81b43048c112f30a8d8774075e70887ad30b0704f61c0d
MD5 a3747c2ec529617ec5f193bd6ac0e64f
BLAKE2b-256 4610177a02349577cccd7a73d6c30d1633c8fe96be208f0afd63412e1d1551b7

See more details on using hashes here.

Supported by

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