# Features

This document provides a detailed overview of the features available in Nebula.

### Privacy Control

Nebula is designed with your privacy in mind. You have granular control over your browsing data.

-   **Clear Browsing Data:** You can easily clear your browsing history, cookies, cache, and local storage. This can be done from the settings page.
-   **No Tracking by Default:** Nebula does not collect any personal data for tracking or advertising purposes.

### Tab Management

Efficiently manage your browsing session with Nebula's tab management features.

-   **New Tabs:** Open new tabs to browse multiple websites at once.
-   **Tab Controls:** Each tab has standard controls for closing.
-   **Open in New Window:** You can pop a tab out into its own separate window.

### Bookmarks

Save and access your favorite websites with ease.

-   **Add Bookmarks:** Save the current page to your bookmarks.
-   **View Bookmarks:** Access your saved bookmarks from the bookmarks bar or a dedicated page.

### History

Nebula keeps a record of your browsing and search history to help you find your way back to previously visited sites.

-   **Site History:** A list of all the websites you have visited.
-   **Search History:** A list of all the searches you have made.
-   **Clear History:** You can clear your history at any time from the settings page.

### Downloads Manager

Reliably download files with progress and controls.

-   **Progress & State:** Each download shows received/total bytes and status.
-   **Pause/Resume/Cancel:** Control active downloads where the server supports resuming.
-   **Open or Reveal:** Open downloaded files directly or show them in your file manager.
-   **Safe Filenames:** Files are saved to your OS Downloads folder with automatic de-duplication.

### Performance Monitoring

Nebula includes built-in tools to help you monitor the browser's performance.

-   **Performance Report:** View a detailed report of performance metrics, including page load times and memory usage.
-   **Force Garbage Collection:** Manually trigger garbage collection to free up memory.

### GPU Acceleration Control

For advanced users, Nebula provides tools to manage GPU acceleration.

-   **GPU Diagnostics:** View detailed information about your system's GPU and its status.
-   **GPU Fallback:** If you experience rendering issues, you can apply a GPU fallback to use a more stable rendering path. This can help resolve visual glitches or crashes.

### Native Context Menu

Nebula provides a native right-click menu across pages and webviews.

-   **Navigation:** Back, Forward, Reload.
-   **Links:** Open in new tab, Download link, Open externally, Copy address.
-   **Images:** Open in new tab, Save image as, Copy image address.
-   **Editing:** Undo/Redo, Cut/Copy/Paste, Select All when applicable.
-   **Developer:** Inspect Element (opens DevTools docked by default).

### Authentication & Web Compatibility

-   **OAuth/SSO Friendly:** Popup windows are allowed for http/https to support common login flows.
-   **WebAuthn Diagnostics:** Platform authenticator features are enabled where supported and logged for troubleshooting.
-   **Sturdy Navigation:** Login POST navigations are not intercepted by the main process.

### Custom Themes & Customization

Nebula offers extensive customization options to personalize your browsing experience.

-   **Theme System:** Choose from built-in themes (default, forest, ocean, sunset, cyberpunk, midnight-rose, arctic-ice, cherry-blossom, cosmic-purple, emerald-dream, mocha-coffee, lavender-fields) or create your own custom themes.
-   **Live Theme Editor:** Modify colors, gradients, and layout options with real-time preview in the settings.
-   **Import/Export Themes:** Share custom themes with the community or use themes created by other users.
-   **Non-Destructive Design:** All customizations are stored separately and can be reset to default at any time.
-   **Layout Options:** Switch between centered, sidebar, and compact view layouts.
-   **Custom Branding:** Personalize the browser title and logo visibility.

For detailed information about creating and managing themes, see the [Customization Guide](Customization.md).

### Cross-Platform

Nebula is built with Electron, allowing it to run on multiple operating systems.

-   **Windows, macOS, and Linux:** Enjoy a consistent browsing experience across different platforms.

### Miscellaneous

-   **User Agent Strategy:** Electron token is removed from the default user agent to improve site compatibility while appending a `Nebula/x.y.z` marker. You can opt-in to include the Electron token by setting `NEBULA_DEBUG_ELECTRON_UA=1`.
-   **Open Local Files:** Use the file picker to open `file://` URLs directly.
