WebSim Browser

A dedicated browser for websim.ai with enhanced features and plugin support.

(This readme is ai generated, so it may not be 100% accurate.)

Features

Core Features

• 🏠 Dedicated websim.ai browser with persistent login
• 🔒 Enhanced security settings for websim.ai
• 💾 Persistent cache and cookie storage
• 🌐 Chrome-compatible user agent and headers

Navigation Controls

• Home button - Return to websim.ai homepage
• Reload button - Refresh the current page
• Settings button - Configure browser settings
• Clear Cache button - Clear browsing data

Advanced Features

• 🔌 Plugin System

  • Support for websim.ai plugins
  • Built-in plugin manager
  • Default plugins:
    • @Trey6383/test123
    • @Trey6383/injectify
    • @hintbl0ck/edit5
    • @Trey6383/edit6-real
  • Custom plugin support

• 🛠️ API Features (Experimental)

  • Some features may be limited or unavailable
  • Project Management
  • Analytics Integration
  • Team Management
  • Security Settings

Installation

Windows Users

1. Download websim.exe from here
2. If Windows SmartScreen appears:
   • Click "More info"
   • Click "Run anyway"
   • Or: Right-click > Properties > Check "Unblock" > Apply

Mac Users

Since this is a Windows executable, Mac users have two options:

1. Run from source:

   # Install Homebrew if you haven't already
   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   
   # Install Python and Qt dependencies
   brew install [email protected]
   brew install pyqt@6
   
   # Clone and run the browser
   git clone [repository-url]
   cd WebsimBrowser
   pip3 install -r requirements.txt
   python3 main.py

2. Use virtualization:

   • Install Parallels Desktop, VMware Fusion, or VirtualBox
   • Set up a Windows virtual machine
   • Run the Windows executable inside the VM

Note: Running from source is recommended for Mac users as it provides better performance and native integration.

Usage

Basic Navigation

1. Launch the browser
2. Log in to your websim.ai account
3. Use the navigation buttons at the top:
   • 🏠 Home: Return to websim.ai
   • 🔄 Reload: Refresh the page
   • ⚙️ Settings: Configure browser
   • 🧹 Clear Cache: Clear browsing data

Using Plugins

1. Click the 🔌 Plugins button
2. Choose from preset plugins or add a new one
3. To add a custom plugin:
   • Click "New Plugin..."
   • Enter the creator's websim username (with @)
   • Enter the plugin name
   • The plugin will be applied to the current page

Settings

• JavaScript toggle
• Cache size configuration
• Data clearing options
• Security preferences

Development

Requirements

• Python 3.11+
• PyQt6
• PyQt6-WebEngine

Building from Source

1. Clone the repository
2. Install dependencies:

   # Windows
   pip install -r requirements.txt
   
   # Mac
   pip3 install -r requirements.txt

3. Run the browser:

   # Windows
   python main.py
   
   # Mac
   python3 main.py

Security Notes

• The browser uses secure settings by default
• Persistent storage is maintained in the user's AppData folder (Windows) or ~/Library/Application Support (Mac)
• All connections use HTTPS
• Cookies and cache are encrypted

Contributing

Feel free to submit issues and pull requests for:

• New features
• Bug fixes
• Documentation improvements
• UI enhancements

License

This project is open source and available under the MIT License.

Credits

• Created for use with websim.ai
• Built with PyQt6 and QtWebEngine
• Icons and emojis provided by standard Unicode