Introduction

In DSH Web, an agent’s activity status is usually presented as text. If you want these activity statuses to change according to the system sounds currently being output by your computer, and you don’t require the plugin to adapt to individual players, you can use skymecode/dsh-bgm.

dsh-bgm installs directly into DSH’s web profile and monitors the system sounds currently being output by the computer, rather than a specific player. Below is an introduction to its positioning, capabilities, installation method, and notes.

What is it

skymecode/dsh-bgm is a cross-platform system audio rhythm and rhythm game atmosphere plugin for DSH Web, maintained by skymecode, and licensed under MIT.

Verified DSH supported versions include:

  • 0.1.0-rc.8
  • 0.1.1-rc.1
  • 0.1.1-rc.2

Its package.json declares the version as 0.1.2.

Core Capabilities

System Audio Perception

The plugin listens to the system sounds currently being output by the computer, independent of specific players. It obtains the following signals from the default output device:

  • RMS
  • Low Frequency
  • Mid Frequency
  • High Frequency
  • Attack

Activity Line Rhythm

Activity lines will present continuous BPM waveforms, direction changes, and intensity layers.

Rhythm Game Feedback

The plugin provides rhythm game feedback such as predicted notes, judgment lines, Combo, Score, and Accuracy.

Atmosphere Bars

There are 12 RGB spectrum bars on the left and right sides of the widescreen whitespace. The atmosphere bars are fixed at 24 DOM nodes, changing only transform and opacity.

Settlement and Rewards

When a response is completed and judgments are generated in this round, a transparent four-scene settlement plays for about 3.2 seconds. When a score or PERFECT milestone is reached, a card reward pops up.

Platform Support

  • macOS: Supports Apple Silicon and Intel, minimum macOS 14.2; requests system audio recording permission on first run.
  • Windows: Supports Windows 10/11 x64; the Release includes a self-contained helper, requiring no separate .NET installation for the user.
  • Linux: There is currently no system loopback capture helper, so the plugin will quietly enter an unsupported state.

Installation and Usage

One-Click Installation

dsh plugin --profile web add https://github.com/skymecode/dsh-bgm/releases/latest/download/dsh-bgm.tgz

Then start the official Web UI:

dsh web

Play any system sound and then initiate a conversation.

Confirm Mounting

dsh web --dump-config

The following should appear in the output:

# == dsh-bgm
name: dsh-bgm

Fixed Version Installation

If you don’t want latest to point to a new version later, you can use a fixed version:

dsh plugin --profile web add https://github.com/skymecode/dsh-bgm/releases/download/v0.1.2/dsh-bgm.tgz

Uninstall

dsh plugin --profile web remove dsh-bgm

Verify Download Package

If you have downloaded Release files, you can verify them using the SHA256SUMS.txt in the Release:

shasum -a 256 -c SHA256SUMS.txt

Local Source Installation

If you need to build and install from source, you can use the following steps:

git clone https://github.com/skymecode/dsh-bgm.git
cd dsh-bgm
pnpm install
pnpm run typecheck
pnpm run build
dsh plugin --profile web add link:.

Privacy and Performance

  • Raw PCM exists only in the native assistant memory on the local machine; it is not recorded, not saved to disk, and not uploaded.
  • The browser only receives the compressed five rhythm values and timestamps.
  • When prefers-reduced-motion is enabled, main dynamic effects are disabled.
  • The atmosphere bars are fixed at 24 DOM nodes, changing only transform and opacity.

Notes

  • The plugin loads with the current dsh process; it is recommended to check the repository source code, the MIT license, and third-party licenses listed in THIRD_PARTY_NOTICES.md before installing.
  • The Windows audio helper uses NAudio; see THIRD_PARTY_NOTICES.md for third-party licenses.
  • There is currently no system loopback capture helper for Linux; if you rely on system audio capture, it is recommended to verify primarily on macOS or Windows x64.
  • The DSH community directory is an independent site and is not equivalent to the DeepSeek or Huanfang official app store; this article introduces it based solely on repository materials and verified information.

Conclusion

The value of dsh-bgm lies in connecting system audio rhythm to DSH Web’s activity status and rhythm game feedback, using the DSH plugin channel for the installation link.

GitHub Repository: https://github.com/skymecode/dsh-bgm

If used in the DSH community directory, search for the plugin name dsh-bgm.