Introduction

The DSH ecosystem emphasizes “everything is a plugin,” and visual extensions for the Web GUI can also be completed by a plugin. dsh-pixel-ui is a DSH skin plugin maintained by zhang66633 designed to reskin dsh Web GUI into a pixel RPG style. It provides four themes and retains an exit point to instantly switch back to the modern default UI, making it suitable for users who wish to quickly switch their appearance while keeping the default UI available.

Core Features

Positioning

dsh-pixel-ui is a visual plugin that does not add new DSH core capabilities; it primarily reskins the existing dsh Web GUI into a pixel RPG style.

Themes

The plugin provides four theme IDs:

  • pixel-wood: Pixel · Cabin
  • pixel-paper: Pixel · Parchment
  • pixel-warm: Pixel · Warm Sun
  • pixel-retro: Pixel · Terminal Green

Users can also click “Modern Default” to completely exit the skin.

Fonts and Styles

The plugin uses fusion-pixel and Press Start 2P pixel fonts and includes the following styles:

  • Step-shaded hard shadows
  • 8-bit raised buttons
  • Wood grain stripes
  • CRT scanlines
  • Vignette
  • Pixel cursor

Switching and Persistence

A “Pixel Theme” row will be added to the settings page to switch themes. The last selection is saved to dsh-pixel-ui:theme in the browser’s localStorage. The default theme is pixel-wood and is automatically activated only upon first installation; thereafter, existing choices are respected.

Installation and Activation

Execute in the dsh terminal:

dsh plugin add dsh-pixel-ui

Restart dsh or DSH Desktop after installation.

DSH Desktop users can select Open DSH Terminal from the right-click menu of the system tray and execute in the terminal:

dsh plugin add dsh-pixel-ui

If DSH Desktop needs to remember the theme selection, you can specify a fixed port for dsh-desktop.port in the settings.

Typical Usage

  1. Restart dsh or DSH Desktop after installation.

  2. The default theme pixel-wood is automatically activated upon the first load.

  3. Go to “Settings → General → Pixel Theme” and select one of the four skins.

  4. Click “Modern Default” to completely exit the skin; the selection will be remembered.

Compatibility and Permissions

  • Compatible with dsh ecosystem versions 0.1.0-rc.6 ~ 0.1.0-rc.7.
  • Compatible with DSH Desktop 2.0.x.
  • Browser support: modern Chromium / Firefox.
  • The plugin has no configuration options, no environment variables, and no sensitive items.
  • The host process only reads font files within the package and registers the /dsh-pixel-ui/fonts/* route.
  • There are no network requests, telemetry, or credential reading on the browser side; it only stores a theme ID in localStorage.
  • The plugin license is MIT; the font licenses include fusion-pixel (MIT) and Press Start 2P (SIL OFL).

Notes

DSH plugins run with the permissions of the current dsh process; it is recommended to check the source code and license before installation.

Repository Address:

https://github.com/zhang66633/dsh-pixel-ui