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
- 01
Search for `dsh-music-panel` in the DSH plugin marketplace, or have the agent run `plugin_manager install_bundle dsh-music-panel`
- 02
Alternative: from the DSH profile directory run `pnpm add dsh-music-panel`
- 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 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.
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.
07Related DSH workflows
dsh-tui
by ccch1mneyyy
Claude Code 风格全屏终端 TUI:像素鲸鱼顶栏、双流光大字、实时工作状态行、思考流式展开、双击 Esc 时间回溯、上下文进度条 + TPS 仪表;接入 Agent preset(standard/code/minimal/cordis)、Skills、MCP、Goals、Todos、子代理,/ 命令注册表与随附技能(audit/bug/review/practice/pr_comments/release-notes/vuln-check);纯插件挂载零核心改动。
dsh-better-sidebar
by omdsh-dev
Full sidebar workbench with file rendering and editing, terminal, Git, and subagents; third-party plugins can register new tabs.
dsh-media-desk
by woniuniuniu
Capture ideas and generate scripts, titles, covers, images, storyboards, schedules, and review data in a sidebar media workspace.
dsh-drawai
by fourzkw
Create diagram artifacts and use Draw.io-oriented tools from a DSH profile.
08Data and sources
**A local + online music player, natively embedded in DeepSeek Harness.**
**Requires DSH Web / Desktop.** A browser runtime is needed for playback.
Sidebar entry, lyric line above the composer, in-conversation playback, host theme tokens, and light/dark support.
Host: `index.js` + `lib/**`, exposing `/music/*` HTTP routes.
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.
