Skip to content

Home ‐ Secure Browser Wiki

Jump to bottom
Robert Trenaman edited this page May 10, 2026 · 2 revisions

Welcome to the Secure Browser project wiki. This is the central hub for all documentation, guides, and resources for the Secure Browser framework.

What is Secure Browser?

Secure Browser is a Python-based web browser framework that provides multiple browser backends with advanced security features. It's designed for users who prioritize security, privacy, and control over their browsing experience.

Key Features

  • Multiple Browser Backends: PyQt5 (feature-rich), Tkinter (lightweight), WebView (native integration)
  • Security First: HTTPS enforcement, JavaScript control, website filtering, security headers
  • Customizable: Proxy support, user-agent customization, whitelist/blacklist filtering
  • Developer Tools: Integrated developer tools for debugging and inspection
  • Advanced Search: Built-in search operators tool for complex queries

🚀 Getting Started

Prerequisites

  • Python 3.7 or higher
  • pip (Python package manager)
  • Virtual environment (recommended)

Quick Install

# Clone the repository
git clone https://github.com/AutoBotSolutions/Secure-Browser-Framework.git
cd Secure-Browser-Framework

# Create virtual environment
python3 -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Start the browser
python main.py

For detailed installation instructions, see the Installation Guide.

🌐 Browser Backends

PyQt5 Browser

  • Best for: Users who want a modern, feature-rich browsing experience
  • Features: Tabbed browsing, dark theme, developer tools, settings dialog
  • Command: python main.py --browser pyqt5

Tkinter Browser

  • Best for: Security-conscious users who want granular control
  • Features: HTTPS enforcement, JavaScript control, whitelist/blacklist, security headers
  • Command: python main.py --browser tkinter

WebView Browser

  • Best for: Users who prefer native OS integration
  • Features: Native webview integration, navigation history, proxy settings
  • Command: python main.py --browser webview

📖 Documentation

User Documentation

Developer Documentation

🛠️ Tools

Advanced Search Operators Tool

Build complex search queries with operators like site:, intitle:, filetype:, and more.

python main.py --browser search

Developer Tools Integration

Integrated developer tools for debugging and web inspection (available in PyQt5 browser).

🔒 Security Features

  • HTTPS Enforcement: Automatically converts HTTP to HTTPS
  • JavaScript Control: Toggle JavaScript on/off
  • Website Filtering: Whitelist and blacklist support
  • Security Headers: Built-in security headers
  • Proxy Support: HTTP/HTTPS proxy configuration
  • User-Agent Customization: Customize browser user-agent

🤝 Contributing

We welcome contributions! Please see the Development Guide for details on how to contribute.

Contribution Guidelines

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

📞 Support

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🔗 Links

📊 Project Status

  • Version: 1.0.0
  • Python: 3.7+
  • Status: Active Development
  • Last Updated: 2024

Need help? Check the Troubleshooting page or open an issue on GitHub.

Clone this wiki locally