Skip to content

Bronya0/OnlyWallpaper

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

OnlyWallpaper

macOS 动态壁纸工具,使用 GPU 硬件加速渲染视频作为桌面背景。 将 MP4/MOV 视频文件设置为 macOS 桌面壁纸,支持开机自启等功能。 GPU 硬件加速 - 使用 WKWebView + Metal 视频解码,超低功耗。

用法

直接下载:从右边 release 下载现成的二进制文件

或者手动自行编译:

编译

CGO_ENABLED=1 go build -o wallpaper

编译后会生成一个单独的二进制文件(无需额外的 assets 目录),所有资源(包括 HTML 模板)已内嵌于二进制中。

启动壁纸

chmod +x wallpaper
./wallpaper --video /path/to/video.mp4

停止壁纸

./wallpaper stop

查看状态

./wallpaper status

开机自启

设置开机自启(需指定视频路径):

./wallpaper enable-autostart --video /path/to/video.mp4

取消开机自启:

./wallpaper disable-autostart

命令行参数

参数 说明
--video MP4/MOV 视频文件路径
--cmd 命令:start / stop / status / enable-autostart / disable-autostart

打包和部署

  • 单一二进制 - 所有资源(HTML、样式、脚本)已嵌入,无需携带额外文件
  • 跨目录使用 - 可以将二进制文件放在任何位置,正常运行无需依赖目录结构
  • 体积最小化 - 内置资源被编译进二进制,减少文件数量

注意事项

  1. 视频格式 - 仅支持 .mp4 和 .mov 格式
  2. 资源占用 - 视频播放会占用一定的 GPU 资源,功耗增加极少(我测试只有10-50mW,不到0.1W占用)
  3. 编译要求 - 需要安装 Xcode Command Line Tools:
    xcode-select --install
  4. 单实例运行 - 程序使用文件锁确保同时只有一个实例运行,新启动会自动停止旧实例

技术栈

  • Go - 主程序逻辑
  • embed - 资源内嵌
  • cgo - Go 与 Objective-C 互操作
  • Objective-C - macOS 原生窗口管理
  • WKWebView - HTML5 视频渲染

About

mac视频壁纸,省电

Resources

Stars

Watchers

Forks

Packages