Deskland README

项目的 README,来自 github.com/BLEZZ0102/Deskland。合并为一个 markdown 文件:README.md。

Deskland Preview

Adaptive Windows wallpaper that makes your desktop icons part of the scenery.

Deskland turns the space around your icons into a living landscape. Move, add or remove an icon and the beach, meadow, clouds and shadows quietly reshape around it — in real time, without AI, an account or an API key.

This is the free, open-source Preview, not a time-limited trial. It includes the complete Beach and Meadow themes, the Windows host, settings and sharing tools.

English · 简体中文 · Official website · Features · Build from source

Meadow — included in Deskland Preview

Beach — included in Deskland Preview

Maldives — locked-theme preview

Meadow and Beach are included in Preview. Maldives is shown as a locked-theme preview.

Included themes

Beach Meadow
Beach theme Meadow theme
Turquoise waves, kayaks, seabirds and coconut palms. Drifting clouds and shadows, a boy flying a kite and a little black cat.

The theme browser also shows 11 locked themes as a preview of the full Wallpaper edition. Only names, descriptions and thumbnails are included for those themes — not their page code, parameters or implementation.

Features

Requirements

Currently, Deskland renders on the primary monitor and targets 30 fps on integrated graphics.

Build from source

Open PowerShell in the repository root:

powershell -ExecutionPolicy Bypass -File host\build.ps1
host\bin\Deskland.exe

Keep host/ and prototype/ together. Build output is written to host/bin/.

Run the program again or double-click its tray icon to open Settings. To exit and restore the original Windows wallpaper, use the tray menu or run:

host\bin\Deskland.exe --exit

Preview settings and logs are stored separately in %LOCALAPPDATA%\DesklandPreview.

Browser preview

node prototype\serve.mjs

Open http://localhost:5178/settings.html. The browser uses sample icons; adaptation to real desktop icons requires the Windows host.

Windows installer

Build the NSIS installer without installing global development tools:

powershell -ExecutionPolicy Bypass -File tools\build-installer.ps1

The first build downloads portable NSIS and Microsoft's WebView2 bootstrapper. Artifacts are written to dist/ with SHA256 checksums and a matching source ZIP.

The installer targets the current user's Programs\Deskland Preview directory and does not require administrator rights. If WebView2 is missing, its bootstrapper requires an internet connection. Uninstalling preserves user settings.

Download Deskland Preview for Windows. The installer is unsigned, so Windows SmartScreen may show a warning.

Project layout

Path Contents
host/ Windows host, build scripts and application manifest
prototype/flat.html Beach theme
prototype/meadow.html Meadow theme
prototype/settings.html Settings interface
prototype/themes.json Full free-theme definitions and locked-theme display metadata
prototype/share.js Privacy-preserving image and animation sharing
prototype/assets/ Images used by the included themes
tools/ Installer build tooling

Known limitations

Credits and license

Source code and included theme assets are released under GPL-3.0. Third-party dependencies are listed in THIRD_PARTY_NOTICES.md.

The Deskland name and icon are not licensed as trademarks; modified distributions should use their own name and icon. See TRADEMARKS.md.

Issues and suggestions are welcome through GitHub Issues. This is an independent project, so immediate responses are not guaranteed.


中文说明

English · 简体中文

让桌面图标成为风景的一部分。

Deskland 是一款 Windows 自适应动态壁纸。移动、添加或删除桌面图标时,海岸线、草地、云朵和阴影会实时围绕图标调整。全部在本地实时演算,不使用 AI,无需账号或 API Key。

本仓库是免费的开源体验版,不是限时试用版,包含完整的沙滩和草地主题、Windows 宿主、设置界面与分享工具。

官方网站 · 从源码运行 · 许可

包含的主题

沙滩 草地
沙滩主题 草地主题
海浪、皮划艇、海鸟和椰子树。 漂浮的云与云影、放风筝的男孩和小黑猫。

主题列表还展示另外 11 个锁定主题,帮助了解壁纸版内容。这些锁定主题只有名称、简介和缩略图,不包含页面源码、参数或其他实现。

功能

系统要求

目前只覆盖主显示器,以核显 30fps 为目标。

从源码运行

在仓库根目录打开 PowerShell:

powershell -ExecutionPolicy Bypass -File host\build.ps1
host\bin\Deskland.exe

请保持 host/ 和 prototype/ 的相对目录结构,编译结果位于 host/bin/。

再次运行程序或双击托盘图标可打开设置。退出并恢复系统原壁纸,请使用托盘菜单或执行:

host\bin\Deskland.exe --exit

体验版的设置与日志独立保存在 %LOCALAPPDATA%\DesklandPreview。

浏览器预览

node prototype\serve.mjs

打开 http://localhost:5178/settings.html。浏览器使用示例图标,真实桌面图标适配需要 Windows 宿主。

Windows 安装包

powershell -ExecutionPolicy Bypass -File tools\build-installer.ps1

首次构建会下载便携版 NSIS 和微软 WebView2 引导程序,无需安装全局开发工具。产物位于 dist/,附 SHA256 校验文件和对应源码 ZIP。

安装包安装到当前用户的 Programs\Deskland Preview 目录,无需管理员权限。缺少 WebView2 时需要联网安装;卸载保留用户设置。

下载 Deskland Preview Windows 安装包。安装包未签名,Windows SmartScreen 可能显示提示。

目录结构

路径 用途
host/ Windows 宿主、构建脚本与清单
prototype/flat.html 沙滩主题
prototype/meadow.html 草地主题
prototype/settings.html 设置界面
prototype/themes.json 免费主题完整定义及锁定主题展示信息
prototype/share.js 隐私保护的图片和动画分享
prototype/assets/ 随附主题图片素材
tools/ 安装包构建工具

已知限制

许可与反馈

项目源码和随附主题素材按 GPL-3.0 发布,第三方依赖见 THIRD_PARTY_NOTICES.md。

Deskland 名称与图标不作为商标授权授予;修改版应使用自己的名称和图标,详见 TRADEMARKS.md。

欢迎通过 GitHub Issues 反馈问题和建议。个人项目,不保证即时回复。

Deskland (BLEZZ0102/Deskland)

正在搜索数据库…

这是什么?一款 Windows 壁纸,能让桌面图标成为场景的一部分。沙滩和草地场景会在你移动、添加或删除图标时实时随之变化。
这是壁纸图片,还是一直在运行的程序?它是一个持续运行的 Windows 程序,包含宿主应用、托盘控件和设置窗口。它会读取桌面图标的真实位置,因此不是静态图片。
怎样让它运行起来?下载适用于 Deskland Preview 的 Windows 安装程序,或在仓库根目录通过 PowerShell 运行构建,从源码构建(输出位于 host/bin/)。安装程序会装入当前用户的 Programs 文件夹,无需管理员权限。
需要先安装哪些东西?Windows 10 或 11(64 位)以及 Microsoft Edge WebView2 Runtime。无需 .NET SDK,只有浏览器预览才需要 Node.js。
有什么需要注意的地方吗?只支持主显示器。当 Windows 更换背景图片时,Windows 聚光灯或壁纸幻灯片也可能短暂闪烁。
能在 macOS 或 Linux 上使用吗?不能,它只支持 Windows。浏览器预览使用的是示例图标,要适配你真实的桌面图标,必须使用 Windows 宿主程序。
使用它需要联网吗?只有在首次构建时需要联网,用于下载 WebView2 开发库;另外,系统缺少 WebView2 时也需要联网。壁纸本身在本地运行。
它会把我的数据发送到别处吗?分享导出使用的是示例图标和色块,而不是你的桌面内容。Preview 没有登录、更新服务或应用商店 API,场景在本地计算,不使用 AI,也不需要账户。
需要性能好的显卡吗?设定目标是在集成显卡上达到 30 fps,因此该项目力求对硬件要求较低。
这是限时试用版吗?不是。Preview 是免费的开源软件,并非试用版。它包含完整的沙滩和草地主题、设置、托盘控件以及分享工具。
能否与其他 Deskland 版本并存?可以。Preview 有自己的安装文件夹、设置、开机启动项和实例标识,因此可以与其他 Deskland 版本共存。
我最大化窗口或玩游戏时它会暂停吗?会。当窗口最大化或全屏时它会自动暂停,因此在你工作或娱乐时不会打扰你。
怎样卸载它并恢复原来的壁纸?通过托盘菜单退出,即可恢复原始的 Windows 壁纸。卸载时会保留你的用户设置,Preview 的设置和日志则单独存放在 %LOCALAPPDATA% 中。
作者
BLEZZ0102
大小
13 MB
星标
603
时长
24天
提交 · 90 天