MIT-licensed DSH plugin that renders Wallpaper Engine scene, video, web and image wallpapers live behind the DeepSeek Harness Web GUI, with rotation, a local library and a multi-step fallback chain.
DSH integration
Native runtime
Author-claimed
Safety audit
Unaudited
Last verified
2026-11-21
License
MIT
01What can it help you accomplish?
Give the DeepSeek Harness Web GUI a wallpaper that actually moves
Wallpaper Engine scene wallpapers computed live in the browser — particles, water, drifting clouds and cloth — with the DSH interface layered on top
Developers who keep DSH open all day and want a live background instead of a static image
Use video, web and image wallpapers as the DSH background, and rotate them automatically
Looping video wallpapers whose audio follows the sound switch, web wallpapers in a sandbox, image wallpapers with a slow Ken Burns zoom, plus rotation every 1 / 5 / 10 / 30 minutes
People who already own a Wallpaper Engine library and want the same wallpapers behind their coding session
Keep the DSH UI usable when a wallpaper will not render
A multi-step fallback chain — embedded MP4 → captured frame PNG → author preview → empty state — so a broken scene skips a level instead of leaving a white or black screen
Users of obscure or heavily scripted wallpapers that trip the renderer
02How to install into DeepSeek Harness
Prerequisites
- Windows 10/11 — the only platform the README calls fully supported and actually tested
- DeepSeek Harness 0.2.x — the plugin declares `engines.dsh` `>=0.2.0-rc.1 <0.3.0`
- Wallpaper Engine installed locally — the plugin reads its built-in particle and effect textures, but the engine itself does not need to be running
- A browser with WebGL2 (Chrome or Edge); Chrome gets closest to Wallpaper Engine's own look
Installation steps
- 01
Desktop app: open the **Plugins** page in the sidebar, click **Add plugin**, enter `@dsh-use/wallpaper-engine` (npm) or `github:yu502950715yang/dsh-use-wallpaper` (GitHub), install, then refresh the page
- 02
`dsh web`: run `dsh plugin --profile web add "@dsh-use/wallpaper-engine" && dsh plugin --profile web install`
$ dsh web
- 03
Restart `dsh web` and open the GUI
$ dsh web
- 04
Open the "Wallpaper 壁纸" entry in the settings sidebar and fill in the wallpaper (workshop) and engine folders, or click auto-detect — e.g. `D:/Steam/steamapps/workshop/content/431960` and `D:/Steam/steamapps/common/wallpaper_engine`
- 05
Click a thumbnail in the grid to apply the wallpaper
Verify the integration
- `GET /wallpapers/list` returns a JSON array of wallpapers
- The browser console prints `[three] scene loaded id=… background=N particleLayers=M`, where `M ≥ 1` means the particle layers were built
Rollback
- Run `dsh plugin --profile web remove "@dsh-use/wallpaper-engine"`, then `dsh plugin --profile web install`, then restart `dsh web`
- Desktop app: uninstall from the same Plugins page (it asks for confirmation)
03DSH integration and capability boundaries
Native DSH (Cordis) bundle plugin: add `@dsh-use/wallpaper-engine` (npm) or `github:yu502950715yang/dsh-use-wallpaper` from the desktop app's Plugins page, or run `dsh plugin --profile web add` + `dsh plugin --profile web install` on `dsh web`; it then mounts a background layer plus a "Wallpaper 壁纸" settings panel inside the DSH Web GUI.
Real-time scene rendering
A scene wallpaper from your local Steam workshop folder→A three.js background layer plus particle billboards rendered live in the browser
Runs a WebGL render loop in the browser and pauses automatically when the page goes to the backgroundWrites a first-frame PNG to `~/.dsh-use-wallpaper/frames/` after the first successful renderVideo, web and image wallpapers
A video, web or image wallpaper from the same library→Looping native video playback, a sandboxed web page, or a preview image with a slow Ken Burns zoom
Video the browser cannot decode (HEVC / H.265) falls back to the preview image with a noticeWeb wallpapers load in a sandboxed iframe, so WebGL-textured ones go blank when the GUI is reached over a LAN IP or tunnelWallpaper library and rotation
Title search, type filter, favourites-only, hide / restore, recent order→A filtered library plus automatic rotation every 1 / 5 / 10 / 30 minutes, sequential or random
Favourites, hidden entries and recent history live in browser localStorage only — the wallpaper files are untouchedPicture, glass and glow panel
Overlay opacity, background blur, Ken Burns, fit mode, chat-area frosted glass, glow threshold and strength→Changes applied immediately inside the DSH Web GUI
Per-wallpaper user properties
The properties a wallpaper actually references (bool / slider / color / combo)→Sliders and colour pickers for exactly those properties, applied by reassembling the wallpaper
Changing a property reassembles the current wallpaper; slider and colour input is debouncedFallback chain and power saving
A scene that fails to load, assemble, or produce a visible object→Step-by-step fallback to embedded MP4 → captured frame PNG → author preview → empty state, plus one-click pause and a 0.5× quality step
Each failing level is skipped without an error dialog or a stuck black screenSystem media and boot animation
The Windows system media session (SMTC), or a Wallpaper Engine / local video clip→Album art, title, artist, dominant colour and play state synced to the wallpaper; a full-screen intro clip when DSH starts
Media metadata is read into memory only and never written to diskBoot animation sound is on by default and wallpaper audio is muted while it plays
04Who is it for? When not to use it?
Good for
- Developers who keep DSH open all day and want a live background instead of a static image
- People who already own a Wallpaper Engine library and want the same wallpapers behind their coding session
- Users of obscure or heavily scripted wallpapers that trip the renderer
Not for
- Only Windows 10/11 is fully supported and actually tested; macOS and Linux are untested, and from 1.0 the package declares `dsh.bundle.platforms = ["win32"]`, so DSH skips the plugin on other platforms and reports why.
- The plugin requires DSH `>=0.2.0-rc.1 <0.3.0`; 1.0 dropped the pre-0.1.7 settings path, so anyone still on 0.1.x has to upgrade DSH before installing.
- Wallpaper Engine must be installed locally — the plugin reads its built-in particle and effect textures. Without it (or with a wrong path) particles degrade to flat coloured dots, though the picture still renders.
05Compatibility, maintenance and safety notes
- Only Windows 10/11 is fully supported and actually tested; macOS and Linux are untested, and from 1.0 the package declares `dsh.bundle.platforms = ["win32"]`, so DSH skips the plugin on other platforms and reports why.
- The plugin requires DSH `>=0.2.0-rc.1 <0.3.0`; 1.0 dropped the pre-0.1.7 settings path, so anyone still on 0.1.x has to upgrade DSH before installing.
- Wallpaper Engine must be installed locally — the plugin reads its built-in particle and effect textures. Without it (or with a wrong path) particles degrade to flat coloured dots, though the picture still renders.
- The renderer has known gaps: sub-particles (sub-emitters), rope trails (`ropetrail`) and mouse-interactive particles are not supported yet, and per-monitor wallpapers on multi-monitor setups are impossible because the plugin is a single background layer.
MIT · actively maintained (latest release v1.0.2, 2026-11-17)
06Frequently asked questions
How do I install it in DeepSeek Harness?
On `dsh web`, run `dsh plugin --profile web add "@dsh-use/wallpaper-engine" && dsh plugin --profile web install`, then restart `dsh web`. The desktop app is a different path: sidebar **Plugins** page → **Add plugin** → enter the package name → install → refresh the page. The README notes that the `dsh plugin` commands are rejected for the desktop profile.
Where do I set the wallpaper folder after installing?
In the DSH GUI open the "Wallpaper 壁纸" entry in the settings sidebar, fill in the workshop folder (`D:/Steam/steamapps/workshop/content/431960`) and the engine folder (`D:/Steam/steamapps/common/wallpaper_engine`), or click auto-detect, then pick a thumbnail in the grid.
Does Wallpaper Engine have to keep running?
No. The plugin only reads the engine's built-in particle and effect textures from your local install, Wallpaper Engine does not need to run in the background, and no third-party assets are redistributed. With no local WE install at all, particles degrade to flat coloured dots.
Which DSH versions and platforms are supported?
DSH `>=0.2.0-rc.1 <0.3.0` — that is what the plugin declares in `engines.dsh`, and 1.0 also removed the pre-0.1.7 settings path. Windows 10/11 is the only fully supported and tested platform; from 1.0 the package declares `win32`, so DSH skips it elsewhere.
A video wallpaper stays black — what now?
Usually the codec. Video wallpapers are decoded by the browser's native video element, so HEVC / H.265 needs the matching system decoder; without it the plugin falls back to the preview image and states the reason in the Wallpaper panel. Use Chrome or convert the clip to H.264.
07Related DSH workflows
dsh-tui
by ccch1mneyyy
Claude Code 风格全屏终端 TUI:像素鲸鱼顶栏、双流光大字、实时工作状态行、思考流式展开、双击 Esc 时间回溯、上下文进度条 + TPS 仪表;接入 Agent preset(standard/code/minimal/cordis)、Skills、MCP、Goals、Todos、子代理,/ 命令注册表与随附技能(audit/bug/review/practice/pr_comments/release-notes/vuln-check);纯插件挂载零核心改动。
dsh-better-sidebar
by omdsh-dev
Full sidebar workbench with file rendering and editing, terminal, Git, and subagents; third-party plugins can register new tabs.
dsh-media-desk
by woniuniuniu
Capture ideas and generate scripts, titles, covers, images, storyboards, schedules, and review data in a sidebar media workspace.
dsh-drawai
by fourzkw
Create diagram artifacts and use Draw.io-oriented tools from a DSH profile.
08Data and sources
把 Wallpaper Engine 的 scene(场景)壁纸搬进 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 的 Web GUI
dsh plugin --profile web add "@dsh-use/wallpaper-engine" && dsh plugin --profile web install
仓库根 `package.json` 已声明 `dsh.bundle`,bundle 由 `cordis.patch.yml` 自动注册
This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-11-21. Found an error? Submit a correction.
Best DeepSeek Harness Plugins
Twelve plugins worth installing first — picked from the whole catalog, across every category.
