Requires DeepSeek Harness 0.1.5-rc.1+ (DSH Desktop >= 2.0.7) and dsh-better-sidebar >= 0.19.0 - update both before installing or updating this plugin. Plays local Wallpaper Engine Video/Web wallpapers behind the chat, renders Scene wallpapers as extracted static frames, and adds content-rating/type filters, custom uploads and an iOS-style liquid-glass settings window.
Install
# from npm (prebuilt)
dsh plugin --profile web add dsh-plugin-wallpaper-engine
# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)
dsh plugin --profile web add github:elysia395/dsh-wallpaper-engine
Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).
README
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 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.
| 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.
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 release procedure; 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.
- Open Settings → Wallpaper Engine → Library, or pull the mascot cord above the chat.
- Pick a thumbnail in the in-panel library and adjust playback / appearance; changes apply immediately and persist on the host.
- 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.
- 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 ❤️
Links
More in this category
Small-tailqwq/dsh-deep-whale#maid-atelier★ 3103
Whale-girl skin series for the DSH Web UI (maid-atelier).
Nwflower/dsh-claude-style★ 596
Claude Code Desktop look-and-feel for the DSH Web GUI — ivory/warm-black dual canvas, clay accent, three-font typography, permission segmented control and brand switcher, via CSS overrides and client DOM overrides.
d-dev0101/open-sea-skin★ 393
Realtime WebGPU ocean skin with quick controls for waves, daylight, glass opacity, and an automatic day cycle.
kingOfSoySauce/dsh-liang-skin★ 387
Adaptive reasoning slider skin that maps each model's available reasoning efforts onto a 0–30 visual intensity scale, with synchronized portraits, background, and interface colors.
RevolutionLA/dsh-dream-skin★ 301
One-command skin plugin: 8 original themes, translucent wallpaper with opacity/blur, per-user accent, and shareable theme-pack import/export, favorites and surprise-me — purely native on DSH's token system.
webkubor/dsh-bloom-theme★ 273
Bloom Morandi theme: fifteen variants (mist, cinnabar, petal, ripple, sage, stone, lapis, amber, aurora, lavender, mint, tangerine, silverrose, dawn, osmanthus) built on OKLCH so light and dark stay perceptually even; twelve are featured in the top-bar switcher, grouped by color family, and all 30 foreground/background pairs are measured at WCAG AA or better.
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.