dsh-plugin-notify-sounds: Audible Alerts for DeepSeek Harness
billcx330/dsh-plugin-notify-sounds
A DSH plugin that chimes when the agent needs your decision or finishes a task, with OS notifications and a taskbar title mark that go quiet once seen.
dsh-plugin-notify-sounds adds an audible layer to DeepSeek Harness. DSH normally signals progress only through status dots and sidebar marks, so the moment you switch windows you can neither see nor hear anything while the agent may be stuck waiting for one sentence from you. This plugin plays distinct chimes for approvals, plan reviews, questions, and sessions going from running to idle, raises a clickable OS notification in the background, and marks the taskbar title with Waiting for you or Finished. Unanswered decisions re-ping every 1/5/15/30 minutes and go permanently quiet once seen. Nine built-in sounds are synthesized live, and custom ringtones can be uploaded.
How to Install
dsh plugin --profile web add dsh-plugin-notify-sounds- Category
- UI & Experience
- Platform
- DSH Plugin
- Author
- billcx330
- Distribution
- Plugin
dsh-plugin-notify-sounds Key Features
dsh-plugin-notify-sounds Repo Summary
What Does It Do?
Notify Sounds is a DSH plugin for DeepSeek Harness that turns "the agent is waiting for you" and "the task is done" into audible cues. It solves the problem that once you switch to another window you can neither see the status dots nor hear anything, while the agent may be stuck waiting for a single sentence from you. The plugin fires an OS notification in the background (click it to jump back) and marks the taskbar title with "Waiting for you" or "Finished". Once you have seen it, it goes quiet instead of nagging like an alarm clock.
Core Features
- Per-trigger sounds: a chime when the agent raises an approval, a plan review, or a question, and another when a session goes from running to idle, with approvals and questions kept separate.
- Awareness while away: a background OS notification whose body is the approval reason or the question itself, clickable to return to the window, plus a taskbar title mark.
- Repeat only for unseen items: unanswered decisions re-ping every 1/5/15/30 minutes and stop for good once you have seen them, even if you switch away again.
- Only what you care about: sub-agents (background tasks) are completely silent by default, so only your own conversation is announced.
- Quiet when it should be: quiet hours that wrap past midnight, notify-only-when-hidden mode, and a master switch.
- Customizable sound: nine built-in sounds, custom ringtone upload, and volume, each feature with its own toggle.
How to Use This Plugin?
After enabling it in DSH, open Settings → Sounds (between General and Models) to configure it. The master switch and volume, per-trigger sounds with preview, sub-agent alerts, system notifications, window title alert, repeat interval, quiet hours, hidden-only mode, and custom ringtone upload all live there, and every change applies immediately with no restart. The nine built-in sounds are synthesized live with Web Audio, so there are no audio files and no network requests; you can also upload an mp3/wav/ogg ringtone (up to 512KB, validated and volume-normalized automatically) or pick "None" for notifications only. The plugin is maintained by BillCx330 under the MIT license and was last updated on 2026-10-11.
How to Troubleshoot This Plugin?
If an update fails, the plugin verifies the published digest before replacing anything and restores the previous state on failure, so simply retry following the official instructions. If features do not take effect after an update, restart DSH to load the new version.
This page is an independent rewrite of the plugin's official README — for authoritative documentation and the latest changes, refer to the source: billcx330/dsh-plugin-notify-sounds. The plugin is third-party code that runs on your machine once installed; inclusion does not imply endorsement — please review the source before installing.
DSH Plugin FAQ
