# videowall-reverse **Repository Path**: xx-ming/videowall-reverse ## Basic Information - **Project Name**: videowall-reverse - **Description**: No description available - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-09-18 - **Last Updated**: 2026-11-05 ## Categories & Tags **Categories**: Uncategorized **Tags**: 动态壁纸, macOS ## README # VideoWall —— macOS 动态壁纸 **VideoWall** 是一款 macOS 菜单栏常驻的本地视频与图片壁纸应用,采用 SwiftUI/AppKit 实现。控制面板已按用户确认的 HTML 原型改为「安静的桌面工作台」:系统字体、柔和中性色、克制的蓝色强调和清晰分区。支持每屏独立图片/视频混播、自动图库、单素材播放设置、系统快捷指令、菜单栏播控与动态锁屏。全部代码自研。 当前交付路径为 `output/VideoWall-expanded/VideoWall.app`(含屏保组件、本地签名),已覆盖 `/Applications/VideoWall.app` 并打开验收。新界面截图位于 `output/native-ui-expanded/`,操作与验证范围见 [高优先级拓展交付说明](output/高优先级拓展_20261101/交付说明.md)。 > 仓库同时保留了早期技术调研与符号分析文档,作为自研实现的设计参考。 --- ## 仓库结构 ``` . ├── README.md ├── .gitignore ├── generated-images/ │ └── macOS_app_icon_design__1024x10_*.png # App 图标设计稿(ImageGen 生成) └── videowall_reverse/ # 技术调研与素材工作区 ├── VideoWall.bin # 原 App 二进制(通用二进制 x86_64+arm64, 280KB) ├── symbols_demangled.txt # 反修饰后的符号表 ├── COMPARE_REPORT.md # 原版 vs 复刻版对比 ├── OVERVIEW.html # 项目总览页 ├── DESIGN_SPEC.png # 控制面板设计稿 ├── PANEL_*.png # 面板预览图(明/暗、绿主题等) ├── 优化空间评估-复刻版.md └── 资源消耗对比-复刻版vs原版.md └── VideoWall-replica/ # ★ 复刻版源码(自研) ├── build.sh # 一键构建(主程序 + 屏保组件 + .app 组装) ├── set-accent.py # 强调色设置脚本 ├── VideoWall.xcodeproj/ ├── VideoWall/ │ ├── main.swift # 入口 │ ├── AppDelegate.swift # 菜单栏、播控、自动切换、窗口管理 │ ├── PanelView.swift # SwiftUI 控制面板(Clear Sky 重设计) │ ├── ScreenSlot.swift # 屏幕槽位模型 │ ├── LockScreenManager.swift # 动态锁屏(屏保接管) │ ├── Info.plist │ └── Resources/ │ ├── AppIcon.icns # Clear Sky 风应用图标 │ └── fillmode_sample.png # 默认播放卡片样图 ├── VideoWallSaver/ # 屏保组件(.saver bundle) │ ├── VideoWallSaver.swift │ ├── Info.plist │ └── thumbnail*.png └── tools/ ├── preview/main.swift # 离屏快照工具(生成面板 PNG 预览) └── capture-probe/ # 抓屏 / 性能探针(ScreenCaptureKit) ├── perf_probe.swift sck_probe.swift wallpaper_probe.swift └── evidence_*.png ``` > 注:`.workbuddy/`(会话记忆)、`build/`、`VideoWall.app/`(编译产物)已写入 `.gitignore`,**不纳入版本库**。 --- ## 功能特性 ### 技术调研(设计参考) - DMG 只读挂载 + Mach-O 静态分析:架构、依赖、代码签名、符号反修饰、字符串提取 - 还原技术栈:**原生 Swift + AppKit(NSStatusItem/NSWindow/AVFoundation)**,单 `AppDelegate` 包办全部逻辑 - 还原工作机制:按 `NSScreen.screens` 为每个屏幕创建桌面层级透明窗口 + 绑定同一 `AVPlayer`,视频作为动态桌面壁纸循环播放 - 输出符号表、方法映射表、信号/通知分析 ### 复刻版(自研实现,`VideoWall-replica/`) - **多屏独立混播**:每屏可以跟随全局,或使用自己的图片/视频混合列表,位于桌面图标之下 - **菜单栏控制**:选视频 / 播放暂停 / 静音 / 缩放切换(适应·填充·拉伸)/ 开机自启 - **SwiftUI 原生控制面板**:图库、屏幕分配、场景与规则、设置独立成页;图库含分类、搜索、收藏分组、网格/列表与右侧详情。设置分为播放、省电与暂停、系统与锁屏、图库与快捷操作。 - 选中媒体仅更新高分辨率静态预览,显式应用或播放才执行;原生面板预览区不实际播放视频。全局与独立屏幕共用图片/视频引擎,可从文件多选或将当前筛选结果指定为某屏的独立列表。 - 侧栏 196pt、检查器 240pt;窗口默认 1240 × 860pt,最小 1040 × 680pt,可缩放。HTML 原型规范和原生差异见 `DESIGN.md`。 - **视频 + 图片混合壁纸**:媒体列表按扩展名自动识别,图片以静态层展示;多图时按「图片停留时长」(10/20/30 分钟 / 1 小时)轮换,单图即静态壁纸 - **切换叠化过渡**:视频↔图片、自动切换均走双缓冲交叉淡变(0.3/0.6/1.0/2.0 秒可选),退场播放器保留末帧 + 首帧就绪门控,消除黑帧 - **自动切换**:按间隔(1/5/10/15/30/60 分钟)强制轮换全局与各屏专属播放器(原版此功能为死代码,已修复接线),切换后立即刷新面板「正在播放」标记 - **暂停 = 定格**:前台 App / 全屏 App 占用时只暂停在当前帧(不卸载画面);仅锁屏、休眠或低电量才解绑解码器省电 - **动态锁屏**:内置 `VideoWall.saver` 屏保组件,锁屏界面播放同一视频(无需特殊权限);屏保自带 1 秒看门狗(重新对齐多屏几何、补播),服务重启与转码全部走后台队列,不冻结界面 - **图标**:Clear Sky 风 `AppIcon.icns`,构建脚本自动嵌入避免回退为默认图标 --- ## 高优先级拓展(2026-11-01) - 订阅文件夹自动入库,支持子目录、暂停/恢复/移除订阅,稳定写入后才添加,保留当前播放进度。 - 本地文件书签追踪同卷移动和改名,联动播放列表、场景、离线屏幕、分组、收藏和素材设置。 - 每个素材可设置停留时间、声音覆盖、视频循环片段和封面时间;不影响原文件。 - 每屏独立图片/视频混播,支持暂停、休眠恢复、独立前进和图层切换。 - 可选全局热键与原生 App Intents;系统「快捷指令」已识别「控制 VideoWall 壁纸」「应用 VideoWall 场景」。 ## 本轮功能优化(2026-10-31) - 暂停原因说明、30 分钟临时播放;临时播放仍遵守电池与休眠保护。 - 保留失效媒体,支持单文件/同名文件夹路径修复,同步更新场景与分屏引用。 - 场景规则优先级、冲突提示、1 小时手动接管与立即恢复。 - 媒体拖入、搜索、收藏、命名分组与筛选队列播放。 - 单屏缩放和位置调整,包含设置保存、场景恢复与配置导入导出。 - 画质优先/均衡/省电三档预设,明确桌面策略与锁屏帧率的区别。 操作方式与验证范围见 [功能优化说明](output/功能优化_20261031/功能优化说明.md)。 --- ## 环境要求 - macOS 13.0+(arm64,Apple Silicon) - Xcode Command Line Tools(`swiftc`、`xcrun`、`codesign`),即 `xcode-select --install` --- ## 构建与运行 ```bash cd videowall_reverse/VideoWall-replica ./build.sh ``` 脚本会:① 用 `swiftc` 编译主程序(arm64, ad-hoc 签名);② 编译并嵌入 `VideoWall.saver` 屏保组件;③ 组装 `VideoWall.app`(含资源与图标)。 构建完成后: ```bash open VideoWall.app # 菜单栏点图标 → 选择视频… → 视频即铺满所有屏幕作为桌面壁纸 # 菜单栏「动态锁屏」= 安装屏保并接管系统墙纸槽位 ``` > 构建产物 `VideoWall.app` 与 `build/` 为可重建的临时文件,**不入库**。 --- ## 文档索引 | 文档 | 内容 | |---|---| | `videowall_reverse/COMPARE_REPORT.md` | 原版 vs 复刻版对比 | | `videowall_reverse/优化空间评估-复刻版.md` | 复刻版优化空间评估 | | `videowall_reverse/资源消耗对比-复刻版vs原版.md` | 复刻版 vs 原版资源消耗对比 | | `videowall_reverse/OVERVIEW.html` | 项目总览页 | --- ## 许可证 本项目以 MIT 许可开源(详见 `LICENSE`)。`VideoWall-replica/` 下全部源码为自研实现。 --- ## 远程仓库 `https://gitee.com/xx-ming/videowall-reverse.git`(分支 `main`)