DeepSeek Harness Plugin

elysia395/dsh-wallpaper-engine

Stars ★ 6797 Downloads (30d) 151,307 Category Themes & Appearance Added 2026-08-18 npm dsh-plugin-wallpaper-engine

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.

  1. Open Settings → Wallpaper Engine → Library, or pull the mascot cord above the chat.
  2. Pick a thumbnail in the in-panel library and adjust playback / appearance; changes apply immediately and persist on the host.
  3. 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.

Special thanks to all contributors for their contributions to this project ❤️

Content from the project README on GitHub ↗

Links

More in this category

View the whole category →

Community comments

Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.