wingetCollections
  • Auto
  • Search
  • Awesome Collections
  • Awesome Programs
  • My Favorite Collections
  • My Collections
  • Account / Settings
  • Terms of Service
  • Privacy
  • About
  • What is WinGet?

© 2026 winget.ragerworks.com

Loading...
  1. Go back
  2. Packages
  3. EarthBackground
EarthBackground logo

EarthBackground LGinC

avalonia earth satellite wallpaper
Use this command to install EarthBackground with WinGet:
winget install --id=LGinC.EarthBackground -e

Satellite earth wallpaper application built with .NET and Avalonia.

README

EarthBackground

.NET Core Desktop

基于 .NET 10 和 Avalonia 的地球壁纸工具，支持静态壁纸和 Windows / macOS / Linux X11 动态壁纸。

项目当前重点是：

  • 抓取卫星云图分块并拼接为完整图片
  • 复用已有 frame_xxx.png，避免重复下载和重复拼接
  • 在 Windows / macOS / Linux X11 上将 PNG 帧序列直接流式播放为动态壁纸
  • 提供本地配置、下载进度、错误通知和多语言 UI

当前功能

抓取源

  • Himawari 向日葵 9 号
  • GOES GOES-19
  • GeoKompsat Geo-KOMPSAT-2A
  • Meteosat Meteosat-12
  • fy-4 风云 4B

下载方式

  • 直接下载
  • Cloudinary
  • 七牛云

壁纸模式

  • 静态壁纸：抓取最新一帧并设置为系统壁纸
  • 动态壁纸：抓取最近一段时间的多帧 PNG，循环播放为动态桌面

平台支持

平台动态壁纸实现方式说明
Windows支持WorkerW + Avalonia 播放窗口窗口嵌入桌面图标层下方
macOS支持NSWindow desktop window level显示在壁纸之上、桌面图标之下；全屏 Space 遮挡是系统限制
Linux X11支持xwinwrap-like X11 root window 模式设置 EWMH desktop/below/sticky 状态并 reparent 到 root
Linux Wayland暂不支持-Avalonia native handle 不是 X11 时会明确报不支持

运行特性

  • 支持多显示器动态壁纸播放
  • 支持按帧缓存复用，已有 frame_xxx.png 时不再重复处理
  • 支持受控并发下载和拼接，加快多帧生成速度
  • 支持当帧集合未变化时跳过动态壁纸重建
  • 支持主界面进度条显示下载、解析和播放准备进度
  • 支持配置保存与开机自启动

动态壁纸实现

当前动态壁纸链路已经不再走“先生成 APNG，再解析 APNG 播放”的旧方案，而是改为直接播放 PNG 序列：

  1. WallpaperService 周期性触发抓取
  2. Captor 获取最近时间戳列表
  3. 对缺失帧执行下载和拼接，已有帧直接复用
  4. 平台动态壁纸设置器对帧路径排序
  5. PngSequencePlayer 按需逐帧读取 PNG
  6. WallpaperPlaybackWindow 将帧内容绘制到平台桌面窗口

这样做的好处：

  • 避免 APNG 编码和再次解析带来的额外耗时
  • 降低播放前的峰值内存占用
  • 更适合“抓一批帧然后循环播放”的桌面壁纸场景

平台窗口策略

  • Windows：查找 Progman / WorkerW，将 Avalonia 播放窗口设为子窗口并放在桌面图标层下方。
  • macOS：通过 native NSWindow 设置 level = kCGDesktopWindowLevel - 1，并启用 canJoinAllSpaces | stationary | ignoresCycle；窗口无边框、无阴影、鼠标穿透。
  • Linux X11：要求 TopLevel.TryGetPlatformHandle() 返回 HandleDescriptor == "X11" 或 "XID"，然后用 libX11 设置 _NET_WM_WINDOW_TYPE_DESKTOP、_NET_WM_STATE_BELOW/SKIP_TASKBAR/SKIP_PAGER/STICKY；若存在 xfdesktop 等已有桌面窗口，则将播放窗口堆叠到其上方，否则退回 root window 并 lower。

架构流程图

flowchart TD
    A["WallpaperService 周期调度"] --> B["Captor 获取时间戳列表"]
    B --> C{"是否已有 frame_xxx.png"}
    C -->|是| D["直接复用现有帧"]
    C -->|否| E["下载分块图片"]
    E --> F["拼接为 frame_xxx.png"]
    D --> G["形成按时间排序的帧序列"]
    F --> G
    G --> H{"DynamicWallpaper?"}
    H -->|否| I["IBackgroundSetter 设置静态壁纸"]
    H -->|是| J["IDynamicWallpaperSetter"]
    J --> K{"运行平台"}
    K -->|Windows| L["WorkerW 桌面子窗口"]
    K -->|macOS| M["NSWindow desktop level"]
    K -->|Linux X11| N["X11 root window / desktop atoms"]
    L --> O["PngSequencePlayer 按需逐帧读取 PNG"]
    M --> O
    N --> O
    O --> P["WallpaperPlaybackWindow 绘制帧"]
    P --> Q["多显示器动态壁纸播放"]

动态壁纸流程

sequenceDiagram
    participant S as WallpaperService
    participant C as Captor
    participant P as PngSequencePlayer
    participant D as Platform Setter
    participant W as WallpaperPlaybackWindow

    S->>C: 请求最近 RecentHours 的帧
    C->>C: 复用已有 frame_xxx.png
    C->>C: 下载并拼接缺失帧
    C-->>S: 返回 PNG 帧序列
    S->>D: SetDynamicBackgroundAsync(paths)
    D->>P: 打开按需 PNG 播放器
    D->>W: 为目标显示器创建播放窗口
    W->>W: 配置平台桌面层级
    loop 播放循环
        W->>P: 渲染下一帧
        P-->>W: 写入 WriteableBitmap
    end

项目结构

src 下的主要模块：

  • Background
    • 壁纸服务循环
    • Windows / macOS / Linux 动态壁纸设置
    • 平台显示器枚举和多显示器区域管理
  • Captors
    • 各卫星抓取器
    • 分块下载、缓存命中、图片拼接
    • 多帧并发处理
  • Imaging
    • PNG 序列播放器
    • 动态壁纸帧播放器接口
    • 早期 APNG 相关实现
  • Oss
    • 直接下载
    • Cloudinary
    • 七牛云
  • Views
    • Avalonia 窗口
    • 动态壁纸播放窗口
  • Platforms
    • macOS NSWindow 原生配置
    • Linux X11 原生窗口属性配置
  • ViewModels
    • 主界面逻辑
    • 设置界面逻辑
  • Localization
    • 基于 .resx 的 UI 文本本地化

工作流程

静态壁纸

  • 获取最新时间戳
  • 下载缺失分块
  • 拼接为完整 PNG
  • 设置为系统壁纸

动态壁纸

  • 获取最近 RecentHours 的时间戳列表
  • 对每个时间戳检查是否已有 frame_xxx.png
  • 缺失帧才下载并拼接
  • 最终按时间顺序播放 PNG 帧序列
  • Windows 使用单个跨显示器窗口嵌入 WorkerW
  • macOS / Linux 按显示器创建独立窗口，避免跨屏窗口带来的 Mission Control / X11 桌面行为问题

发布

  • 发布流程、渠道说明、维护者手册、安装示例已移至 Release.md。
  • 日常开发和功能说明仍保留在本文件中。

配置说明

主要配置位于 appsettings.json：

  • CaptureOptions
    • 抓取器
    • 分辨率
    • 更新间隔
    • 帧间隔
    • 缩放比例
    • 是否动态壁纸
    • 最近时长
    • 循环停顿
    • 保存路径
  • OssOptions
    • 下载方式
    • 用户名
    • API Key / Secret
    • Domain / Bucket / Zone

历史配置说明仍可参考：

  • 配置详解

示例配置

{
  "CaptureOptions": {
    "Captor": "fy-4",
    "AutoStart": false,
    "SetWallpaper": true,
    "SaveWallpaper": false,
    "WallpaperFolder": "images",
    "SavePath": "images",
    "Resolution": 2,
    "Zoom": 80,
    "Interval": 20,
    "FrameIntervalMinutes": 10,
    "DynamicWallpaper": true,
    "FrameIntervalMs": 500,
    "RecentHours": 24,
    "LoopPauseMilliseconds": 3000
  },
  "OssOptions": {
    "CloudName": "DirectDownload",
    "UserName": "",
    "ApiKey": "",
    "ApiSecret": "",
    "Zone": "",
    "Bucket": "",
    "Domain": "",
    "IsEnable": true
  }
}

字段说明补充：

  • Captor
    • Himawari
    • GOES
    • GeoKompsat
    • Meteosat
    • fy-4
  • Resolution
    • 0 = 688 x 688
    • 1 = 1376 x 1376
    • 2 = 2752 x 2752
    • 3 = 5504 x 5504
    • 4 = 11008 x 11008
  • CloudName
    • DirectDownload
    • Cloudinary
    • Qiniuyun
  • DynamicWallpaper
    • true 时使用最近一段时间的 PNG 帧序列播放动态壁纸
  • Interval
    • 更新间隔，单位分钟
  • FrameIntervalMinutes
    • 抓取帧间隔，单位分钟，最小 10，最大 360，且不超过 RecentHours 对应的分钟数
  • FrameIntervalMs
    • 每帧播放间隔，单位毫秒
  • RecentHours
    • 回溯最近多少小时的时间戳来构建动画
  • LoopPauseMilliseconds
    • 一轮播放完成后的停顿时间，单位毫秒

开发与运行

本地运行

dotnet run --project .\src\EarthBackground.csproj

构建

dotnet build .\src\EarthBackground.csproj

发布示例

dotnet publish .\src\EarthBackground.csproj --framework net10.0-windows --runtime win-x64 --configuration Release --self-contained true
dotnet publish .\src\EarthBackground.csproj --framework net10.0 --runtime linux-x64 --configuration Release --self-contained true
dotnet publish .\src\EarthBackground.csproj --framework net10.0 --runtime osx-x64 --configuration Release --self-contained true
dotnet publish .\src\EarthBackground.csproj --framework net10.0 --runtime osx-arm64 --configuration Release --self-contained true

后台服务模式

dotnet run --project .\src\EarthBackground.csproj -- --service

当前界面

项目已经迁移到 Avalonia 桌面 UI，主界面包含：

  • 当前状态
  • 总体进度条
  • 开始 / 停止 / 设置 / 退出

设置页包含：

  • 抓取设置
  • 动态壁纸相关参数
  • 下载器配置
  • 保存路径选择

说明

  • Windows 动态壁纸依赖桌面 WorkerW 行为，不同 Windows 版本会有兼容处理
  • macOS 全屏 Space 不支持 desktop window level 覆盖全屏应用，进入全屏应用时窗口会被系统遮挡
  • Linux 动态壁纸目前支持 X11；GNOME / KDE / 带桌面图标扩展的环境对图标层和点击行为可能不同，需要在目标桌面环境实测
  • 仓库中仍保留部分 APNG 相关代码，主要用于过渡和后续兼容实验，当前默认播放路径是 PNG 序列

路线图

  • 添加cli支持，方便接入AI
  • 添加linux macOS静态壁纸更新
  • 支持linux Wayland 动态壁纸更新
Versions
2.5.8
Website
github.com
License
Last updated
8/15/2026
Download latest version
Loading...