Deskland README

The project's README from github.com/BLEZZ0102/Deskland. As one markdown file: 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)

Searching Database…

What is this?A Windows wallpaper that makes your desktop icons part of the scenery. Beach and meadow scenes reshape around your icons in real time when you move, add or remove them.
Is it a wallpaper picture or a program that keeps running?It is a running Windows program with a host app, tray controls and a settings window. It reads the real positions of your desktop icons, so it is not a static image.
How do I get it running?Download the Windows installer for Deskland Preview, or build from source by running the build in PowerShell from the repo root (output goes to host/bin/). The installer goes into your user's Programs folder and needs no admin rights.
What do I need installed first?Windows 10 or 11 (64-bit) and the Microsoft Edge WebView2 Runtime. No .NET SDK is needed, and Node.js is only required for the browser preview.
Any catches I should know about?Only the primary monitor is supported. Windows Spotlight or a wallpaper slideshow can also flash briefly when Windows changes the background image.
Does it work on macOS or Linux?No, it is Windows-only. The browser preview uses sample icons, so adapting to your real desktop icons requires the Windows host.
Do I need internet to use it?Only for the first build, which downloads the WebView2 development library, and when WebView2 is missing from your system. The wallpaper itself runs locally.
Does it send my data anywhere?Sharing exports use sample icons and colour blocks, not your desktop. The Preview has no sign-in, update service or store API, and the scenes are computed locally without AI or an account.
Do I need a good graphics card?The stated target is 30 fps on integrated graphics, so the project aims to be light on hardware.
Is this just a time-limited trial?No. The Preview is free and open-source, not a trial. It includes the full Beach and Meadow themes, settings, tray controls and sharing tools.
Can I keep it alongside other Deskland versions?Yes. Preview has its own install folder, settings, startup entry and instance identity, so it can coexist with other Deskland builds.
Does it pause when I maximize a window or play a game?Yes. It pauses automatically when a window is maximized or full-screen, so it stays out of the way while you work or play.
How do I remove it and get my old wallpaper back?Exit through the tray menu, which restores the original Windows wallpaper. Uninstalling keeps your user settings, and Preview settings and logs are stored separately in %LOCALAPPDATA%.
Creator
BLEZZ0102
Size
13 MB
Stars
603
Age
24d
Commits · 90 Days