dsh-opening-animation: Opening Animations for DeepSeek Harness Web Loads

What Does It Do?

linke-e/dsh-opening-animation is a DSH plugin for DeepSeek Harness that plays a chosen opening sequence on a full-screen overlay every time a dsh web page loads, then hands the screen back to the main interface. It solves the abrupt, unceremonious startup of the web client by turning image animations or videos into a transition into the workspace. Maintained by linke-e under the MIT license and written in TypeScript, it is structurally identical to dsh-custom-skin and can run alongside it.

Core Features

• Image openings: supports jpg/png/webp/gif/avif up to 20 MB each with a library cap of 8 entries, offering tap-reveal, wipe-reveal, glitch, and grid-reveal-spread animations.
• Video openings: supports mp4/webm/mkv up to 256 MB each, probes decode support on import, autoplays muted, and ends when playback finishes without truncating long videos.
• Closing transitions: cross-fade, dip-to-bg, and zoom-fade with adjustable speed, while the main interface is held under the overlay so it never flickers.
• Skip anytime: click anywhere or press Esc; the first click always starts the reveal and only Esc skips.
• Settings page: under Personalization › Opening Animation you can upload, select, delete, or clear media, switch animations and transitions, tune advanced parameters, preview, and restore defaults.
• Fail-open safety: storage failures, missing media, decode errors, an 8s load timeout, image duration limits, and 10s of video without progress all remove the overlay immediately with no transition, so the main interface stays usable.

How to Use This Plugin?

After enabling it in the DSH web profile, open the settings page under Personalization › Opening Animation, upload or pick an image or video as your opening asset, then choose an animation type and closing transition. Image animations first wait on a dominant-color backdrop for a click, then reveal the image via a circular spread from the click point or from the image's left edge; dominant-color extraction skips near-black and near-white pixels so dark wallpapers still yield vivid colors. Videos autoplay muted, with scale and horizontal/vertical offsets adjustable as percentages of screen width and height, defaulting to scale 1 and offset 0 for centering. Click anywhere or press Esc to skip during playback, and once the closing transition finishes the overlay is restored and the main interface fades in. If you enable the optional dsh-custom-skin link (off by default), uploaded images are copied one-way into the wallpaper library without changing skin preferences.

How to Troubleshoot This Plugin?

If the opening content never appears, first confirm the media file is still in the library and its format and size are within limits: images must not exceed 20 MB and videos must not exceed 256 MB, or they are skipped outright. If the screen stays on the overlay for too long, a load timeout or stalled video progress has likely triggered the protection path, and the plugin removes the overlay immediately with no transition; check that the media decodes properly and re-import it so decode support can be probed. Storage failures and decode errors also fall through to fail-open removal, so follow the official instructions to fix the underlying issue and then pick your asset again.