Skip to main content

dsh-wallpaper-engine

117Stars10Forks7Issues0Watchers

Renders video/web wallpapers and scene still frames from local Wallpaper Engine to the DSH web interface background, with support for liquid glass effect, custom wallpaper uploads, and slideshow lists.

Evidence4/5methodologySourceInstallMaintenanceDSH versionSecurity scan
Machine-auditedInstall commandRepo verifieddsh-plugin topicLicenseREADMEAI wiki
Language
JavaScript
Branch
main
deepseek-harnessdsh-plugindsh-plugin-marketdsh-pluginsliquid-glassthemewallpaper-engine

Install

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

Run the command above in your terminal to install this plugin via the dsh CLI. You can switch Profile in the top-right corner. New to dsh? Read the beginner tutorial

Install via your agent

Install the DeepSeek Harness plugin elysia395/dsh-wallpaper-engine for me: review the repository at https://github.com/elysia395/dsh-wallpaper-engine first, then run the install command and verify the plugin loads successfully.

Paste this instruction to the DSH Web GUI assistant — it will install and verify for you.

At a Glance

Transform Wallpaper Engine wallpapers installed via Steam on your machine into backgrounds for the DSH web chat interface (dsh web): automatically scan your wallpaper library, render video and web wallpapers natively behind the interface, overlaid with an iOS-style liquid glass effect.

Key Features

  • Automatically scan local Wallpaper Engine installation directory and Steam Workshop (locates non-default drive Steam libraries by reading libraryfolders.vdf)
  • Render portable Video (.mp4) and Web (HTML) wallpapers natively to the DSH interface background layer, with video supporting mute autoplay and seek dragging
  • Extract main textures from Scene wallpaper .pkg containers as static frame backgrounds (supports JPEG passthrough, PNG decoding, and DXT series compressed textures)
  • Add a top-level "Wallpaper Engine" settings page in DSH settings, with liquid glass appearance (6 color presets + custom color picker), glass transparency and color adjustment
  • Support custom uploads of JPG / PNG / MP4 as wallpapers, with customizable storage directory; support video playback speed (0.5x–2x), horizontal flip, hide/restore (soft delete)
  • Support user-created slideshow lists (any number, each with independent interval and order), first startup automatically imports a copy from Wallpaper Engine's own playlist

Technical Implementation

  • Language: JavaScript (Node ESM) + React client module
  • Key Dependencies: @deepseek-ai/cordis ^4.0.1 (host-side Cordis plugin framework), @deepseek-ai/dsh-client-runtime >=0.1.0-rc.6, @deepseek-ai/dsh-client-ui-slots >=0.1.0-rc.6, @deepseek-ai/dsh-host-webserver >=0.1.0-rc.6
  • Architecture Pattern: Dual-end separation—the host side is a Cordis plugin (lib/index.js), registering same-origin HTTP routes on DSH WebServer; the client side is a browser module (lib/client.js, compiled from src/client.js via scripts/build-client.mjs), injecting settings top-level page via ctx.slots. Settings migrated from browser localStorage to host-side file (~/.dsh-wallpaper-engine/config.json), independent of port
  • Entry Files: lib/index.js (host), lib/client.js (client, build artifact, canonical source is src/client.js)

Use Cases

For users who want their DSH chat interface to stand out from the generic solid color backgrounds, and want to use their existing Wallpaper Engine wallpaper library from Steam as decoration—particularly users who like the liquid glass style, need video/web wallpaper dynamic backgrounds, and don't want settings to be lost when changing ports or browsers. This plugin is designed specifically for Windows (macOS has a community-maintained derivative package).

Prerequisites and Compatibility

DependencyMinimum VersionDescription
DSH>= 0.1.0-rc.6Inferred from peerDependencies (cordis ^4.0.1, dsh-client-runtime/ui-slots/host-webserver all rc.6+)
NodeNot declaredNo engines field in package.json
PlatformWindowsHost locates Wallpaper Engine by reading Steam libraryfolders.vdf and Windows registry, only applicable to Windows; macOS maintained separately by community as dsh-plugin-wallpaper-engine-mac
Native ModulesNoneOnly uses built-in modules like node:fs node:path node:os node:crypto node:child_process

Installation

dsh plugin --profile web add github:elysia395/dsh-wallpaper-engine

Configuration Options

SettingTypeDescriptionDefault
Selected WallpaperSelectorCurrent active wallpaper from your library (WE + custom uploads)None selected
Wallpaper BlurSlider 0–60pxBlur applied to the wallpaper itself0
Darken (Mask)Slider 0–90%Dark mask depth between text and wallpaper25%
BorderSlider 0–90%Border and divider contrast35%
GlassSlider 0–60pxGlass blur radius for chat bars/bubbles/sidebar24px
Video SpeedSelector 0.5x–2xVideo wallpaper native playbackRate1x
Horizontal FlipToggleCSS mirror (video/web/uploaded images)Off
Content RatingDropdownWallpaper Engine's G/PG13/R rating filterEveryone
Type FilterDropdownVideo/Web/Image/AllAll
Card StyleToggleCompact CD rack style vs regular paginationRegular pagination
Settings Window Liquid GlassToggleReplace entire DSH native settings window with glass styleOn
Theme ColorColor (6 presets + picker)Unified theme color for buttons/toggles/links/navigation选中/sliders#4f8cff Classic Blue
Glass ColorColor (6 presets + picker)Base tint for settings window glassLight White / Dark Night Blue
Glass TransparencySlider 0–60%Glass panel opacity (settings window/input bar/bubbles/sidebar)12%
Upload DirectoryPath inputCustom storage location for wallpaper files~/.dsh-wallpaper-engine/uploads

FAQ

Q: Can macOS users use this?

A: This plugin is primarily for Windows because the Wallpaper Engine client itself is a Windows application on Steam, and the host side directly reads the Windows registry and libraryfolders.vdf. macOS is separately published by community maintainer Jerry as the npm package dsh-plugin-wallpaper-engine-mac, using a different mechanism.

Q: Why do I only see a static image when I select a Scene wallpaper, with no animation?

A: Scene wallpapers in Wallpaper Engine are driven by its built-in 3D engine, which browsers cannot replay (shaders/particles/geometry animations). The plugin extracts the main texture from the scene.pkg container, selected by "artistic likelihood" score (JPEG passthrough or DXT decoding), as a static background—photo/illustration scenes look close to the original, but pure shader/BC7/video texture-driven scenes automatically fall back to the workshop preview image (preview.jpg), which is expected behavior.

Q: My settings are all gone after DSH Desktop restarts?

A: Since v0.4.0, all settings (selected wallpaper, color scheme, transparency, layout, slideshow, hidden, speed, flip, etc.) are stored in the host-side file ~/.dsh-wallpaper-engine/config.json, independent of port, browser, or browser data—restarting/changing ports/clearing cache/switching browsers won't lose settings. Old browser localStorage configs are automatically migrated on first startup.

Q: Will uploaded custom wallpapers fill up my C drive?

A: By default they write to ~/.dsh-wallpaper-engine/uploads (usually in the C: drive user directory on Windows). You can change the "Upload Directory" in settings to any drive's absolute path, and existing files will be automatically migrated; if you don't want to migrate old files, you can choose "Don't Migrate" to leave them in their original location.

Q: Text is hard to read on some wallpapers—what should I do?

A: Increase the "Darken" and "Border" sliders in "Wallpaper Effects", and add some "Wallpaper Blur" if needed. Colorful or complex patterned wallpapers may also require switching between DSH's "Light/Dark" themes to find the most comfortable one for the current wallpaper. All sliders take effect immediately without refreshing the page.

Q: How to completely uninstall?

A: First clear uploaded custom wallpapers in plugin settings, then delete the entire ~/.dsh-wallpaper-engine directory (including config.json, uploads, cache subdirectories), finally use dsh plugin --profile web remove to uninstall the plugin. Deleting this directory won't affect your Steam Wallpaper Engine installation.

Difficulty Level

Beginner — After one-time installation, all adjustments are done in the visual "Settings → Wallpaper Engine" page with no manual configuration items needed; regular users can follow the on-page prompts.

Known Issues and Limitations

  • Scene (native 3D) and Application (external window) wallpapers cannot be embedded in web: Scene only displays as extracted static frames, Application doesn't appear in selector or slideshow candidates at all
  • Scene main textures don't support BC7, RGB565, 16-bit float, etc.; on decode failure it automatically falls back to preview.jpg, pure shader/pure particle scenes typically have no extractable main texture, resulting in a grayish white mask effect
  • Browsers need to allow muted <video> autoplay: DSH runs on loopback so modern browsers allow this by default, but if your browser has strict policies you'll need to manually adjust
  • Host side only exposes Wallpaper Engine files it has enumerated, not providing arbitrary file system access; custom uploaded files only exist locally, never uploaded to any remote server
  • Selector text is mixed Chinese/English (this bundle hasn't yet integrated with DSH's locale namespace)

Read the usage guide →

Install steps, key points, FAQ and compatibility for this plugin — auto-derived from indexed fields.

Listing badge

Listed on deepseek-plugin.org
[![Listed on deepseek-plugin.org](https://img.shields.io/badge/listed_on-deepseek--plugin.org-007EC6)](https://deepseek-plugin.org/plugins/elysia395/dsh-wallpaper-engine)

Paste this markdown into your GitHub README to link back to this listing. The badge only states the listing — not a security endorsement.

← Back to plugin directory