Back to directory

dsh-music-panel

In a curated listMaintenance: Active

aliboder/dsh-music-panel

Local music panel for DeepSeek Harness: scan a folder, browse tracks with covers and tags, and play in a sidebar player with playlists and synced lyrics.

View on GitHubHomepage
$ dsh plugin add dsh-music-panel

39

stars

2

forks

JavaScript

Language

AGPL-3.0

License

2026-11-04

Created

2026-11-20

Last push

MIT-licensed local + online music player that runs natively inside DeepSeek Harness — local library, cloud playlists, synced lyrics, cache, metadata and listening stats sharing one sidebar player and one queue.

DSH integration

Native runtime

Author-claimed

Safety audit

Unaudited

Last verified

2026-11-15

License

MIT

01What can it help you accomplish?

  • Play a folder of local music files from inside DeepSeek Harness

    A scanned multi-root library (songs / albums / artists / folders / favorites / statistics), a vinyl now-playing view, a draggable queue and a sidebar player that restores the last track and position

    DSH Web / Desktop users who keep their own music files on disk and would rather play them from the DSH sidebar than from a separate player

  • Mix cloud playlists from NetEase / QQ Music / KuGou and a self-hosted Navidrome / Subsonic library into one queue

    Cloud playlists, favorites and recent plays behind a QR sign-in, Subsonic search / streaming / lyrics / covers, and a queue that survives switching sources

    People who keep local files next to streaming accounts or their own music server and do not want to switch apps mid-session

  • Fix tags, covers and lyrics without opening a third-party tag editor

    Metadata matching against NetEase / QQ Music / iTunes / MusicBrainz (whole-track or per-field), cover replacement, embedded-lyric write-back with a backup, duplicate detection and a trash that restores by original path

    Users maintaining a large local library who want metadata repair in the same window as playback

02How to install into DeepSeek Harness

Prerequisites

  • DSH Web / Desktop host — the plugin needs a browser runtime for playback and uses the network and storage the host is already configured with
  • Version 0.27.3 or newer — versions up to 0.27.2 lacked the `./package.json` export and DSH silently treated the package as a non-client package
  • For the npm route: the DSH profile directory as the working directory

Installation steps

  1. 01

    Search for `dsh-music-panel` in the DSH plugin marketplace, or have the agent run `plugin_manager install_bundle dsh-music-panel`

  2. 02

    Alternative: from the DSH profile directory run `pnpm add dsh-music-panel`

  3. 03

    Then restart DSH completely — a page refresh is not enough

Verify the integration

  • A music icon appears in the sidebar after the full restart; opening it shows the music panel
  • No icon: confirm the version is 0.27.3 or newer, then disable and re-enable the music plugin from the marketplace
  • Still no icon: check the profile’s `cordis.patch.yml` for a stale `id: music` / `disabled: true` override and remove that block

Rollback

  • Disable the music plugin from the DSH plugin marketplace and restart — when the plugin manager and the marketplace disagree, the final profile composition wins
  • If a `- id: music` / `disabled: true` block from `cordis.patch.yml` keeps it off, remove that block and restart; do not remove the `- insert:` music entry above it

03DSH integration and capability boundaries

DSH integrationNative runtime

DSH plugin bundle: the Host side ships `index.js` + `lib/**` and exposes `/music/*` HTTP routes, while the browser side is a single-file `client.js` built from `src/**` that renders the sidebar panel, the lyric line above the composer and in-conversation playback with the host-provided `react`; install it from the DSH plugin marketplace or with `pnpm add` in the DSH profile, then restart DSH.

  • Local library scan & playback

    one or more music folders, with a configurable subfolder depth→an indexed library browsable by song / album / artist / folder / favorites / statistics, with repeat modes, shuffle, seek and per-track resume

  • Online providers and a shared queue

    a NetEase / QQ Music / KuGou account via QR sign-in, or a Navidrome / Subsonic server URL, username and password→cloud playlists, favorites and recent plays, plus Subsonic search / streaming / lyrics / covers, all playing through the same queue as local files

    cookies, tokens and Navidrome’s salt + token are written to the local `~/.dsh/music/providers.json` (mode 0600)
  • Audio cache

    online tracks as they are played→a write-while-playing cache, default cap 10 GB with LRU eviction, listed and clearable from Settings → Cache

    cache and playback history are kept under `~/.dsh/music/`
  • Lyrics and translations

    embedded lyrics, `.lrc` files, or an online lyric source→line highlighting, translations, typography and alignment controls, a ±0.5s offset, and write-back to embedded lyrics with an automatic backup

  • Volume leveling and a 10-band equalizer

    the tracks being played→EBU R128 / BS.1770 per-track gain without ffmpeg, plus a 10-band equalizer (Q=1.41, ±12 dB) with AutoEQ headphone curves and Winamp factory presets

  • Metadata matching and library cleanup

    local tracks plus online metadata sources (NetEase / QQ Music / iTunes / MusicBrainz)→whole-track or per-field matching, editable title / artist / album / year / track and disc numbers / genre / composer / lyricist / comment fields, cover replacement, duplicate detection and trash restore

    deletions go to the plugin trash instead of being erased immediately

04Who is it for? When not to use it?

Good for

  • DSH Web / Desktop users who keep their own music files on disk and would rather play them from the DSH sidebar than from a separate player
  • People who keep local files next to streaming accounts or their own music server and do not want to switch apps mid-session
  • Users maintaining a large local library who want metadata repair in the same window as playback

Not for

  • DSH Web / Desktop only. Playback needs a browser runtime, so a host without one cannot play audio even though the plugin installs.
  • The online providers are reached through public, unofficial APIs. They may change, throttle or break; failures surface in the UI and do not affect local playback.
  • Opting into “Save password, enable complete library” writes the Navidrome password in plaintext into the local `~/.dsh/music/providers.json` on top of the salted token, which widens the impact of a local account compromise.

05Compatibility, maintenance and safety notes

  • DSH Web / Desktop only. Playback needs a browser runtime, so a host without one cannot play audio even though the plugin installs.
  • The online providers are reached through public, unofficial APIs. They may change, throttle or break; failures surface in the UI and do not affect local playback.
  • Opting into “Save password, enable complete library” writes the Navidrome password in plaintext into the local `~/.dsh/music/providers.json` on top of the salted token, which widens the impact of a local account compromise.
  • The complete-library view relies on Navidrome’s internal `/api/song` endpoint, which may change between versions and falls back to random sampling; the Subsonic endpoints are currently tested only against Navidrome 0.64.2.
  • A stale `- id: music` / `disabled: true` block in the profile’s `cordis.patch.yml` keeps the plugin off even when the plugin manager shows it enabled; the final profile composition wins.
2026-11-042026-11-13v0.35.0

MIT · latest release v0.35.0 (2026-11-14T13:14:47Z)

06Frequently asked questions

How do I install it into DeepSeek Harness?

Search for `dsh-music-panel` in the DSH plugin marketplace, or run `plugin_manager install_bundle dsh-music-panel`; from the DSH profile directory you can also `pnpm add dsh-music-panel`. Then restart DSH completely — a page refresh is not enough — and a music icon appears in the sidebar.

Which DSH host do I need?

DSH Web / Desktop only. The plugin needs a browser runtime to play audio and uses the network and storage the host is already configured with, so a headless or server-only DSH host is not supported.

No music icon after installing — what now?

Check the version first: 0.27.3 or newer. Versions up to 0.27.2 lacked the `./package.json` export, so DSH treated the package as a non-client package and never loaded the browser bundle. Then quit and restart DSH fully, disable and re-enable the plugin from the marketplace, and finally look for a stale `- id: music` / `disabled: true` block in the profile’s `cordis.patch.yml` — remove it without touching the `- insert:` entry above.

Where do cookies and cached audio go?

Everything runs locally. Cookies, tokens and Navidrome’s salt + token live only in `~/.dsh/music/providers.json` (mode 0600), and cache plus playback history sit under `~/.dsh/music/`. The browser side never calls external domains — search, stream resolution, lyrics and covers are proxied by the Host. The one exception is opting into “Save password, enable complete library”, which adds the Navidrome password in plaintext to that same file.

Is the Navidrome full-library view on by default?

No. Out of the box “All songs” is a random sample; you page the complete library only after enabling “Save password, enable complete library” in the connection form. That view uses Navidrome’s internal `/api/song` endpoint, so it may break between Navidrome versions and fall back to sampling without affecting search, playback or favorites.

08Data and sources

  • Author-claimedgithub.com70a370eb8e4a…

    **A local + online music player, natively embedded in DeepSeek Harness.**

  • Author-claimedgithub.com70a370eb8e4a…

    **Requires DSH Web / Desktop.** A browser runtime is needed for playback.

  • Author-claimedgithub.com70a370eb8e4a…

    Sidebar entry, lyric line above the composer, in-conversation playback, host theme tokens, and light/dark support.

  • Author-claimedgithub.com70a370eb8e4a…

    Host: `index.js` + `lib/**`, exposing `/music/*` HTTP routes.

  • Author-claimedgithub.com70a370eb8e4a…

    Web: `client.js` is built from `src/**` as a single CJS module with no runtime dependencies beyond the host-provided `re…

This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-11-15. Found an error? Submit a correction.

🏆

Best DeepSeek Harness Plugins

Twelve plugins worth installing first — picked from the whole catalog, across every category.

DSH Plugins is an independent community directory of DeepSeek Harness plugins. Not affiliated with or endorsed by DeepSeek. Third-party plugins are not security-audited — review the source before installing.

New DeepSeek Harness plugins, weekly. No spam.