Skip to content

Latest commit

 

History

29 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

UltraLightBrowser Logo

UltraLightBrowser 🚀

Ultra-Fast, Minimal, and Hardware-Optimized Windows 11 Native Browser Shell
Powered by Microsoft Edge WebView2 Evergreen Runtime & Modern C++20.

Release Download EXE GitHub Stars GitHub Forks Issues Downloads Platform Standard License


📥 最新版便携下载 / Direct Download (v1.3.2)

可在 GitHub Releases 页面直接下载最新构建的预编译二进制文件:


📖 Overview

UltraLightBrowser is an engineered, bloatware-free Windows 11 desktop browser designed for extreme responsiveness, minimal memory footprint, and full hardware acceleration.

Unlike typical Electron or monolithic Chromium browsers that consume hundreds of megabytes at rest, UltraLightBrowser builds directly upon Windows 11 native Win32 APIs, Per-Monitor V2 High-DPI scaling, and the system-installed Microsoft Edge WebView2 Evergreen Runtime.


⚡ Key Highlights & Benchmarks

Metric Target / Measured Technical Driver
Binary Footprint ~300 KB (Single standalone .exe) Zero-bloat Win32, MSVC /O2 /GL /LTCG /OPT:REF /OPT:ICF
Cold Startup Time <= 0.3s Native Win32 window loop, async WebView2 environment spin-up
Idle / Minimized RAM ~20 MB (Host process working set) EmptyWorkingSet & ICoreWebView2_3::TrySuspend on minimize (Note: Chromium renderers scale per webpage)
Display Scaling Crisp 4K/8K HiDPI DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE_V2
Visual Style Native Windows 11 Immersive Dark Mode (DWMWA_USE_IMMERSIVE_DARK_MODE) & Rounded Corners

🛠️ Architecture & Directory Structure

UltraLightBrowser/
├── CMakeLists.txt              # MSVC 2022 & C++20 maximum optimization build definition
├── vcpkg.json                  # Modern C++ package manager dependencies (WIL, nlohmann-json)
├── packages.config             # NuGet alternative dependency manifest
├── LICENSE                     # MIT License
├── README.md                   # Complete architectural and usage guide
├── resources/
│   ├── app.manifest            # Per-Monitor V2 DPI, UTF-8 code page & Windows 11 OS compatibility
│   └── resource.rc             # Win32 resource definitions
└── src/
    ├── main.cpp                # Win32 wWinMain, High-DPI initialization, and message pump
    ├── MainWindow.hpp/.cpp     # Native Win32 dark frame, Segoe UI toolbar & accelerator dispatch
    ├── WebViewManager.hpp/.cpp # WebView2 Evergreen composition, GPU flags, memory target & audio state
    ├── NativeRequestFilter.hpp/.cpp # Native C++ request interceptor returning HTTP 204 No Content
    ├── DnsManager.hpp/.cpp     # Public DNS (IPv4/IPv6/DoH) management, registry & preferences sync
    ├── ElementBlocker.hpp/.cpp # Zero-flicker pre-render CSS injection & interactive DOM picker
    ├── ExtensionManager.hpp/.cpp # Chrome extensions (MV2/MV3) runtime composition, unpacked loader & management UI
    ├── PowerManager.hpp/.cpp   # Windows 11 EcoQoS E-Core pinning, audio anti-glitch & memory trimming
    ├── Config.hpp/.cpp         # Thread-safe JSON persistence for blocklist & settings
    └── StringUtils.hpp         # Fast URL encode and string parsing utilities

🚀 Core Features

1. 🎵 扁平化进程内音频、Windows 11 EcoQoS 调度与状态感知生命周期 (v1.2.1)

  • 音频与 IPC 扁平化:注入 --disable-features=AudioServiceOutOfProcess 将 AudioService 折叠回主进程,消除跨进程共享内存(Shared Memory Ring Buffer)的 IPC 拷贝与消息同步开销,立减一个子进程(节省 1530MB 物理常驻内存),并从根源消灭跨进程锁竞争导致的播放卡顿。
  • 激进内存压缩目标:对 ICoreWebView2_19 显式设置 put_MemoryUsageTargetLevel(COREWEBVIEW2_MEMORY_USAGE_TARGET_LEVEL_LOW),通知底层 Blink 与 V8 引擎采用极低预算策略,提升 Major GC 频次、缩小内存保留上限并积极清理字体和位图解码缓存。
  • 状态感知生命周期挂起(Audio-aware Lifecycle):
    • 深度接入 ICoreWebView2_8::add_IsDocumentPlayingAudioChanged 监听底层文档音频流状态。
    • 非音频后台页面:窗口最小化或闲置 5 分钟自动深度挂起(TrySuspend())并调用 TrimWorkingSet() 释放物理内存至极限(低至 ~20MB);重新激活时毫秒级唤醒(Resume())。
    • 后台纯音频播放页面:坚决不调用 TrySuspend()(防止音频流水线与 V8 定时器被冻结)。仅调用 put_IsVisible(FALSE) 卸载 DirectComposition 交换链与 GPU 帧光栅化,将 GPU 算力占用完全归零(0 FPS Culling 阻断 GPU 功耗),同时保持音频正常推流。
  • Windows 11 EcoQoS 能效核调度与音频防破音防护:
    • 遍历底层 BrowserProcessId 子进程树,对处于后台且非活跃的渲染子进程调用 SetProcessInformation(ProcessPowerThrottling),注入 PROCESS_POWER_THROTTLING_EXECUTION_SPEED,强制将其绑定在 Intel/AMD 的能效核(E-Core)上运行,抑制功耗与发热。
    • 音频播放期间保持音频渲染线程在标准优先级,严禁打上 EcoQoS,防止能效核降频导致 DPC 调度延迟引发爆音(Buffer Underrun);前台激活时一律取消 EcoQoS 恢复 P-Core 全速调度。

2. 🏎️ Extreme Hardware Acceleration & Network Optimization

Through WebViewManager, the browser injects deep Chromium performance arguments on environment creation:

  • GPU Rasterization & Zero-Copy:--enable-gpu-rasterization --enable-zero-copy --enable-accelerated-video-decode 启用完整硬件解码与零拷贝渲染,保证高清/4K 视频播放丝滑流畅、不掉帧、低功耗。
  • 120Hz 高清流畅刷新率与原生 VSync 同步:通过 --fake-vsync-rate=120 --max-gum-fps=120 锁定 120Hz 垂直同步节拍,完美整除 24/30/60 FPS 视频帧率,消除丢帧与微卡顿,网页快速滚动与超清视频播放丝滑流畅。
  • GPU 纯硬件路径(锁定纯硬解管线,禁用软件降级与过载 CSS 特效):通过 --disable-software-rasterizer --disable-gpu-watchdog --enable-hardware-overlays="single-fullscreen,single-on-top,underlay" --enable-native-gpu-memory-buffers 强制锁定 GPU 纯硬解渲染管线,严禁 CPU 软解回退与降级;针对恶性过载 CSS 特效(如超大半径层叠模糊 backdrop-filter)注入硬件图层隔离保护(transform: translateZ(0)),彻底杜绝掉帧、卡顿与机身过载发热。
  • 激进标签与页面休眠(内存常驻缩减 60%+):集成 --enable-features=HighEfficiencyModeAvailable,PageDiscarding,Freezer,BatterySaverModeAvailable --intensive-wake-up-throttling。切出后台或闲置 5 分钟自动深度挂起(TrySuspend 与 EmptyWorkingSet),常驻内存由数百兆暴降至 20MB 甚至个位数;重新切回时毫秒级瞬时恢复交互。
  • DirectComposition & Presentation:原生 DirectComposition 交换链集成,跨多显示器 DPI 自适应无损渲染。
  • AI Super Resolution:--enable-features=NvidiaVsr,IntelVsr,Prerender2,DnsOverHttps
  • Low-Latency Transport:--enable-quic --enable-async-dns 零延迟异步 DNS 与 QUIC 快速传输。
  • Bloatware Purge:--disable-features=Translate,OptimizationHints,MediaRouter --disable-background-networking --disable-sync --disable-domain-reliability --disable-breakpad --no-pings --disable-speech-api --no-first-run 彻底剔除遥测与后台多余组件。

3. ⚡ 原生网络请求拦截(提速 40%+,省流量 50%+)

内置纯原生 C++ 网络拦截引擎(NativeRequestFilter),放弃挂载动辄消耗几十上百兆内存的重型第三方插件:

  • 底层零开销阻断:基于 WebView2 AddWebResourceRequestedFilter 与 add_WebResourceRequested 原生事件,在 HTTP/HTTPS 网络请求尚未离开本机套接字前进行极速哈希匹配。
  • 内置精准规则特征库:全量拦截主流广告联盟(Google DoubleClick、PageAd、Baidu Pos/Cpro/HM、Tencent GDT、Alibaba Tanx/Alimama 等)及跟踪探针与遥测上报(Google Analytics, CNZZ, Umeng, Hotjar, Clarity, TikTok Ads 等)。
  • 本地瞬时空响应 (204 No Content):对命中目标直接在本地生成 204 空响应并带缓存头,从源头阻断网络 I/O,网页载入提速 40% 以上,实测节省流量超过 50%。
  • 交互式快捷管理:点击工具栏 [ 🛡 Blocker ] 即可实时查看阻断请求数量、一键开启/关闭原生拦截、或清空规则。

4. 🌌 无 UI 沉浸模式(视觉干扰降为零)

  • 全景纯净视界:按下 F9 或 Ctrl + Shift + U(亦可通过 Blocker 菜单)一键开启“无 UI 沉浸模式”。
  • 100% 视口网页填充:顶部导航工具栏、地址栏、控制按钮全部隐藏,整个窗口客户区 100% 留给网页,彻底消除任何界面视觉干扰。
  • 无缝秒级返回:随时再次按下 F9 或 Esc 即可瞬时唤回工具栏。

5. 🌐 公共 DNS 服务器(支持 IPv4 / IPv6 / DoH 加密防劫持)

内置专业公共 DNS 管理中心,一键切换知名国内外优质公共 DNS 服务商,彻底杜绝运营商 DNS 劫持与污染:

  • 知名服务商全覆盖:
    • 阿里公共 DNS (AliDNS):IPv4 223.5.5.5 / 223.6.6.6,IPv6 2400:3200::1 / 2400:3200:baba::1,DoH https://dns.alidns.com/dns-query
    • 腾讯 DNSPod (Public DNS):IPv4 119.29.29.29 / 182.254.116.116,IPv6 2402:4e00:: / 2402:4e00:1::,DoH https://doh.pub/dns-query
    • 百度公共 DNS (Baidu DNS):IPv4 180.76.76.76 / 180.76.76.77,IPv6 2400:da00::6666 / 2400:da00::6667,DoH https://doh.bce.baidu.com/dns-query
    • 114 DNS (南京信风):IPv4 114.114.114.114 / 114.114.115.115,DoH https://114.114.114.114/dns-query
    • Cloudflare (1.1.1.1 极速隐私):IPv4 1.1.1.1 / 1.0.0.1,IPv6 2606:4700:4700::1111 / 2606:4700:4700::1001,DoH https://cloudflare-dns.com/dns-query
    • Google Public DNS (8.8.8.8):IPv4 8.8.8.8 / 8.8.4.4,IPv6 2001:4860:4860::8888 / 2001:4860:4860::8844,DoH https://dns.google/dns-query
    • Quad9 (9.9.9.9 恶意威胁拦截):IPv4 9.9.9.9 / 149.112.112.112,IPv6 2620:fe::fe / 2620:fe::9,DoH https://dns.quad9.net/dns-query
    • Cisco OpenDNS:IPv4 208.67.222.222 / 208.67.220.220,IPv6 2620:119:35::35 / 2620:119:53::53,DoH https://doh.opendns.com/dns-query
    • CNNIC SDNS (国家互联网络信息中心):IPv4 1.2.4.8 / 210.2.4.8,DoH https://doh.sdns.cn/dns-query
    • 自定义 DNS / DoH:自由填入任意标准 DoH 节点 URI。
  • 双模快捷操作:
    • 工具栏快捷菜单:点击 [ 🌐 DNS ] 按钮可一键开启/关闭公共 DNS,或直接单选切换服务商。
    • 完整设置面板:提供完整的 IPv4/IPv6 地址展示、一键复制单条或全部 IP 节点与 DoH 地址自定义。
  • 双重内核级同步应用:自动将安全 DNS 策略同步写入 HKCU\SOFTWARE\Policies\Microsoft\Edge\WebView2 注册表策略以及 Chromium 用户配置 UserData/Default/Preferences,保障权威解析与隐私安全。

6. 🔒 退出时强制清除所有缓存与临时文件(零痕迹无痕浏览保障)

真正做到无痕私密安全,关闭浏览器时即刻执行多层深度粉碎清理,不留任何浏览历史与临时文件:

  • 实时内核级数据擦除:窗口关闭时首先触发 ICoreWebView2Profile2::ClearBrowsingDataAll,在进程退出前完整清理 HTTP 缓存、Cookies、浏览历史、密码自动填充、IndexedDB 及全部 DOM 存储。
  • 进程级优雅同步关闭:追踪底层 Chromium 渲染主进程 PID,关闭 WebView 控制器后等待子进程释放文件句柄,杜绝文件被占用锁定。
  • 物理级磁盘目录粉碎:深入 %LOCALAPPDATA%\UltraLightBrowser\UserData 目录,递归销毁包括 EBWebView 缓存、GPUCache、Code Cache、DawnWebGPUCache、ShaderCache、Crashpad 日志等在内的所有运行时产生的残留文件。
  • 开机/启动二次冗余清理:每次启动浏览器时,在内核初始化前均自动执行全盘冗余清理,确保即便遭遇系统断电或任务管理器强制结束,旧会话也绝不留存任何痕迹。
  • 延时静默自清理兜底:配套独立的延时无窗口后台自毁任务,确保即使极少数字节被杀毒软件异步扫描,也能在退出后瞬间彻底清除。

7. 🛡️ Zero-Flicker Element Hiding & Interactive Picker

ElementBlocker ensures user privacy and ad-blocking without layout shifts:

  • Pre-Render Injection: Injects domain-matched CSS rules via AddScriptToExecuteOnDocumentCreated before DOM construction, preventing ad flash.
  • Interactive DOM Picker (Ctrl + Shift + H): Injects an element inspector with red outlines; clicking an element computes its optimal CSS selector and saves it directly to local JSON storage.

8. 🔋 Power & WorkingSet Memory Optimization

PowerManager dynamically manages system and child processes:

  • EcoQoS Disabling: Traverses process trees to disable PROCESS_POWER_THROTTLING_EXECUTION_SPEED, ensuring maximum frame rates and zero micro-stutters during heavy media playback.
  • Smart Memory Trimming: On WM_SYSCOMMAND (SC_MINIMIZE), signals ICoreWebView2_3::TrySuspend and invokes SetProcessWorkingSetSize(GetCurrentProcess(), (SIZE_T)-1, (SIZE_T)-1) (EmptyWorkingSet), purging unneeded physical pages down to ~20MB.
  • Instant Resume: Restores execution immediately upon SC_RESTORE or focus.

9. 📺 Fullscreen HTML5 Video & Raw-Pixel Adaptive Viewport

  • HTML5 Video Fullscreen: Full support for YouTube, Bilibili, and modern web video players. Automatically transitions the Win32 window to borderless full-screen on the active monitor, hides toolbars, and expands WebView2 bounds smoothly.
  • F11 & Escape Keyboard Control: Seamlessly toggle fullscreen with F11 or exit with Esc across both the browser frame and web contents.
  • Raw-Pixel Viewport Scaling (COREWEBVIEW2_BOUNDS_MODE_USE_RAW_PIXELS): Matches WebView2 bounds 1:1 with Win32 client area physical pixels, eliminating DIP scaling distortion and ensuring webpage layouts adapt dynamically and crisply to any window size, maximization state, or monitor DPI (100%, 125%, 150%, 200%).

10. 🔍 页面缩放与实时比例指示 (Page Zoom & Interactive Indicator)

  • 全套快捷键支持:
    • Ctrl + + / = : 放大页面(逐步放大至最高 500%)
    • Ctrl + - : 缩小页面(逐步缩小至最低 25%)
    • Ctrl + 0 : 一键重置页面缩放为 100%
    • Ctrl + 鼠标滚轮 : 原生平滑滚轮缩放
  • 工具栏实时比例指示:工具栏显式内置缩放百分比按钮(如 🔍 100%),与网页当前缩放比例保持双向实时同步。
  • 快速预设菜单:点击缩放按钮即可唤出原生快捷菜单,支持一键切换预设比例(25%、33%、50%、67%、75%、80%、90%、100%、110%、125%、150%、175%、200%、250%、300%、400%、500%),并在当前比例项显示勾选标。
  • 双层全局按键拦截:无论焦点在页面 DOM 内部还是在 Win32 地址栏/工具栏,快捷键均由底层直接拦截派发,实现无缝缩放体验。

11. 🧩 Chrome 扩展程序全面支持、解压加载与管理中心 (Chrome Extensions Manager)

基于 Microsoft Edge WebView2 Evergreen 内核扩展 API,提供完整的 Chrome 扩展程序生命周期支持:

  • WebView2 内核扩展生态全面打通:
    • 初始化环境时注入 ICoreWebView2EnvironmentOptions6::put_AreBrowserExtensionsEnabled(TRUE),开启 Chromium 原生扩展运行时。
    • 完美支持现代 Chrome 扩展标准(涵盖 Manifest V2 与 Manifest V3 核心架构),包括 Content Scripts 注入、Background Service Worker、DOM 拦截、存储 API 及扩展独立页面。
  • 加载未打包的扩展程序 (Load Unpacked Extension):
    • 现代原生目录选择器:集成 Windows 11 原生 IFileOpenDialog(支持系统级文件夹快速浏览与定位)。
    • 深度多层安全校验:自动进行路径规范化(canonical path),严格阻断系统级核心目录(如 C:\Windows、C:\Program Files、驱动器根盘符)的恶意挂载风险。
    • 智能清单语法解析器:全自动校验 manifest.json,支持 _locales 多语言国际化映射(智能提取并呈现扩展本地化中文/英文真实名称,如将 __MSG_appName__ 还原为人类可读名称)。
    • 即开即用热加载:基于 ICoreWebView2Profile7::AddBrowserExtension,无需重启浏览器,解压目录秒级注册并生效。
  • 现代原生扩展程序交互与管理中心 (Fluent Dark Extensions UI):
    • 顶栏层级菜单与丰富快捷操作:
      • 工具栏 [ 🧩 扩展 ] 顶部直接列出全部已安装扩展(附带 🟢 已启用 / ⚪ 已停用 状态与版本号)。
      • 鼠标悬停/点击任意扩展即展开专用二级菜单:支持 🌐 打开扩展界面/选项、⏸ 停用扩展 / ▶ 启用扩展、🔄 重新载入扩展、📁 打开本地安装目录、📋 复制扩展 ID、🗑️ 从浏览器中移除扩展。
      • 底部清晰归类:⚙️ 扩展程序管理中心 (详细视图)...、📂 加载未打包的扩展程序目录...、🔄 重新载入并同步全部扩展程序。
    • 现代化 Windows 11 暗黑管理窗口 (Fluent Dark Inspector Deck):
      • 完美沉浸式深色模式(Immersive Dark Mode + DarkMode_Explorer 原生深色列表主题),告别传统 Win32 刺眼白屏。
      • 高清 DPI 动态缩放(Per-Monitor V2 DPI Awareness)与支持自由缩放/最大化窗口(动态响应式流畅布局)。
      • 移除全局强制置顶(WS_EX_TOPMOST),避免阻挡其他程序;双击列表项直接打开扩展界面。
      • 现代化 Inspector 检查器卡片(Fluent Rounded Card Deck):清晰呈现大字号名称标题、运行状态徽章、多行描述、等宽 ID/路径快速复制与一键操作控制栏。
  • 智能数据持久化与安全无痕清理平衡:
    • 已加载的解压扩展路径与开关状态持久化保存于 %LOCALAPPDATA%\UltraLightBrowser\config.json,下次启动全自动无感恢复。
    • 支持“退出时保留扩展程序配置与解压加载项”开关;在保留扩展的同时,依然自动粉碎 HTTP 临时缓存、GPU/Shader 缓存与浏览痕迹,兼顾极速安全与无痕隐私。

🛡️ 功能审计报告 (Security & Code Audit Report)

本模块针对新增的 Chrome 扩展加载、扩展管理及未打包扩展解析功能进行了全方位的安全性、稳定性、并发性与资源管理审计:

1. 安全性审计 (Security Audit)

审计项 潜在风险点 实施防护与缓解措施 审计结论
目录遍历与敏感目录挂载 恶意路径指向系统核心文件 (C:\Windows 等) 或网络 UNC 共享路径导致越权执行 采用 std::filesystem::weakly_canonical 标准化路径,显式比对并禁止系统级核心目录 (System32, Windows, Program Files) 及驱动器根目录挂载。 ✅ PASSED (零越权风险)
清单解析与 JSON 注入 畸形 manifest.json 或超长字符串可能引发缓冲区溢出或崩溃 采用工业级 nlohmann::json 安全解析并置于严格 try-catch 保护中;校验必需字段 manifest_version,异常输入优雅报错提示。 ✅ PASSED (鲁棒防护)
国际化资源解析攻击 恶意构造 __MSG_ 占位符引发无限递归或路径跳转 限制白名单语言包目录扫描 (zh_CN, zh, en, en_US, en_GB),仅执行受控单级查找,不存在递归死循环。 ✅ PASSED (安全无溢出)
沙箱隔离与权限边界 扩展脚本是否会逃逸影响宿主 Win32 主进程 所有扩展的 JavaScript、Content Scripts 与 Service Worker 严格运行在 Chromium 沙箱渲染子进程中,宿主 Win32 主进程仅持有 COM 代理句柄,物理级内存隔离。 ✅ PASSED (沙箱隔离完备)
剪贴板溢出安全 复制扩展 ID 时发生内存截断或空指针写 采用 GlobalAlloc(GMEM_MOVEABLE) 严格计算 (length + 1) * sizeof(wchar_t),配对 GlobalLock/GlobalUnlock 并确保 Null-Terminated。 ✅ PASSED (内存安全)

2. 内存与资源生命周期审计 (Memory & Resource Audit)

  • COM 引用计数正确性:全面采用 wil::com_ptr(Windows Implementation Library)管理 ICoreWebView2BrowserExtension、ICoreWebView2Profile7、IFileOpenDialog,消灭手动 AddRef/Release 遗漏风险,析构自动归零。
  • Win32 GDI 泄漏防范:管理窗口在 WM_DESTROY 消息中严格释放全部动态创建的 GDI 对象(DeleteObject(ctx->hFont)、DeleteObject(ctx->hBrushBg) 等),杜绝 GDI 句柄泄漏。
  • WRL 异步回调安全性:WebView2 扩展操作均为异步驱动(CompletedHandler),回调内部通过局部值捕获而非裸指针解引用,确保当对话框关闭后,晚到的底层 COM 消息不会引发野指针或 Use-After-Free 崩溃。

3. 并发与线程安全审计 (Concurrency Audit)

  • 多线程数据竞争防护:Config 与 ExtensionManager 内部的扩展配置列表均由 mutable std::mutex 与 std::lock_guard 全程保护,支持并发读取与线程安全存盘。
  • STA 线程契约:严格遵循 WebView2 STA(单线程套间)规范,所有扩展 COM API 交互及 UI 刷新均调度在主消息循环线程内执行,杜绝跨线程 RPC 锁死。

4. 健壮性与兼容性审计 (Compatibility Audit)

  • 运行时版本优雅降级:通过 QueryInterface(IID_PPV_ARGS(&profile7)) 动态嗅探当前系统的 WebView2 Evergreen 运行时是否支持扩展接口;在旧版环境或无扩展运行时下弹出友好中文指引,严禁硬崩溃。
  • 双模式数据粉碎兼容:当用户开启“保留扩展配置与设置数据”时,退出阶段切换为精准清洗易失性缓存,既保证了无痕清理的核心特性,又防止扩展自建规则与登录凭证被误删。

💻 Building from Source

Prerequisites

  • Operating System: Windows 11 (x64)
  • Compiler: Microsoft Visual Studio 2022 (with Desktop development with C++)
  • Build System: CMake >= 3.25
  • Package Manager: vcpkg or NuGet
  • Runtime: Microsoft Edge WebView2 Evergreen Runtime (pre-installed on Windows 11)

Option A: Build with vcpkg (Recommended)

# Clone the repository
git clone https://github.com/Freecode100Year/UltraLightBrowser.git
cd UltraLightBrowser

# Configure with vcpkg toolchain
cmake -B build -S . -DCMAKE_TOOLCHAIN_FILE="$env:VCPKG_ROOT/scripts/buildsystems/vcpkg.cmake"

# Build optimized Release binary
cmake --build build --config Release

# Output executable:
# .\build\Release\UltraLightBrowser.exe

Option B: Build with NuGet

# Restore NuGet packages
nuget restore packages.config -PackagesDirectory packages

# Configure with CMake
cmake -B build -S .

# Build
cmake --build build --config Release

⌨️ Shortcuts

  • F11 : Toggle Fullscreen Mode
  • F9 / Ctrl + Shift + U : Toggle Zero-UI Immersive Mode (一键无 UI 沉浸模式)
  • Esc : Exit Fullscreen & Immersive Mode / Reset Address Bar
  • Ctrl + + / = : Zoom In (放大页面)
  • Ctrl + - : Zoom Out (缩小页面)
  • Ctrl + 0 : Reset Zoom to 100% (重置缩放)
  • Ctrl + 鼠标滚轮 : Smooth Zoom (平滑滚轮缩放)
  • Ctrl + L : Focus Address Bar
  • Ctrl + Shift + H : Toggle Interactive Element Hiding / Picker Mode
  • Ctrl + R / F5 : Reload Current Page
  • Alt + ← : Navigate Back
  • Alt + → : Navigate Forward

⭐ Star History

Star History Chart

If you find UltraLightBrowser useful, please give it a ⭐ on GitHub! Your support motivates continuous improvement.


📄 License

This project is licensed under the MIT License.

About

Minimal, Ultra-Fast, and Hardware-Optimized Windows 11 Native Browser Shell powered by Edge WebView2 and C++20

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages