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 с приложением-хостом, управлением из области уведомлений и окном настроек. Она считывает реальное положение значков рабочего стола, так что это не статичное изображение.
Как его запустить?Скачайте установщик Windows для Deskland Preview или соберите из исходников, запустив сборку в PowerShell из корня репозитория (результат появится в host/bin/). Установщик размещается в папке «Программы» вашего пользователя и не требует прав администратора.
Что нужно установить заранее?Windows 10 или 11 (64-бит) и среда выполнения Microsoft Edge WebView2 Runtime. Пакет .NET SDK не нужен, а Node.js требуется только для предпросмотра в браузере.
Есть ли какие-то подводные камни?Поддерживается только основной монитор. Кроме того, Windows Spotlight или слайд-шоу обоев могут ненадолго мигнуть, когда Windows меняет фоновое изображение.
Работает ли это на macOS или Linux?Нет, только для Windows. Предпросмотр в браузере использует примерные значки, поэтому адаптация к реальным значкам рабочего стола требует хоста Windows.
Нужен ли интернет, чтобы этим пользоваться?Только для первой сборки, которая загружает библиотеку для разработки WebView2, и когда WebView2 отсутствует в системе. Сами обои работают локально.
Отправляет ли это мои данные куда-нибудь?Экспортируемые для публикации материалы используют примерные значки и цветовые блоки, а не ваш рабочий стол. В Preview нет входа в аккаунт, службы обновлений или API магазина, а сцены вычисляются локально, без ИИ и учётной записи.
Нужна ли мощная видеокарта?Заявленная цель — 30 кадров в секунду на встроенной графике, поэтому проект стремится быть нетребовательным к железу.
Это просто пробная версия с ограниченным сроком?Нет. Preview бесплатен и имеет открытый исходный код, это не пробная версия. В него входят все темы «Пляж» и «Луг», настройки, управление из области уведомлений и инструменты для публикации.
Можно ли держать его рядом с другими версиями Deskland?Да. У Preview есть собственная папка установки, свои настройки, своя запись автозапуска и собственный идентификатор экземпляра, поэтому он может сосуществовать с другими сборками Deskland.
Приостанавливается ли он, когда я развёртываю окно на весь экран или запускаю игру?Да. Он автоматически приостанавливается, когда окно развёрнуто или открыто на весь экран, так что не мешает работе или игре.
Как его удалить и вернуть прежние обои?Выйдите через меню в области уведомлений — это восстановит исходные обои Windows. При удалении ваши пользовательские настройки сохраняются, а настройки и журналы Preview хранятся отдельно в %LOCALAPPDATA%.
Автор
BLEZZ0102
Размер
13 MB
Звёзды
603
Возраст
24 д
Коммиты · 90 дней