Skip to content
BranchesTags

Repository files navigation

🌐 Searcher Browser

Searcher is a powerful, modern, and lightweight desktop web browser built with Python and PyQt6. Designed with speed, security, and productivity in mind, it offers a sleek user interface and a suite of advanced features, including a built-in AI Assistant, robust Ad Blocker, and a secure Password Manager.

📖 About the Browser

Searcher Browser is a fully functional desktop web browser created as an open-source project. It is built from scratch using Python and the Chromium-based PyQt6-WebEngine rendering engine. The goal of this project is to provide a fast, private, and feature-rich browsing experience — all packaged into a single portable executable that requires no installation.

Whether you want a secondary browser for privacy, a developer tool for testing, or just a lightweight alternative to Chrome/Edge, Searcher Browser has you covered.

🛠️ Technologies Used

Technology Purpose
Python 3.12+ Core programming language powering all browser logic
PyQt6 Cross-platform GUI framework for building the desktop interface
PyQt6-WebEngine Chromium-based web rendering engine for displaying web pages
SQLite Local database for storing history, bookmarks, and passwords
JSON Configuration and settings storage
HTML/CSS/JS Custom start page, error page, and offline page
PyInstaller Packaging the app into a single standalone .exe file

📥 Download Searcher Browser (Latest Release v1.4.0)

Cross-Platform Support! Download pre-built standalone binaries for your operating system below. No complex setups needed!

Platform Recommended Download Package Direct Release Link
🪟 Windows SearcherBrowser-Windows.zip or Searcher.exe ⬇️ Download for Windows
🍎 macOS SearcherBrowser-macOS.zip or Searcher.dmg ⬇️ Download for macOS
🐧 Linux SearcherBrowser-Linux.zip or Searcher.AppImage ⬇️ Download for Linux
📱 Mobile (Android/iOS) SearcherBrowser-Mobile-PWA.zip ⬇️ Download Mobile Package

🚀 Platform Quick Start & Installation

🪟 Windows

  1. Go to Latest Releases.
  2. Download SearcherBrowser-Windows.zip (or portable Searcher.exe).
  3. Extract the .zip file and double-click SearcherBrowser.exe to launch!

🍎 macOS

  1. Go to Latest Releases.
  2. Download SearcherBrowser-macOS.zip or Searcher.dmg.
  3. Double-click the .dmg file to mount it, then drag Searcher.app into your Applications folder.
  4. Launch Searcher from Applications!

🐧 Linux

  1. Go to Latest Releases.
  2. Download Searcher.AppImage or SearcherBrowser-Linux.zip.
  3. Grant execute permission: 
    chmod +x Searcher.AppImage
./Searcher.AppImage

📱 Mobile Phone (Android & iPhone / iPad)

  1. Download SearcherBrowser-Mobile-PWA.zip from Latest Releases.
  2. Extract the package and open assets/start_page.html or mobile/index.html in Chrome/Safari on your mobile device.
  3. Tap the browser menu → Select "Add to Home Screen" to install Searcher Browser as a standalone mobile app!
  4. (Optional for Android Developers) Compile mobile/buildozer.spec with Kivy/Buildozer to output a native .apk.

👉 🌐 View All Releases & Downloads on GitHub

🚀 How to Install & Use Searcher Browser

Installation by Platform

Windows:

  1. Download SearcherBrowserInstaller.exe from releases
  2. Double-click the installer and follow the wizard
  3. Searcher will be added to your Start Menu and Desktop
  4. Done! Launch from Start Menu or Desktop shortcut

macOS:

  1. Download Searcher.dmg from releases
  2. Double-click the .dmg file to mount it
  3. Drag the "Searcher" app into your Applications folder
  4. Open Applications folder and double-click "Searcher"
  5. On first launch, you may need to approve it (System Preferences)

Linux:

  1. Download Searcher.AppImage from releases
  2. Make it executable: chmod +x Searcher.AppImage
  3. Double-click to launch, or run: ./Searcher.AppImage
  4. Create a desktop launcher in your application menu (desktop-specific)

Using the Browser

  1. Browse — Use the address bar at the top to navigate to any website or search the web
  2. New Tabs — Click the + button next to tabs to open new tabs
  3. AI Assistant — Click the AI icon to open the sidebar for page summaries, Q&A, and notes
  4. Bookmarks — Click the star icon to save favorite pages
  5. Search Settings — Go to Settings to configure search engines and themes
  6. Incognito Mode — Use the menu to open private browsing windows
  7. Download Manager — Track your downloads in the Downloads panel

✨ Features

🤖 Built-in AI Assistant

  • Summarize Webpages — Instantly get the gist of long articles or documents.
  • Smart Q&A — Ask questions about the content of the current page.
  • Generate Notes — Automatically create study notes from educational content.
  • Smart Tabs — Uses AI logic to automatically group and organize your tabs by topic.

🛡️ Privacy & Security

  • Native Ad Blocker — Built right into the network interceptor to stop trackers and ads from loading, speeding up page load times.
  • Password Manager — Securely save, manage, and retrieve your credentials across your favorite websites.
  • Incognito Mode — Browse without leaving a trace — no history, cookies, or cache are saved during your session.

📱 Developer Tools & Mobile Emulation

  • Mobile View Toggle — With a single click, emulate a mobile device environment to test responsive designs and mobile-friendly websites.

🔌 Seamless Offline Mode

  • Offline Caching — Searcher caches pages you visit so you can read them even without an internet connection (500 MB disk cache).
  • Offline Search — If you lose connection, the address bar intelligently searches your local history and bookmarks.
  • Offline Mini-Game — Includes a classic dinosaur-style offline game built right in, so you're never bored when the WiFi drops!

⚙️ Productivity

  • Custom Start Page — A blazing-fast, locally hosted new tab page with quick links and an integrated search bar.
  • Full History & Bookmarks — Easily navigate your past web visits and save your favorite pages.
  • Session Restore — Searcher remembers where you left off. Re-open the browser to instantly restore your previous tabs.
  • Download Manager — Track, pause, and manage all your downloaded files in a dedicated interface.
  • Dynamic Theming — Switch seamlessly between carefully crafted Light and Dark modes.
  • Voice Search — Use voice commands to search the web hands-free.
  • Multiple Search Engines — Choose from Google, Bing, DuckDuckGo, and more in Settings.

📂 Project Structure

Searcher/
├── main.py                  # Application entry point
├── browser/                 # Core browser components
│   ├── main_window.py       # Main GUI and layout
│   ├── tabs.py              # Custom tab widget logic
│   ├── navigation.py        # Toolbar and address bar
│   ├── search_engine.py     # Search engine integration
│   ├── history.py           # History dialog
│   ├── bookmarks.py         # Bookmarks manager
│   ├── downloads.py         # Download manager
│   ├── settings.py          # Configuration and settings dialog
│   ├── themes.py            # Dark and light QSS styles
│   ├── ai_service.py        # AI logic and simulation
│   ├── ai_sidebar.py        # Dockable AI assistant UI
│   ├── adblocker.py         # Request interceptor for ads
│   ├── passwords.py         # Password manager dialog
│   └── voice.py             # Voice search simulation
├── database/
│   ├── db_manager.py        # SQLite database operations
│   └── searcher.db          # Auto-generated database file
├── assets/
│   ├── start_page.html      # Custom new tab page
│   ├── error_page.html      # Custom error page
│   ├── offline_page.html    # Offline page with mini-game
│   └── logo.png             # Browser logo
└── config/
    └── settings.json        # Auto-generated settings file

🛠️ For Developers: Run Locally

Prerequisites

  • Python 3.12 or newer installed on Windows.

Installation

# Clone the repository
git clone https://github.com/Amit123103/Searcher_browser.git
cd Searcher_browser

# Install dependencies
pip install PyQt6 PyQt6-WebEngine

# Run the browser
python main.py

📦 Build Standalone Executable

# Install PyInstaller
pip install pyinstaller

# Build the .exe
pyinstaller --noconsole --windowed --onefile --name "Searcher" --add-data "assets;assets" main.py

# The output will be in dist/Searcher.exe

📱 Mobile Version (PWA)

Searcher is now available on mobile! The mobile version is a Progressive Web App (PWA) that works on any phone (Android & iOS).

How to Use on Mobile

  1. Host the files — Deploy the mobile/ folder to a web server (see deployment below).
  2. Open on your phone — Navigate to the hosted URL in your phone's browser (Chrome, Safari, etc.).
  3. Install to Home Screen — Tap "Add to Home Screen" when prompted for a native app-like experience.

Mobile Features

Feature Included
🔍 Web Search (Google) ✅
📑 Tabbed Browsing ✅
⭐ Bookmarks (saved locally) ✅
📜 Browsing History ✅
🤖 AI Assistant Sidebar ✅
🌙 Dark / Light Theme ✅
📝 Scratchpad ✅
📴 Offline Page + Mini Game ✅
📲 Install to Home Screen ✅ (PWA)

Deploy to GitHub Pages (Free Hosting)

# 1. Make sure the mobile/ folder is committed
git add mobile/
git commit -m "Add mobile PWA version"
git push

# 2. Go to your GitHub repo → Settings → Pages
# 3. Set Source to "Deploy from a branch" → main → / (root)
# 4. Your mobile app will be live at:
#    https://amit123103.github.io/Searcher_browser/mobile/

Run Mobile Version Locally

# Use any simple HTTP server (Python example):
cd mobile
python -m http.server 8080

# Then open http://localhost:8080 on your phone (same Wi-Fi network)

🔮 Future Improvements

  • Integrate a live LLM API (e.g., Google Gemini) into ai_service.py.
  • Integrate SpeechRecognition and PyAudio into voice.py for real microphone input.
  • Expand Ad Blocker to support full EasyList parsing.
  • Add browser extension support.

📄 License

This project is open source and available for personal and educational use.

Made with ❤️ by Amit

About

No description, website, or topics provided.

Resources

Readme
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages