Introduction

In DSH’s web interface, session state is usually represented by a logo or status dots. dsh-bloub-mood replaces the favicon, sidebar title, and homepage title with bloub mood avatars, making state changes directly visible on the interface.

It also provides desktop shortcut functionality: creating desktop entries for the shared dsh web backend on macOS/Windows.

What is this

dsh-bloub-mood is a DSH plugin maintained by Yuuhann1999, licensed under the MIT license.

It targets DSH web profiles, primarily addressing two problems:

  1. Replacing web-side logos/status dots with customizable bloub mood avatars.
  2. Providing macOS/Windows desktop launch entries for the dsh web backend.

Core Features

Session State Avatar

  • Favicon, sidebar title, and homepage title play native bloub engine animations based on the session state.
  • Supports 8 shapes × 12 colors × 16 expressions combinations.
  • Click any black ball on the interface to randomly switch to one of the 16 expressions.
  • Each expression includes a native 180-frame blinking animation.

Settings Customization

  • Shape, color, and text are customizable in the settings page.
  • The settings page supports bilingual (Chinese/English) and switches in real-time according to the interface language.

Desktop Shortcut

  • macOS/Windows desktop entries share the dsh web backend.
  • Reuse the backend directly when it is online; automatically launch dsh web and wait for readiness when it is offline.
  • The macOS form is a native independent App shell.
  • The Windows form is a Chromium app window.
  • The macOS native shell depends on Xcode Command Line Tools; it falls back to browser window mode automatically if missing.
  • Windows has no extra dependencies and uses the system PowerShell to create shortcuts.
  • On platforms other than mac/win, the settings page will prompt that desktop shortcut is not supported.
  • Toggling the desktop shortcut switch off is equivalent to removing the entry file; it respects the persisted state after a restart and will not rebuild it arbitrarily.
  • macOS failure handling: error page in the window + one-click retry, up to 150 seconds.
  • Windows failure handling: popup prompt + logs, up to 120 seconds.

Desktop shortcut logs are located at:

~/.dsh/logs/desktop-entry.log

Usage

  • The plugin is pure client + webServer routes.
  • No API key, zero network requests.

Installation and Enablement

  1. Execute the installation command:
dsh plugin --profile web add dsh-bloub-mood

  1. Restart dsh web and refresh the page.

  2. Select a shape in “Settings → Mood Icon” and turn on desktop shortcut.

Typical Usage

Switching Expressions

Click any black ball on the interface to randomly switch to one of the 16 expressions.

Using Desktop Shortcut

Reuse the backend directly when it is online; automatically launch dsh web and wait for readiness when it is offline.

Configuration Locations

Mood configuration is stored in:

localStorage

Desktop shortcut configuration is stored in:

$DSH_HOME/dsh-bloub-mood/desktop-entry.json

Desktop shortcut logs are located at:

~/.dsh/logs/desktop-entry.log

Applicable Scenarios and Notes

Suitable for users who need to add status feedback on the DSH web interface and wish to open the backend directly from the desktop.

Notes:

  • The plugin runs with the permissions of the current dsh process.
  • It is recommended to check the source code, dependencies, and MIT license before installing.
  • The macOS native shell depends on Xcode Command Line Tools; it falls back to browser window mode if missing.
  • Windows uses the system PowerShell to create shortcuts.
  • Desktop shortcuts are not supported on platforms other than mac/win, and the settings page will prompt a warning.

Conclusion

dsh-bloub-mood combines the visual state of DSH web and desktop shortcuts into a single plugin: state changes are visible, and desktop launch can be toggled on or off.

The GitHub repository is:

https://github.com/Yuuhann1999/dsh-bloub-mood

The community directory URL was not provided in the verified materials; if using it from the community directory, you can search by the plugin name dsh-bloub-mood.