GhostShell Browser

GhostShell is a privacy-focused, Electron-based web browser built to resist fingerprinting and online tracking. It supports multiple tabs, bookmarks, history tracking, and applies spoofing techniques to obscure user identity and device characteristics.

🛡️ Features

• 🧭 Tabbed Browsing – Manage multiple web views
• 🔖 Bookmarks & History – Persistent storage via local JSON
• 🕵️‍♂️ Fingerprinting Resistance – Spoofs browser profile attributes
• 🧪 Custom Protocol (ghostshell://) – Custom internal start page
• 📦 Electron-Powered – Built with modern web tech using Node.js and Chromium

🚀 Getting Started

Prerequisites

• Node.js (v16 or higher recommended)
• npm

Install Dependencies

npm install

Run the Browser

npm start

📁 Project Structure

ghostshell-browser/
├── main.js              # Electron main process
├── renderer.js          # UI logic and tab handling
├── preload.js           # Secure context bridging
├── spoof/spoof.js       # Profile spoofing logic
├── index.html           # Main browser UI
├── start.html           # Custom start page (ghostshell://start)
├── data/history.json    # Browsing history storage
├── debug/               # Debug files

🔐 Spoofing Capabilities

The spoofing engine overrides:

• userAgent, platform, language, languages
• screen.width, screen.height
• hardwareConcurrency, deviceMemory
• navigator.userAgentData (brands, platform, etc.)

Spoofed values are applied at runtime using JavaScript property overrides.

📄 License

MIT License

---

🔍 Browse the web in stealth mode – GhostShell makes privacy your default.