dsh-plugin-wallpaper-engine

English | 中文

A DSH bundle that turns your Wallpaper Engine wallpapers into the background of the DSH web GUI (dsh web).

It discovers the wallpapers on your machine (WaifuX on macOS, Wallpaper Engine on Windows), lists them, and renders video/still wallpapers behind the DSH chat interface with an iOS-style liquid glass effect. You pick the wallpaper from a settings row, fine-tune it with four sliders, and pause/clear it anytime.

Quick start (no command line needed)

macOS (WaifuX wallpapers)

1. Install WaifuX, log in (Steam account), download wallpapers you like — videos and stills both work
2. In DSH, open Plugin Market, search wallpaper, install this plugin (the mac build includes WaifuX support)
3. Open Settings → General → Wallpaper Engine, pick a wallpaper — the chat background updates immediately

No configuration needed: the plugin reads WaifuX's download folder automatically, and wallpapers you download later appear on their own. If text is hard to read, raise the Dim and Border sliders (instant effect). Wallpaper not showing? Restart DSH once after downloading, and make sure WaifuX uses its default download location.

Windows (Wallpaper Engine wallpapers)

1. Install Wallpaper Engine in Steam and subscribe to wallpapers (video / web)
2. Install this plugin from the DSH plugin market, then Settings → General → Wallpaper Engine → pick one

The plugin finds the Steam library automatically, on any drive.

Why only Video and Web wallpapers?

Wallpaper Engine wallpapers come in four types:

Type	Rendered by	Portable to DSH?
Scene	Wallpaper Engine's own 3D engine	❌ No — native 3D (.obj/shaders), only WE can render it
Video	a plain .mp4 file	✅ Yes — plays in a <video> tag
Web	a Chromium (webwallpaper64.exe) host for HTML	✅ Yes — loads in an <iframe>
Application	an injected external window	❌ No

This is the same fundamental limit that applies to mineradio and every other third-party Wallpaper Engine integration: only Video and Web wallpapers are portable. Scene wallpapers are therefore hidden from the thumbnail picker and rotation candidates — they cannot be used as a live background here.

How it works

• Host half (lib/index.js): a Cordis plugin that
  1. locates the Wallpaper Engine install by reading Steam's libraryfolders.vdf (so it works even when Steam is on a non-default drive),
  2. enumerates wallpapers from projects/defaultprojects, projects/myprojects, and steamapps/workshop/content/431960/*,
  3. registers same-origin HTTP routes on the DSH webserver so the browser half can fetch data and stream media directly:
     • GET /wallpaper-engine/inventory → JSON list of wallpapers
     • GET /wallpaper-engine/media/<token> → video / HTML (Range supported)
     • GET /wallpaper-engine/preview/<token> → preview image
• Client half (lib/client.js): a browser module that fetches the inventory and renders the selected wallpaper into a fixed layer behind the app columns, plus a "Wallpaper Engine" row in General settings with a picker.

Install

For users (published version, recommended)

If you simply want to use the plugin, install the published package from npm:

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

…