Preface

The DSH plugin mechanism allows extending capabilities in the web interface. For dsh web, the background is typically determined by the host stylesheet; if you want to use Wallpaper Engine .mpkg files, Steam Workshop raw directories, or local videos/webpages/images as backgrounds, you need a dedicated plugin that handles background loading and appearance adaptation.

The following introduces dsh-mpkg-wallpaper.

What This Is

dsh-mpkg-wallpaper is a DSH Web wallpaper engine plugin maintained by XHR666, used to add background wallpapers to the DeepSeek Harness Web interface (dsh web). It bundles Wallpaper Engine .mpkg parsing, Steam Workshop raw directory discovery, video/webpage/image wallpapers, time-based wallpapers, blur, theme appearance, local wallpaper library, rotation, playback controls, settings persistence, and update checking into a single plugin.

Core Capabilities

Wallpaper Sources

  • .mpkg: Parsed directly in the browser without uploading to third parties.
  • Steam Workshop raw directories: Automatically discovered, supporting video, web, and scene types.
  • Regular wallpapers: Supports video, webpage, and image/GIF/URL wallpaper loading.

Time-Based Wallpapers

Supports automatic switching between multiple time periods for time-based wallpapers, as well as manually locking a specific period.

Blur and Appearance

  • Unified blur control applies background blur to the entire screen.
  • Dialogs, settings panels, popups, overlays, sidebars, etc., can independently control blur.
  • Provides glass appearance capabilities such as theme colors, unified fog, and panel matching of wallpaper colors.
  • Liquid glass remains an experimental feature, disabled by default, and not recommended for daily use.

Wallpaper Library and Rotation

Supports a local wallpaper library, custom directories, wallpaper switching, and scheduled rotation. You can switch wallpapers using previous/next controls or set up timed automatic rotation.

Playback Controls and Power Saving

  • Video/webpage wallpapers support pause/play controls.
  • Adjusting unrelated settings does not trigger replay.
  • Three power-saving strategies can be enabled: pause when the page is hidden, pause when the window loses focus, and pause when running on battery power.

Large File Playback

Supports hybrid mode streaming playback for large files, including files larger than 600MB.

Settings and Updates

  • Settings are persisted to browser localStorage and ~/.dsh-mpkg-wallpaper/settings.json.
  • Supports exporting/importing appearance-related settings JSON files for backup and restoration.
  • Supports “Check for Updates” via version comparison, as well as “One-Click Update” to pull the latest code from GitHub and restart to apply changes.
  • Can detect and adapt to dsh-better-sidebar.

Installation and Enabling

Verified materials do not provide an official installation command; this article does not fabricate one. Before enabling, please review the repository instructions or the plugin directory documentation, and confirm the runtime environment meets the requirements:

node >=20

Since the plugin executes local logic within the DSH web interface, you should review the source code, dependencies, and license before installation.

Typical Usage

  1. After entering the settings page, you can view the read-only parameters of .mpkg in the “Adjustable Parameters” collapsible section; resolution, language, volume, and other parameters for some webpage wallpapers can be modified in the same collapsible section.

  2. When the current wallpaper is a video or webpage wallpaper, click the pause/play button on the settings page to control the playback; adjusting unrelated settings will not trigger replay.

  3. In the “Other” tab, enable pause when the page is hidden, pause when the window loses focus, and pause when running on battery power.

  4. In the “Other” tab, export or import appearance-related settings JSON files.

  5. Use previous/next to switch wallpapers, or set up timed automatic rotation.

  6. Use “Check for Updates” for version comparison, or use “One-Click Update” to pull the latest code from GitHub and restart to apply changes.

Applicable Scenarios and Notes

Suitable for users who want to use Wallpaper Engine wallpapers, local video/webpage/image backgrounds in dsh web, and need control over blur, theme appearance, rotation, and power-saving strategies.

Notes:

  • Webpage wallpapers (HTML) are experimental; some wallpapers that depend on external SDKs or special interaction logic are not fully adapted.
  • Application (.exe) wallpapers are completely excluded to prevent virus injection.
  • Scene wallpapers cannot be fully reproduced on the web side; only compromise solutions such as static frame extraction or layer compositing are provided.
  • Browser compatibility reference: Chrome/Edge recommended; Firefox/mobile may be limited by autoplay policies, performance, or API support.
  • The plugin runs with the current DSH process permissions; review the source code and license before installation.

Acquisition

GitHub repository: https://github.com/XHR666/dsh-mpkg-wallpaper

The directory page URL does not appear in the verified materials; the community directory is an independent site with no official affiliation to DeepSeek/HiFly, and should not be regarded as an official app store.