Intro

Bring local Wallpaper Engine Scene, Web and Video wallpapers into DSH, with liquid glass, typography, mascots and shareable appearance presets. The plugin registers no agent tools or prompt text, so it adds no model token overhead.

_{Real interface demo; historical captures may differ slightly from the installed build.}

Contents

Preview · Features · Supported wallpapers Quick start · Usage · Compatibility Development · Special Thanks Support · Community

Sponsor QR code The project is open source; donations are entirely optional and never affect installation, usage or issue support.

Features

• Wallpapers: live Scene / Web rendering, video playback, local image / video uploads and WE project directories.
• Appearance: liquid glass for settings, conversation and sidebar; colors, transparency, blur, borders and fonts.
• Glass subpackage: liquid glass is a standalone subpackage row, wallpaper-engine-glass, which can be disabled on its own in the plugin manager; with it disabled the host — except for the wallpaper shown in the content area — returns to its native look, while wallpapers, fonts and mascots keep working.
• Extensions: mascots, conversation avatars, click / pointer-trail effects, 3D parallax and optional desktop-pet integration with dsh-pet-dshwe (a full fork of dsh-pet), installable in one click from the settings card and falling back to the native mascot when it is missing, disabled or too old.
• Library: filters, hide / restore, rotation lists and whole-configuration preset import / export.

Supported wallpapers

Type	How it works in DSH	Support
Scene	Built-in WebWallGL live rendering, with fallback chain	Supported; no WE process required
Web	Web page mounting, WE API shim and sandboxing	Supported; depends on the page and browser
Video	Browser playback with transcoding, fps cap and pause control	Supported
Picture	Reads the image folder of a WE preset project and crossfades locally at the interval set in WE	Supported; images are never uploaded
Custom image / video	Upload local JPG / PNG / MP4	Supported; files stay local

Application wallpapers require launching third-party executables and are not supported; they never enter the library or rotation candidates.

Quick start

Requires Node.js >= 22.12.0, a DSH 0.2 kernel (including 0.2.0-rc.1/rc.2) and pnpm. Close DSH completely before installing.

npm (recommended)

dsh plugin --profile web add dsh-plugin-wallpaper-engine

Use desktop instead of web for the desktop host.

The repository ships a multi-package release set: installing the main package resolves the same-version subpackages (current package/tarball counts and publishOrder live in RELEASING; per-version changes in CHANGELOG).

From source

node scripts/install-source.mjs --profile desktop --dsh-home "<DSH data directory>" --app-closed

Keep the source directory in place after installation. See upgrading and contributing; see the beginner guide if you are new to the command line.

Usage

1. Open Settings → Wallpaper Engine → Library, or pull the mascot cord above the chat.
2. Pick a thumbnail in the in-panel library and adjust playback / appearance; changes apply immediately and persist on the host.
3. Pause / play controls only the current playback; clearing the current wallpaper never deletes the source file.

Compatibility

• Windows, macOS and Linux share the same source. macOS has no Wallpaper Engine client: upload images / videos or point custom-wallpaper storage at WE project directories.
• Scene rendering depends on browser WebGL and drivers; complex workshop projects may differ. Failures degrade gracefully.
• Occlusion pause, focus-loss pause and audio loopback are platform-adapted.
• When running with other skins / plugins, read Coexistence first.

Development

Bug reports, platform feedback, documentation fixes and feature PRs are welcome. Include host / plugin versions, OS, wallpaper type, reproduction steps and sanitized logs.

• How it works · Troubleshooting · Upgrading
• Changelog · Coexistence · Code structure
• Contributing · Release process

Community

 

Star history

Special Thanks

Special thanks to all contributors for their contributions to this project ❤️

_{Code is released under the MIT License. Wallpaper, character and font assets may use different licenses; check asset sources before redistribution or commercial use.}