dsh-wallpaper

English | 简体中文

Persistent custom wallpaper for the DeepSeek Harness Web profile.

dsh-wallpaper adds one settings row under Settings -> General:

• choose a local image or MP4 video;
• tune surface opacity and wallpaper blur;
• remove the wallpaper at any time.

Images are resized in the browser. MP4 videos up to 300 MB are uploaded only to the local DSH Host. When ffmpeg and ffprobe are available, they are compressed into high-quality H.264 wallpapers with a single fast encoding pass, a target near 18 MB, 1080p maximum resolution, and 30 fps maximum. Audio is removed because a background video is muted. Without those optional tools, the original MP4 is retained so video wallpapers remain usable, although they may take more disk space. Uploads stream directly to a temporary local file rather than being buffered in the DSH Host process. The result is stored under ~/.dsh/wallpapers, while localStorage keeps only its local URL. Replacing or removing a video deletes its prior local file, and startup removes old unreferenced wallpaper videos. Video wallpapers are muted, looped, and auto-played; media is restored on the next launch. Its bundle patch also fixes the Web server to port 9191: browser storage is scoped to protocol + host + port, so a random port would make saved wallpaper appear to disappear after every restart.

Requirements

Image wallpapers need no extra software. Video wallpapers also work without extra software by retaining the original MP4. Install ffmpeg and ffprobe on PATH for the DSH Host process to enable local compression.

Screenshots

Wallpaper applied to the Web profile (image background with adjusted surface opacity):

The wallpaper settings card under Settings -> General:

Compatibility

• Target: the DeepSeek Harness Web profile (dsh web or the desktop build's Web UI). The settings card is rendered by the DSH client runtime and needs a modern browser with localStorage support.
• The bundle patch pins the Web server to http://127.0.0.1:9191; see Fixed origin below for why, and what to do when the port is occupied.
• Image wallpapers require no external tools. Video wallpapers accept MP4 files up to 300 MB; without ffmpeg/ffprobe on PATH the original file is kept as-is, otherwise it is compressed locally to H.264 (target ~18 MB, max 1080p, max 30 fps, audio removed).
• Peer dependencies: react ^18.2.0, @deepseek-ai/cordis ^4.0.1, and the DSH client packages listed in package.json. They are provided by the DSH host installation; do not install them manually.

Install

Install the public npm package in one command:

dsh plugin --profile web add -w @frog755/dsh-wallpaper

Restart dsh web after initial installation so the host loader reads the new bundle patch. Open Settings -> General -> Wallpaper to choose your image.

For local development from a cloned repository, run this from the repository root instead:

dsh plugin --profile web add -w .

Changing lib/client.js later is picked up by the DSH client HMR chain; hard-refresh the page if the browser has an older module active.

Fixed origin

The package patch pins DSH Web to http://127.0.0.1:9191. This is intentional: localStorage isolates values by origin, including the port.

If 9191 is occupied, either stop the process holding it or change the port in cordis.patch.yml before starting DSH. Changing the port creates a different browser storage namespace, so the wallpaper must be selected once on that new origin.

What is persisted

All settings remain local to the current browser profile:

• dsh-wallpaper:image
• dsh-wallpaper:opacity
• dsh-wallpaper:blur

On its first run, the plugin imports an existing dsh-skin wallpaper and its opacity/blur values when no dsh-wallpaper value exists. This lets a profile migrate without selecting the background again.

No image is sent to a server. Images are stored as compressed data URLs and are reduced to keep the browser storage footprint bounded.

Development

The client bundle uses DSH's window.__ModuleLoader__.load format, so no build step is needed. It is served by dsh-client-modules; dsh-client-hmr watches its content and sends a rebuilt notification to the browser when it changes.

Attribution

This independent wallpaper-focused plugin was derived from, and substantially reworked from, the wallpaper component of KinGao294/dsh-skin, which is licensed under MIT. The original copyright notice is retained in LICENSE.