Skip to content
  • Home
  • Plugin manual
  • dsh-music-plugin

syy-shark/dsh-music-plugin

30Last commit Aug 14, 2026

dsh-music-plugin DSH plugin

This plugin enables DSH agents to control local music playback through natural language. It scans the ~/Music folder, provides a web panel with playlist, and supports play, pause, skip, and queue. Audio is played via macOS afplay or mpv if available.

skills-workflowsbrowser-web

How to install the dsh-music-plugin DSH plugin

dsh plugin --profile web add /Users/shark/项目/DSH-music-plugin

This source command needs manual review. Copying does not run it.

dsh-music-plugin DSH plugin data source

dsh-music-plugin DSH plugin snapshot date: Aug 16, 2026

discovered

What the dsh-music-plugin DSH plugin can do

  • Search local music files by name or path
  • Play a specific song via agent command
  • Pause and resume current playback
  • Skip to the next song in queue
  • Query current playback status
  • Auto-queue new songs when playing (does not interrupt current track)

Where the dsh-music-plugin DSH plugin fits

  • User says 'play some song' and agent finds and plays it
  • User says 'pause' and agent pauses the music
  • User says 'next track' and agent skips to next
  • User asks 'what's playing now' and agent returns status
  • User searches for a specific song by name

Who the dsh-music-plugin DSH plugin is for

  • DSH users who want to control local music via voice or text
  • Mac users who store music in ~/Music folder
  • Users who prefer a web panel to see and control playback

dsh-music-plugin DSH plugin limitations

  • Only supports local folders (default ~/Music), no streaming services like NetEase
  • No progress bar dragging or lyrics display
  • Depends on macOS afplay or mpv (Linux/Windows not supported)
  • Early stage; limited features and may have stability issues

dsh-music-plugin DSH plugin: from the repository README

Quoted from the syy-shark/dsh-music-plugin README, the upstream source of the dsh-music-plugin DSH plugin. Copyright remains with the original authors.

给 DeepSeek Harness 加一个音乐开关：Agent 能搜、播、暂停你电脑里的歌。关掉插件，声音也会停。 今天接的是本机文件夹。以后要接网易云或加播放器界面，都走这个开关，不用推倒重来。 ## 怎么用 1. 把歌放进 `~/Music`（就是 Mac「音乐」文件夹）。 2. 装一次（写进 DSH 配置，以后不用再贴路径）： ```sh npx @deepseek-ai/dsh plugin --profile web add /Users/shark/项目/DSH-music-plugin ``` 3. 以后直接启动： ```sh npx @deepseek-ai/dsh web ``` 打开 `http://127.0.0.1:3080`。右侧会出现「本地音乐」面板：能看见歌单，点播放 / 暂停 / 下一首。也可以继续跟 Agent 说「播放 xxx」，两边是同一套播放。 拔掉： ```sh npx @deepseek-ai/dsh plugin --profile web remove dsh-music-plugin ``` 开发时还可以用 `--patch` 临时挂源码，不写进配置。 能听到声音就算成了。找到好几首时，Agent 会列出路径，你让它按准确路径再播一次。 ## 它能干什么 | 你说的 | Agent 会调 | | --- | --- | | 找一下某首歌 | `music_search` | | 播放 xxx | `music_play` | | 暂停 / 继续 | `music_pause` / `music_resume` | | 下一首 | `music_skip` | | 现在在播什么 | `music_status` | 正在播的时候再点播，会排进队列，不会把当前这首掐掉。 出声用 Mac 自带的 `afplay`。电脑里有 `mpv` 的话会优先用它（flac 更稳）。 ## 配置 都在 [`cordis.yml`](cordis.yml) 里，改完重新加载即可： - `libraryDir`：歌在哪个文件夹，默认 `~/Music` - `backend`：`auto` / `afplay` / `mpv` - `extensions`：当音乐文件的后缀 ## 给别的插件用 别的 DSH 插件可以 `inject: ['music']`，然后调 `ctx.music.play / pause / search`。不用自己去扫文件夹、也不用管 `afplay`。 ## 这次没做 网易云、进度条拖拽、歌词。先做到打开网页就能看见歌、点一下能出声。

Read the full READMERepository license: MIT

dsh-music-plugin DSH plugin questions

How do I install the DSH music plugin?

Run the command: `npx @deepseek-ai/dsh plugin --profile web add /path/to/plugin`. Replace `/path/to/plugin` with the actual path where you cloned the repository. Then start DSH with `npx @deepseek-ai/dsh web` and open http://127.0.0.1:3080.

Can I change the music folder from ~/Music?

Yes, edit the `cordis.yml` file in the plugin root. Change the `libraryDir` field to your desired folder path. After saving, reload the plugin or restart DSH.

Does it work on Windows or Linux?

No, the plugin currently relies on macOS's `afplay` command. If you have `mpv` installed, it may work on other platforms, but it's not officially supported. The readme mentions Mac and afplay/mpv as the only backends.

How do I uninstall the plugin?

Run the command: `npx @deepseek-ai/dsh plugin --profile web remove dsh-music-plugin`. This will remove the plugin from the DSH configuration.

Can I control the music by voice?

The plugin integrates with DSH agent, so you can type or speak commands like 'play', 'pause', 'next', or 'search for song name'. The agent will call the corresponding music functions.