Nebula

A customizable and privacy-focused web browser built with Electron. Nebula is designed to be a lightweight, secure, and user-friendly browser with a focus on performance and privacy.

Features

• Privacy Control: Easily clear your browsing data (history, cookies, cache, local storage, and more).
• Tab Management: Open new tabs, pop a tab out into a new window, and manage them efficiently.
• Bookmarks: Save your favorite sites with automatic backup on save.
• History: Keeps track of your browsing and search history with one-click clear.
• Downloads Manager: Track downloads, pause/resume/cancel, and open or reveal completed files.
• Context Menu: Native right‑click menu with Back/Forward/Reload, open/download links, image actions, and Inspect Element.
• Auth Compatibility: Improved OAuth/SSO & WebAuthn support (popup windows enabled where needed).
• Performance Monitoring: Built-in tools to monitor app performance and force GC when needed.
• GPU Acceleration Control: Diagnostics and safe fallbacks to troubleshoot rendering issues.
• Themes & Customization: Built-in themes and live editor to craft your own.
• Plugins: Extend Nebula with custom or community plugins via a simple plugin API.
• Cross-Platform: Runs on Windows, macOS, and Linux.

Learn more about Nebula's features.

Getting Started

Prerequisites

• Node.js installed.

Installation

1. Clone the repository:

   git clone https://github.com/Bobbybear007/NebulaBrowser.git
   

2. Navigate to the project directory:

   cd NebulaBrowser
   

3. Install dependencies:

   npm install
   

Running the Application

To start the browser, run the following command:

npm start

Building the Application

To build the application for your platform, run:

npm run dist

This will create a distributable file in the dist directory.

Tip (Windows): If you encounter GPU issues, try starting with start-gpu-safe.bat to launch in a safer rendering mode.

Project Structure

An overview of the project's structure. For a more detailed explanation, please see the Project Structure documentation.

• main.js: The main entry point for the Electron application.
• renderer/: Contains all the front-end files.
• preload.js: Bridges the main and renderer processes.
• performance-monitor.js: Module for monitoring performance.
• gpu-config.js & gpu-fallback.js: Modules for managing GPU settings.
• assets/: Contains static assets.
• documentation/: Contains additional documentation.
• plugins/: Sample plugins and scaffolding for developing your own.

Core Concepts

Nebula is built on several core concepts that are essential to understanding how it works. For a deeper dive, read the Core Concepts documentation.

• Main and Renderer Processes
• Inter-Process Communication (IPC)
• Performance and GPU Management

Contributing

Contributions are welcome! Please read our contributing guidelines to get started.

Technologies Used

• Electron
• HTML, CSS, JavaScript

License

This project is licensed under the MIT License. Read More

Documentation

• MIT License
• GPU Fix
• Features
• Customization
• Project Structure
• Core Concepts
• Contributing Guide
• OAuth Debug
• Plugins Guide