Vivaldi Plus

中文 | English

---

中文

功能特性

• 便携设计 - 程序放在App目录，数据放在Data目录（不兼容原版数据，可以重装系统换电脑不丢数据）
• 移除更新警告 - 因为是绿色版没有自动更新功能，移除更新错误警告
• 密码便携化 - 密码数据可跨机器使用，不绑定硬件ID

注意： 本程序已经移除之前的标签页增强功能，因为Vivaldi大部分功能已经内置，现在只保留便携化核心功能：

• 双击鼠标中键关闭标签页
• 保留最后标签页
• 鼠标悬停标签栏滚动
• 按住右键时滚轮滚动标签栏

自定义配置

本DLL提供配置选项，在DLL同目录新建 config.ini 文件即可配置。

快速开始

1. 复制 config.ini.example.zh-CN 为 config.ini
2. 根据需要修改配置项（通常使用默认值即可）
3. 重启浏览器

配置文件说明

完整配置示例：

[general]
# Win32k 系统调用策略
# win32k=0 (推荐) - 保持默认沙箱，确保 GPU 硬件加速和视频流性能
# win32k=1 (兼容) - 仅当 Chrome 启动崩溃时使用，可能影响视频播放质量
win32k=0

# 调试日志
# debug_log=0 (默认) - 不输出调试日志
# debug_log=1 (故障排除) - 输出调试日志 (使用 DebugView 查看)
debug_log=0

# Chrome 禁用特性
# 留空使用默认值 (推荐): WinSboxNoFakeGdiInit,WebUIInProcessResourceLoading
# 或自定义您需要的特性
disable_features=

# 额外的命令行参数
command_line=

[dir_setting]
# 数据目录（用户配置、书签、扩展等）
data=%app%\..\Data

# 缓存目录（临时文件）
# 性能提示: 建议放在 SSD 上以获得最佳视频流性能
cache=%app%\..\Cache

[hotkey]
# 老板键 - 快速隐藏/显示浏览器并静音/取消静音
# 格式: Ctrl+Alt+B 或 Win+H 等
# 留空则禁用此功能
boss_key=

配置项详解

[general] 部分

• win32k (默认: 0)

  • 0 - 推荐设置 🟢
    • 保持 Chrome 默认沙箱安全策略
    • 确保 GPU 硬件加速正常工作
    • 视频流性能最佳 (Twitch, YouTube 等)
    • CPU 占用低 (10-20%)
  • 1 - 兼容模式 🟡
    • 仅当浏览器启动崩溃时使用
    • 可能修复某些杀毒软件冲突 (如 Symantec, McAfee)
    • ⚠️ 可能导致视频硬件解码失败
    • ⚠️ Twitch/YouTube 可能播放质量降低
    • ⚠️ CPU 占用增加 (50-80%)

• debug_log (默认: 0)

  • 0 - 不输出调试日志，性能影响最小
  • 1 - 输出调试日志用于故障排除
    • 通过 OutputDebugString 输出（使用 DebugView 查看）
    • 记录命令行参数、错误和便携模式操作
    • 仅在调查问题时使用

• command_line (默认: 空)

  • 额外的 Chrome 命令行参数
  • 示例: command_line=--force-dark-mode --enable-features=WebUIDarkMode

• disable_features (默认: WinSboxNoFakeGdiInit,WebUIInProcessResourceLoading)

  • 指定要禁用的 Chrome 特性
  • 留空或不指定: 使用默认兼容性特性 (推荐)
  • 指定值: 使用您的自定义特性 (替换默认值)
  • 常用特性:
    • WinSboxNoFakeGdiInit - 修复 GPU 初始化问题
    • WebUIInProcessResourceLoading - 改善 WebUI 兼容性
    • RendererCodeIntegrity - 允许 DLL 注入
    • AutofillServerCommunication - 禁用自动填充同步
    • TranslateUI - 禁用翻译提示
  • 示例:

    # 使用默认 (推荐)
    disable_features=
    
    # 自定义特性
    disable_features=RendererCodeIntegrity,TranslateUI
    
    # 添加更多特性
    disable_features=WinSboxNoFakeGdiInit,WebUIInProcessResourceLoading,TranslateUI

[dir_setting] 部分

• data (默认: %app%\..\Data)

  • 用户数据目录（配置文件、书签、扩展等）
  • 支持格式:
    • 相对路径: data=..\Data
    • 绝对路径: data=C:\MyBrowser\Data
    • 环境变量: data=%LOCALAPPDATA%\VivaldiPlus\Data
    • %app% 变量: data=%app%\..\Data

• cache (默认: %app%\..\Cache)

  • 缓存目录（临时文件、媒体缓存等）
  • 性能提示:
    • 建议放在 SSD 上（非机械硬盘）
    • 确保至少 2GB 剩余空间
    • 避免网络驱动器

[hotkey] 部分

• boss_key (默认: 空，禁用)
  • 老板键 - 快速隐藏/显示浏览器并静音/取消静音
  • 功能:
    • 按下热键立即隐藏所有 Vivaldi 窗口并静音所有音频
    • 再次按下恢复窗口并取消静音
    • 全局热键（系统范围有效）
  • 格式: 修饰键+修饰键+按键
    • 修饰键: Ctrl (或 Control)、Alt、Shift、Win
    • 按键: A-Z、0-9、F1-F24、方向键、Esc、Tab、Space 等
  • 示例:

    boss_key=Ctrl+Alt+B
    boss_key=Ctrl+Shift+H
    boss_key=Win+H
    boss_key=Ctrl+`

  • 注意事项:
    • 确保热键不与其他应用程序或系统热键冲突
    • 留空则禁用老板键功能
    • 音频静音状态会被保留（仅在原本未静音时才取消静音）

故障排除

问题: Twitch/YouTube 视频加载慢或质量低 (160p)

• 检查: 打开 chrome://gpu，查看 "Video Decode" 是否为 "Hardware accelerated"
• 解决: 确保 config.ini 中 win32k=0 (或不存在 config.ini)

问题: 浏览器启动立即崩溃

• 解决: 创建 config.ini，设置 win32k=1
• 建议: 考虑将浏览器从杀毒软件扫描中排除

问题: 视频卡顿或频繁缓冲

• 检查: 缓存目录位置和磁盘速度
• 解决: 将 cache 目录移到 SSD：cache=C:\Path\To\SSD\Cache

问题: 老板键不起作用

• 解决:
  1. 确保热键不与系统热键冲突
  2. 尝试不同的按键组合
  3. 设置 debug_log=1 并使用 DebugView 查看错误消息
  4. 确保按下的是配置中指定的确切组合

问题: 窗口恢复顺序错误或未显示所有窗口

• 说明: 老板键以相反的创建顺序恢复窗口
• 解决: 尝试再次隐藏和显示，或重启浏览器

详细配置说明请查看 config.ini.example.zh-CN 文件。

架构支持

Vivaldi Plus 现在支持多种 CPU 架构：

• x86 (32位) - 传统 32 位 Windows 系统
• x64 (64位) - 现代 64 位 Windows 系统
• ARM64 - Windows on ARM 设备（如 Surface Pro X、Snapdragon 笔记本等）

为什么使用 Microsoft Detours？

随着 Vivaldi 浏览器推出 ARM64 版本以支持 Windows on ARM 设备，原有的 MinHook 库无法满足需求，因为 MinHook 不支持 ARM64 架构。

为了让 Vivaldi Plus 能够在所有架构上运行，我们已将 hook 库从 MinHook 迁移到 Microsoft Detours：

• ✅ 完整的架构支持 - Detours 原生支持 x86、x64 和 ARM64
• ✅ 微软官方维护 - 由 Microsoft 开发和维护，稳定可靠
• ✅ 成熟的生态 - 被广泛应用于 Windows 平台的各类工具中
• ✅ 更好的兼容性 - 与 Windows on ARM 完美兼容

现在，无论你使用什么架构的 Windows 设备，都可以享受 Vivaldi Plus 带来的便携化体验！

下载与安装

获取Vivaldi浏览器

请访问 https://vivaldi.czyt.tech 获取下载链接

获取Vivaldi Plus

• 稳定版本（Stable）：从 Releases 页面下载
• 开发版本（Nightly）：Powered by nightly.link - 每次代码推送后自动构建

版本说明：

• Stable (稳定版)：经过测试的正式版本，推荐大多数用户使用
• Nightly (开发版)：包含最新功能和修复，但可能不够稳定

安装方法

将 version.dll 放入解压版Vivaldi目录（vivaldi.exe 同目录）即可

构建

# 安装 xmake
# 克隆仓库（注意使用 --recursive 参数以包含 Detours 子模块）
git clone --recursive https://github.com/ca-x/vivaldi_plus.git
cd vivaldi_plus

# 构建 x64 (推荐)
xmake f -a x64 -m release
xmake

# 构建 ARM64 (Windows on ARM)
xmake f -a arm64 -m release
xmake

# 构建 x86 (32位)
xmake f -a x86 -m release
xmake

编译后的 DLL 将输出到 build/release/<架构>/version.dll

源项目

基于 chromePlus 项目

修复 Chrome 118+ 的代码参考了 Bush2021的项目，在此表示感谢。

---

English

Features

• Portable Design - Keep app in App folder and data in Data folder (incompatible with original data, but allows system reinstallation without data loss)
• Remove Update Warnings - Removes update error warnings since this is a portable version without auto-update
• Password Portability - Password data can be used across machines, not tied to hardware ID

Note: Tab enhancement features have been removed as most are now built into Vivaldi. Only core portability features remain:

• Double-click middle button to close tab
• Keep last tab open
• Mouse hover tab scrolling
• Right-click + wheel to scroll tabs

Configuration

This DLL provides configuration options. Create a config.ini file in the same directory as the DLL.

Quick Start

1. Copy config.ini.example to config.ini
2. Modify configuration items as needed (defaults work for most cases)
3. Restart browser

Configuration File Format

Complete configuration example:

[general]
# Win32k System Call Policy
# win32k=0 (recommended) - Keep default sandbox, ensure GPU acceleration and video streaming
# win32k=1 (compatibility) - Use only if Chrome crashes at startup, may affect video quality
win32k=0

# Debug Logging
# debug_log=0 (default) - No debug logging
# debug_log=1 (troubleshooting) - Output debug logs (viewable with DebugView)
debug_log=0

# Chrome Features to Disable
# Leave empty for defaults (recommended): WinSboxNoFakeGdiInit,WebUIInProcessResourceLoading
# Or customize with your own features
disable_features=

# Additional command-line arguments
command_line=

[dir_setting]
# Data directory (user settings, bookmarks, extensions, etc.)
data=%app%\..\Data

# Cache directory (temporary files)
# Performance tip: Place on SSD for best video streaming performance
cache=%app%\..\Cache

[hotkey]
# Boss Key - Quickly hide/show browser and mute/unmute audio
# Format: Ctrl+Alt+B or Win+H, etc.
# Leave empty to disable
boss_key=

Configuration Options

[general] Section

• win32k (default: 0)

  • 0 - Recommended 🟢
    • Maintains Chrome's default sandbox security
    • Ensures GPU hardware acceleration works correctly
    • Best video streaming performance (Twitch, YouTube, etc.)
    • Low CPU usage (10-20%)
  • 1 - Compatibility Mode 🟡
    • Use only if browser crashes at startup
    • May fix conflicts with certain antivirus software (Symantec, McAfee)
    • ⚠️ May break hardware video decoding
    • ⚠️ Twitch/YouTube may play in lower quality
    • ⚠️ Increased CPU usage (50-80%)

• debug_log (default: 0)

  • 0 - No debug logging, minimal performance impact
  • 1 - Output debug logs for troubleshooting
    • Outputs via OutputDebugString (viewable with DebugView)
    • Logs command line arguments, errors, and portable mode operations
    • Use only when investigating issues

• command_line (default: empty)

  • Additional Chrome command-line flags
  • Example: command_line=--force-dark-mode --enable-features=WebUIDarkMode

• disable_features (default: WinSboxNoFakeGdiInit,WebUIInProcessResourceLoading)

  • Specifies which Chrome features to disable
  • Leave empty or unspecified: Use default compatibility features (recommended)
  • Specify value: Use your custom features (replaces defaults)
  • Common features:
    • WinSboxNoFakeGdiInit - Fix GPU initialization issues
    • WebUIInProcessResourceLoading - Improve WebUI compatibility
    • RendererCodeIntegrity - Allow DLL injection
    • AutofillServerCommunication - Disable autofill sync
    • TranslateUI - Disable translation prompts
  • Examples:

    # Use defaults (recommended)
    disable_features=
    
    # Custom features
    disable_features=RendererCodeIntegrity,TranslateUI
    
    # Add more features
    disable_features=WinSboxNoFakeGdiInit,WebUIInProcessResourceLoading,TranslateUI

[dir_setting] Section

• data (default: %app%\..\Data)

  • User data directory (profiles, bookmarks, extensions, etc.)
  • Supported formats:
    • Relative paths: data=..\Data
    • Absolute paths: data=C:\MyBrowser\Data
    • Environment variables: data=%LOCALAPPDATA%\VivaldiPlus\Data
    • %app% variable: data=%app%\..\Data

• cache (default: %app%\..\Cache)

  • Cache directory (temporary files, media cache, etc.)
  • Performance tips:
    • Place on SSD (not HDD)
    • Ensure at least 2GB free space
    • Avoid network drives

[hotkey] Section

• boss_key (default: empty, disabled)
  • Boss Key - Quickly hide/show browser and mute/unmute audio
  • Features:
    • Press hotkey to instantly hide all Vivaldi windows and mute all audio
    • Press again to restore windows and unmute audio
    • Global hotkey (system-wide)
  • Format: Modifier+Modifier+Key
    • Modifiers: Ctrl (or Control), Alt, Shift, Win
    • Keys: A-Z, 0-9, F1-F24, arrow keys, Esc, Tab, Space, etc.
  • Examples:

    boss_key=Ctrl+Alt+B
    boss_key=Ctrl+Shift+H
    boss_key=Win+H
    boss_key=Ctrl+`

  • Important notes:
    • Make sure the hotkey doesn't conflict with other applications or system hotkeys
    • Leave empty to disable boss key functionality
    • Audio mute state is preserved when hiding (unmute only if originally not muted)

Troubleshooting

Issue: Twitch/YouTube videos load slowly or play in low quality (160p)

• Check: Open chrome://gpu, verify "Video Decode" shows "Hardware accelerated"
• Solution: Ensure config.ini has win32k=0 (or no config.ini exists)

Issue: Browser crashes immediately at startup

• Solution: Create config.ini, set win32k=1
• Recommendation: Consider excluding browser from antivirus real-time scanning

Issue: Video stuttering or frequent buffering

• Check: Cache directory location and disk speed
• Solution: Move cache to SSD: cache=C:\Path\To\SSD\Cache

Issue: Boss key not working

• Solution:
  1. Make sure the hotkey doesn't conflict with system hotkeys
  2. Try a different key combination
  3. Set debug_log=1 and use DebugView to see any error messages
  4. Make sure you're pressing the exact combination specified

Issue: Windows restore in wrong order or not all windows show

• Explanation: Boss key restores windows in reverse creation order
• Solution: Try hiding and showing again, or restart the browser

For detailed configuration documentation, see config.ini.example file.

Architecture Support

Vivaldi Plus now supports multiple CPU architectures:

• x86 (32-bit) - Legacy 32-bit Windows systems
• x64 (64-bit) - Modern 64-bit Windows systems
• ARM64 - Windows on ARM devices (Surface Pro X, Snapdragon laptops, etc.)

Why Microsoft Detours?

With Vivaldi browser releasing ARM64 builds to support Windows on ARM devices, the original MinHook library couldn't meet our needs because MinHook doesn't support ARM64 architecture.

To enable Vivaldi Plus on all architectures, we've migrated from MinHook to Microsoft Detours:

• ✅ Complete architecture support - Detours natively supports x86, x64, and ARM64
• ✅ Official Microsoft maintenance - Developed and maintained by Microsoft, stable and reliable
• ✅ Mature ecosystem - Widely used in various Windows platform tools
• ✅ Better compatibility - Perfect compatibility with Windows on ARM

Now you can enjoy Vivaldi Plus's portable experience on any Windows device architecture!

Download & Installation

Get Vivaldi Browser

Visit https://vivaldi.czyt.tech for download links

Get Vivaldi Plus

• Stable Builds: Download from Releases page
• Nightly Builds: Powered by nightly.link - Auto-built after each code push

Build Types:

• Stable: Tested official releases, recommended for most users
• Nightly: Contains latest features and fixes, but may be unstable

Installation

Place version.dll in the Vivaldi portable directory (same directory as vivaldi.exe)

Building

# Install xmake
# Clone repository (use --recursive to include Detours submodule)
git clone --recursive https://github.com/ca-x/vivaldi_plus.git
cd vivaldi_plus

# Build x64 (recommended)
xmake f -a x64 -m release
xmake

# Build ARM64 (Windows on ARM)
xmake f -a arm64 -m release
xmake

# Build x86 (32-bit)
xmake f -a x86 -m release
xmake

Compiled DLLs will be output to build/release/<architecture>/version.dll

Original Project

Based on chromePlus

Chrome 118+ fixes referenced from Bush2021's project. Special thanks.

---

License

See LICENSE file for details.