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.
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:imagedsh-wallpaper:opacitydsh-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.
