dsh-wallpaper-engine

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.

• 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 official dsh-pet integration.
• Library: filters, hide / restore, rotation lists and whole-configuration preset import / export.

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

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.

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.

• 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; online lyrics are off by default.
• When running with other skins / plugins, read Coexistence first.

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

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