🌌 Neutrino Browser

A modern, privacy-first desktop web browser built with Python & PyQt6, powered by the Tor network.

Fast • Secure • Anonymous • Customizable Proudly developed in 🇮🇳 India

---

---

✨ Overview

Neutrino Browser is a sleek, next-generation desktop browser focused on privacy, security, and aesthetics. It seamlessly integrates with the Tor network, giving users anonymity by default, while offering a beautiful modern UI and powerful productivity tools.

Built entirely with Python + PyQt6, Neutrino combines performance, flexibility, and deep customization — without compromising user privacy.

---

🛡️ Privacy & Security

• 🔒 Native Tor Integration Automatically routes traffic through the Tor network with real-time connection status.

• 🧠 Security Levels Choose between Standard / Safer / Safest modes to control JavaScript, APIs, and risky features.

• 🍪 Advanced Privacy Controls Manage cookies, trackers, permissions, and browser data with ease.

• 🔐 Modern Security Indicators Clear HTTPS and security state icons in the URL bar.

---

🎨 Modern User Experience

• 🖌️ Advanced Theme Engine 15+ built-in themes (Dark, Light, Solarized, Gruvbox, Dracula & more)

  • Create, edit, and save your own custom themes.

• 🪟 Frameless Modern Window Custom-drawn title bar, window controls, and smooth animations.

• 🆕 Custom New Tab Page Minimal, elegant dashboard with:

  • Search bar
  • Frequently visited sites
  • Custom background support

• 🌐 Enhanced URL Bar Thick borders, focus highlights, and improved visibility.

• 💬 Consistent UI Dialogs All popups, alerts, and JavaScript dialogs follow the same modern design language.

---

⚙️ Core Browser Features

• 📑 Tabbed Browsing (Movable & Closable)
• 🔇 Per‑Tab Audio Muting
• 🔄 Session Restore (Continue where you left off)
• ⭐ Bookmarks Bar with Folders
• ⬇️ Integrated Download Manager (neutrino://downloads)
• 🕘 Rich Browsing History (neutrino://history)
• 🔍 Find in Page (Ctrl + F)
• 📺 Picture‑in‑Picture (PiP) Video Mode

🧰 Extra Utilities

• 🧾 Save webpages as PDF
• 📱 Generate QR codes for page URLs
• 🧹 One‑click Clear Browsing Data

---

🛠️ Developer & Power‑User Tools

• 🧩 Application Builder

  🔹 Site‑Specific App Builder

  Turn any website into a standalone desktop app:

  • Locked single‑site window
  • Custom name & icon
  • Native taskbar integration

  🔹 Full Browser Builder

  Create and distribute your own custom‑branded Neutrino Browser:

  • Custom update source
  • Modified defaults
  • Shareable builds

• 🧪 Developer Tools View Source • Inspect Element

• 🔄 Automatic Updates GitHub-based update checks with notifications

• ⚙️ Advanced Settings Hardware acceleration • User‑Agent • Tor toggles

---

🚀 Installation

🔧 Requirements

• Python 3.8+
• Git
• Tor Service (recommended for full privacy)

---

📥 Clone Repository

git clone https://github.com/SouvikNandi2004/Neutrino-Browser.git
cd Neutrino-Browser

---

🐍 Virtual Environment (Recommended)

python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

---

📦 Install Dependencies

Windows / macOS

pip install -r requirements.txt

Runtime only:

pip install PyQt6 PyQt6-WebEngine qrcode[pil] packaging

Debian / Ubuntu / Kali

sudo apt update
sudo apt install python3-pyqt6 python3-pyqt6.qtwebengine python3-pyqt6.qtsvg python3-qrcode python3-pil python3-packaging

Arch Linux

sudo pacman -S python-pyqt6 python-pyqt6-webengine python-pyqt6-svg python-qrcode python-pillow python-packaging

---

🧅 Tor Setup

# Debian / Ubuntu / Kali
sudo apt install tor
sudo systemctl start tor
sudo systemctl enable tor

Check status:

systemctl status tor

Neutrino will automatically detect Tor when running.

---

▶️ Run Neutrino Browser

python main.py

---

⚠️ Disclaimer

Neutrino Browser is provided as‑is. The developer is not responsible for illegal, harmful, or unethical activities performed using this software.

Use responsibly.

---

📄 License

Licensed under the MIT License.

---

📬 Contact

Souvik Nandi 📧 Email: souviknandi.11.2004@gmail.com 💬 Telegram: https://t.me/SouvikNandi1

🔗 Project: https://github.com/SouvikNandi2004/Neutrino-Browser

---

⭐ If you like this project, consider starring it on GitHub!