Back to directory

dsh-use-wallpaper

In a curated listMaintenance: Active

yu502950715yang/dsh-use-wallpaper

Render configurable Wallpaper Engine scenes, videos, and web wallpapers behind DSH Web with effects, rotation, media, and local library controls.

View on GitHubHomepage
$ dsh web

16

stars

0

forks

TypeScript

Language

MIT

License

2026-08-17

Created

2026-11-20

Last push

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

  1. 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

  2. 02

    `dsh web`: run `dsh plugin --profile web add "@dsh-use/wallpaper-engine" && dsh plugin --profile web install`

    $ dsh web

  3. 03

    Restart `dsh web` and open the GUI

    $ dsh web

  4. 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`

  5. 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

DSH integrationNative runtime

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 render
  • Video, 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 tunnel
  • Wallpaper 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 untouched
  • Picture, 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 debounced
  • Fallback 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 screen
  • System 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.
2026-08-172026-11-17v1.0.2

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.

08Data and sources

  • Author-claimedgithub.comd3fc8fd6a09c…

    把 Wallpaper Engine 的 scene(场景)壁纸搬进 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 的 Web GUI

  • Author-claimedgithub.comd3fc8fd6a09c…

    dsh plugin --profile web add "@dsh-use/wallpaper-engine" && dsh plugin --profile web install

  • Author-claimedgithub.comd3fc8fd6a09c…

    仓库根 `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.

DSH Plugins is an independent community directory of DeepSeek Harness plugins. Not affiliated with or endorsed by DeepSeek. Third-party plugins are not security-audited — review the source before installing.

New DeepSeek Harness plugins, weekly. No spam.