dsh-audio-player
IdentifiedInline audio player for generated clips and songs: the play_audio tool renders a player in the conversation (promoted into the transcript when the host supports it, otherwise inside the tool-call fold
dsh-audio
An inline audio player for DeepSeek Harness (DSH).
When the agent produces a sound — a voice clip, a song, a generated melody — this plugin renders it directly in the conversation as a player you can click. No file manager, no "open this path yourself", no second app.
agent calls play_audio(path)
│
├─ host: registers the play_audio tool + a streaming audio route
└─ client: renders <audio controls> in the transcript (promoted node)
and falls back to a card inside the tool-call fold
Install
dsh plugin --profile web add dsh-audio
or, from a checkout:
dsh plugin --profile web add /path/to/dsh-audio
Then restart DSH.
Use
The agent calls play_audio with an absolute path:
{ "path": "C:/Users/me/Music/take-01.wav", "title": "take 01" }
You get a player in the transcript. The same result also stays available inside the collapsed tool call, so it can be replayed later.
Configuration
Only files under an allow-list may be served — the route is reachable from the local web port, so "any absolute path" would be a file-read hole. Resolution order:
DSH_AUDIO_ROOTS— semicolon-separated absolute directoriesset DSH_AUDIO_ROOTS=D:\work\audio;E:\music~/.dsh/dsh-audio-roots.json— a JSON array["D:/work/audio", "E:/music"]- Default: the process working directory, plus the user's
MusicandDocumentsfolders.
What it does with the request
- Range requests — the player can seek;
206/416/HEADare handled. - Streaming — files are piped, never read whole into memory.
- Type allow-list — wav, mp3, ogg, opus, m4a, aac, flac, webm.
- Size cap — 512 MB per file.
Development
node test/verify.mjs # host: tool registration, path guard, route, Range
node test/client.mjs # client: component rendering, promotion definition
Both run offline: they build a fake cordis context (and a fake module loader for the browser half), so no DSH instance is needed.
Limitations
- Paths are matched literally; symlinks are resolved before the allow-list check.
- The promoted node needs a host that exposes
uiConversation. On older hosts the player still appears, just inside the tool-call fold.
License
MIT
Comments
Loading…
Similar plugins
by OrderG-X
Inline video and audio playback inside DeepSeek Harness: a play_video tool plus a native player at the turn tail, served by a signed Range-capable streaming route.
★ 3
↓ 490/wk
MIT
JavaScript
Nov 11, 2026
dsh plugin --profile web add dsh-video-previewby xiaokaizhou
Renders local audio/video paths as inline, playable previews in DSH chat: replaces paths with <audio>/<video> players backed by same-origin /api/media-preview/* route, with explicit error statuses.
★ 0
MIT
JavaScript
Sep 21, 2026
dsh plugin --profile web add media-previewby jypjypjypjyp
Music composition for DeepSeek Harness: the model writes a score against a bundled composing skill, and a play_score tool renders it as an inline card with a piano roll, Web Audio playback and WAV/JSON export.
★ 1
JavaScript
Oct 19, 2026
dsh plugin --profile web add @jypjypjypjyp/dsh-music-studioby Wisdoverse
Renders image, video, and audio paths and URLs from DSH conversations inline, with workspace-confined local reads and an optional ComfyUI proxy.
★ 4
↓ 691/wk
MIT
JavaScript
Nov 1, 2026
dsh plugin --profile web add @wisdoverse/dsh-inline-media-viewerby Goothe13-gugu
用于Deepseek Harness的插件,让你的大模型边思考边唱歌。A plugin for Deepseek Harness (DSH) to play music or audio when your LLM is thinking.
★ 0
MIT
JavaScript
Sep 23, 2026
dsh plugin --profile web add dsh-audio-cueby AKS1st
Media player for the DSH dock: plays audio (music player) and video (fullscreen) files, streamed over HTTP Range.
★ 0
MIT
TypeScript
Sep 11, 2026
dsh plugin --profile web add dock-media