把视频当作桌面壁纸播放。一套 C++ 核心（libmpv），两个原生外壳：
| 平台 | 壁纸层 | 托盘 | 状态 |
|---|---|---|---|
| Linux Wayland | wlr-layer-shell background 层 + 自绘（EGL/GLES2） |
StatusNotifierItem（D-Bus） | KDE Plasma 6 上验证通过 |
| Windows | Explorer 的 WorkerW（桌面图标之下） |
Shell_NotifyIcon |
从 v1 移植，MinGW 构建由 CI 覆盖，尚未在真机验证 |
A video wallpaper player: shared libmpv core, native shells for Wayland (layer-shell) and Windows (WorkerW).
- 多显示器：每个显示器一个播放器，可分别指定视频；只有主屏出声
- 循环播放、按屏幕比例裁切铺满
- 锁屏、休眠时暂停，关机前退出
- 托盘菜单：选择视频、暂停、静音、退出；Linux 另有命令行 / D-Bus 控制
- 配置持久化（
key=value文本文件）
需要合成器实现 zwlr_layer_shell_v1：
| 合成器 | 壁纸 |
|---|---|
| KDE Plasma 6 (KWin) | ✅ |
| Sway / Hyprland / river / niri 等 wlroots 系 | ✅ |
| GNOME (Mutter) | ❌ 不支持 layer-shell |
GNOME 用户请用 Hanabi 之类的 Shell 扩展，或走 XWayland 方案（本项目未实现）。
托盘图标需要面板支持 StatusNotifierItem（Plasma、Waybar、GNOME 的 AppIndicator 扩展）。
Ubuntu 24.04 可以直接装 Releases 里的 .deb（sudo apt install ./videowallpaper-*.deb，依赖会自动装上）。
依赖：libmpv、wayland-client、wayland-egl、egl、glesv2、sdbus-c++、wayland-scanner、CMake ≥ 3.20、C++20 编译器。
NixOS / 装了 Nix：
nix develop # 进入带全部依赖的 shell
cmake -S . -B build -G Ninja && ninja -C buildDebian/Ubuntu：
sudo apt install cmake ninja-build pkg-config libmpv-dev libwayland-dev libegl-dev libgles-dev libsdbus-c++-dev libwayland-bin g++
cmake -S . -B build -G Ninja && ninja -C build
sudo ninja -C build install # 可选，装到 /usr/localvideowallpaper # 启动守护进程（托盘里选视频）
videowallpaper ~/Videos/a.mp4 # 启动并使用该视频
videowallpaper set a.mp4 DP-2 # 只给 DP-2 换视频
videowallpaper pause | resume | mute | unmute | volume 40 | monitors | quit
VW_DEBUG=1 videowallpaper # 打印渲染和 mpv 的详细日志守护进程在 session bus 上注册 org.videowallpaper.Daemon，也可以直接用 busctl --user call ... 控制；
Sway 用户可以在 swayidle 的 lock/unlock 钩子里调 videowallpaper pause/resume。
开机自启：把 data/videowallpaper.desktop 复制到 ~/.config/autostart/。
# flake.nix
inputs.videowallpaper = {
url = "github:sdutwsl/DesktopVideo";
inputs.nixpkgs.follows = "nixpkgs";
};# NixOS 模块：装包，并作为 systemd 用户服务随图形会话启动
imports = [ inputs.videowallpaper.nixosModules.default ];
programs.videowallpaper.enable = true;
# programs.videowallpaper.autostart = false; # 只装包，不自启home-manager 用户换成 inputs.videowallpaper.homeModules.default，选项相同。
只要包本身的话：inputs.videowallpaper.overlays.default（提供 pkgs.videowallpaper）或
inputs.videowallpaper.packages.${system}.default；临时试用：nix run github:sdutwsl/DesktopVideo。
模块默认用系统自己的 pkgs 编译，保证和 /run/opengl-driver 里的显卡驱动用同一份 glibc；
否则会在启动时报 EGL initialisation failed。
依赖：MinGW-w64（GCC ≥ 13），CMake，libmpv 的 Windows 开发包。不支持 MSVC：libmpv 的 Windows 包只带 MinGW 导入库。
现成的 exe：Releases 里的 videowallpaper-v*-windows-x64.zip（videowallpaper.exe + libmpv-2.dll，解压即用）；master 每次提交的构建在 Actions 的 videowallpaper-windows-x64 产物里。
自己构建：
- 从 https://sourceforge.net/projects/mpv-player-windows/files/libmpv/ 下载
mpv-dev-x86_64-*.7z并解压（含include/、libmpv.dll.a、libmpv-2.dll；CI 固定用mpv-dev-x86_64-20261018-git-01e2533f31.7z）。 - 构建（MSYS2 的 MinGW64 环境，或在 Linux 上
nix develop .#mingw交叉编译）：cmake -S . -B build-win -G Ninja -DMPV_SDK_DIR=/path/to/mpv-dev \ -DCMAKE_TOOLCHAIN_FILE=cmake/mingw-toolchain.cmake # 仅交叉编译时需要 ninja -C build-win
libmpv-2.dll会自动复制到输出目录。 - 运行
videowallpaper.exe，右键托盘图标选择视频。把视频文件拖到 exe 上也可以。
Linux：~/.config/videowallpaper/config.ini；Windows：%APPDATA%\VideoWallpaper\config.ini。
video=/path/default.mp4 # 默认视频
video.DP-2=/path/other.mp4 # 某个显示器的覆盖（Windows 里显示器名形如 \\.\DISPLAY1）
volume=50
mute=0
pause_when_locked=1
audio_monitor=DP-1 # 哪个显示器出声，留空用主屏版本号只在 CMakeLists.txt 的 project(VideoWallpaper VERSION x.y.z) 里写一次，Nix 包和 Windows exe 的版本信息都从这里取。发布新版本：
# 先改 CMakeLists.txt 里的版本号并提交
git tag v2.1.0 && git push origin v2.1.0CI 跑完三路构建后自动创建 GitHub Release，附上 videowallpaper-v2.1.0-windows-x64.zip、videowallpaper-v2.1.0-ubuntu-24.04-amd64.deb 和 SHA256SUMS，更新说明根据提交记录自动生成。tag 和版本号对不上时发布会失败；v2.1.0-rc1 这类带 - 的 tag 发布为预发布版。
src/core/ 平台无关：libmpv 封装、配置、多屏控制器、菜单模型
src/wayland/ layer-shell 表面 + EGL 渲染、事件循环、SNI 托盘、D-Bus 会话事件
src/win/ WorkerW 表面、Shell_NotifyIcon 托盘、锁屏检测
cmake/ FindMpv、MinGW 工具链
nix/ Nix 包、NixOS / home-manager 模块
.github/ CI：Nix、Ubuntu apt（打 .deb）、MinGW 交叉三路构建，打 tag 时发布 release
Archived/ v1（C# WinForms 客户端 + C++ socket 服务端），仅存档
核心通过两个接口和平台打交道：Platform（枚举显示器、创建表面）和 Surface（把播放器的输出接到一块屏幕上）。
Windows 上 mpv 直接渲染进壁纸窗口（wid）；Wayland 上用 mpv 的 render API 画到我们自己的 EGL 表面，传入 wl_display 后 VAAPI 硬解的帧可以直接交给 GL。
循环播放、裁切铺满用的是 mpv 选项（loop-file=inf、panscan=1.0），不读用户的 mpv.conf。