Cefious Web Browser

Cefious Web Browser brings Chromium-powered web technology directly into Unity, letting you run modern web experiences inside your app without opening an external browser. It also allows you to create fully local websites for your game, perfect for in-game interfaces, tools, and content.

Build in-game web views, dashboards, launchers, account portals, patch notes, storefronts, and internal tools with a developer-first workflow focused on reliability, flexibility, and production-ready performance.

Supports Unity Version 2022.3.62f3 + (fully tested on Unity 6+)

User-Facing Features
- Chromium-based rendering for modern website compatibility
- Tabbed browsing with dynamic tab creation and active tab switching
- Session history and favorites/bookmarks
- Stored website icons/favicons and retained browsing data
- Multi-download support with progress display and cancellation
- Zoom controls for browser content readability
- Web media playback support, including WebM/YouTube scenarios
- View Source in new tab support

Developer & Integration Features
- Ready to go Prefab with zero setup for use with Unity Canvas
- Native-feeling Unity integration for runtime and tooling workflows
- JavaScript ↔ C# bridge for two-way communication and argument passing
- Included JS Executor for direct script execution and event invocation
- Event-driven architecture with built-in hooks and custom extension points
- Programmable navigation, custom controls, and interaction handling
- AudioSource bridge to route browser audio through Unity audio pipelines
- Console/debug utilities for faster testing and troubleshooting
- Popup interception with configurable new-tab or same-tab fallback

Cefious includes a clean, feature-rich browser UI, but the UI is fully optional.
- Use the included UI as-is, customize it, or replace it completely
- Easy to adapt to your own prefabs, Canvas setup, and design language
- Supports both Overlay Canvas and World Space (3D) Canvas
- Scalable layout suitable for many screen resolutions
- Includes PSB and Affinity Designer templates to speed up visual customization

Context Menu & Interaction Control
- Custom context menu system with page-aware actions
- Built-in actions include copy, paste, open link, open in new tab, download, and save/copy image
- Add your own context actions or modify built-in behavior

URL Rewrite, Local Sites & Security
- URL Rewriter can map incoming URLs to custom targets, including local hosted content
- Build fictitious in-game websites from project content (example workflow included)
- Build-time security restrictions can limit which host/domain rules are allowed, helping reduce misuse
- Rewrite rules support custom security indicators: Configurable labels, Configurable active/inactive security icons per rule, Optional global icon/label overrides for consistent UX
- Address bar can display rewrite/fictitious state clearly so users understand when content is locally mapped

Remote Debugging
- CEF remote debugging can be enabled with a configurable local port (default commonly 9222)
- http://localhost:9222When enabled, Cefious exposes a local inspector endpoint such as:
- Open that URL in Chrome, Edge, or another Chromium-based browser to inspect active Cefious pages
- This lets you use familiar browser devtools workflows (DOM/CSS/script/network diagnostics) against pages running inside Unity

UI Flexibility
Whether you are building immersive in-game web experiences or robust developer tooling, Cefious Web Browser gives you a production-ready browser backend with an optional UI layer you can keep, adapt quickly, or fully replace.

Platform Support & Current Limitations
- Windows: Fully supported now.
- macOS: Planned for a future update.
- Video codecs/licensing: Some video playback scenarios may be limited without appropriate FFmpeg licensing/configuration.
- VR: Not yet fully validated/tested in production VR workflows; planned improvements and validation are targeted for a future update.

Future updates:
Cefious currently targets Windows (64-bit). macOS and expanded VR validation are planned in upcoming updates.

Third-Party Notices
Cefious includes third-party components.
This asset includes Chromium Embedded Framework (CEF), licensed under the BSD 3-Clause License.
This asset also includes Noto Sans font files from Google Fonts, licensed under the SIL Open Font License 1.1.
Third-party notice and license files are included inside the asset at:
Assets/Cefious Web Browser/notices.txt
Assets/Cefious Web Browser/ThirdPartyLicenses/