# SharpBrowser **Repository Path**: shenhxBase/SharpBrowser ## Basic Information - **Project Name**: SharpBrowser - **Description**: No description available - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 0 - **Created**: 2025-05-05 - **Last Updated**: 2025-06-11 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README ![SharpBrowser](https://github.com/sharpbrowser/SharpBrowser/raw/master/images/logo3.png) SharpBrowser is the fastest and most full-featured open source C# web browser there is! Slightly faster than Google Chrome when rendering web pages due to lightweight CEF renderer. We compared every available .NET browsing engine and finally settled on the high-performance [CefSharp](https://github.com/cefsharp/CefSharp/). Released under the permissive MIT license. ## Features ![SharpBrowser](https://github.com/sharpbrowser/SharpBrowser/raw/master/images/topbar.png) ### Modern - [HTML5, CSS3, JS, Video, PDF, WebGL, WebAssembly, WebRTC, WebMIDI](#screenshots) - Tabbed browsing with website favicons - Address bar (also opens Google or any search engine) - Back, Forward, Stop, Refresh, Home, Menu button - Print and Print to PDF - Search bar (also highlights all instances) - File downloads and download manager - View online & offline webpages - Fullscreen mode ### Smart - [Hotkeys for all features](#hotkeys) - Saves open tabs and resumes the browsing session when reopened - Saves cookies and web cache in the `AppData` folder - Saves application settings in a custom JSON file - Saves favicons in a disk cache for fast reuse - Developer tools - Web app permission handling - Popups open in new tabs ### Extensible - [Easily add your own branding, styling, buttons or hotkeys](#customization) - Custom error pages - Custom context menu - Custom application main menu - Custom settings - Custom installer package using InnoSetup ## Hotkeys Hotkeys | Function ------------ | ------------- Ctrl+MouseWheel | Zoom in/out Ctrl+T | Add a new tab Ctrl+W | Close active tab Ctrl+MiddleClick | Close Tab F5 | Refresh active tab F11 | Toggle fullscreen F12 | Open developer tools Ctrl+Tab | Switch to the next tab Ctrl+Shift+Tab | Switch to the previous tab Ctrl+F | Open search bar (Enter to find next, Esc to close) Ctrl+P | Print Ctrl+Shift+P | Print to PDF ## Documentation - See the [Compilation Guide](docs/Compilation.md) for steps to get started. - See the [Distribution Guide](docs/Distribution.md) to create a custom setup installer. ### System requirements - You need .NET 8 on Windows 64-bit. - You need [VC++ 2019 Runtime](https://aka.ms/vs/17/release/vc_redist.x64.exe) (64-bit) - You might need [VC++ 2017 Runtime](https://www.microsoft.com/en-in/download/details.aspx?id=48145) (64-bit) - You need to install the version of VC++ Runtime that CEFSharp needs. As per our CefSharp version, according to [this](https://github.com/cefsharp/CefSharp/#release-branches), we need the above versions ### Customization - To customize the browser branding, name, URL, default search engine, default proxy, modify the `BrowserConfig` class. - To customize the application icon, change `sharpbrowser.ico` inside the `Resources` folder. - To customize the tab size and tab colors, modify the `BrowserTabStyle` class. - To enable or disable Web Camera, Microphone, Javascript, WebGL, WebRTC, WebMIDI, LocalStorage, modify the `BrowserConfig` class. - To register hotkeys for your own commands, modify the `HotkeyManager` class. - To register your own commands into the main menu, open the form designed for `MainForm` and click the `MainMenu` object. Add `IconMenuItem` objects into that menu. - To register your own commands into the page context-menu, modify `ContextMenuHandler.OnBeforeContextMenu` function, and then implement the command inside `ContextMenuHandler.OnContextMenuCommand`. - To setup how web app permissions are handled, modify `PermissionHandler.OnShowPermissionPrompt` (some flags are already inside `BrowserConfig` and can easily be changed). - To add new settings saved in the JSON file, simply call `ConfigManager.Get*` and `ConfigManager.Set` anywhere in your code. It will save into the file automatically. ### Code - SharpBrowser uses CefSharp 134 and is built on NET. - SharpBrowser only supports Windows x64 platform. - `MainForm.cs` - main web browser UI and related functionality - `Managers` - classes that manage various types of browsing functionality, like settings, downloads and hotkeys - `Handlers` - various handlers that we have registered with CefSharp that enable deeper integration between us and CefSharp - `bin` - Binaries are included in the `bin` folder due to the complex CefSharp setup required. Don't empty this folder. - `bin/storage` - HTML and JS required for downloads manager and custom error pages ## Screenshots
Apple.com
Google Maps
WebGL (test)
PDF Viewer
Web Camera (test)
WebMIDI (test)
WebAssembly (test)
YouTube
Search Bar
Main Menu
Downloads Tab
Developer Tools
Custom Error Page 1
Custom Error Page 2