feat: add optional pipeline ended sound#267
Open
dmarkey wants to merge 14 commits into
Open
Conversation
Play a short audio cue when the voice pipeline ends without a TTS response (e.g. no speech detected after wake word, or session timeout). Disabled by default — set PIPELINE_ENDED_SOUND or --pipeline-ended-sound to enable. A default sound file (sounds/pipeline_ended.wav) is included: a short descending two-tone that signals the session has ended.
Author
|
any interest in this one? |
Collaborator
|
The wav file, where is that from? Asking regarding possible license problems! |
florian-asche
requested changes
Mar 30, 2026
| # PROCESSING_SOUND="sounds/processing.wav" | ||
| # MUTE_SOUND="sounds/mute_switch_on.flac" | ||
| # UNMUTE_SOUND="sounds/mute_switch_off.flac" | ||
| # PIPELINE_ENDED_SOUND="sounds/pipeline_ended.wav" |
Collaborator
There was a problem hiding this comment.
Can you please also document this in the docs from the docs directory?
Author
|
Sorry will pick this up again.. the .wav was generated locally using tools under the direction of Claude code. |
Removed mention of 'Disabled by default' from help text.
Collaborator
|
Documentation in docs is still needed to be able to merge this PR. |
Adds the new --pipeline-ended-sound CLI flag and PIPELINE_ENDED_SOUND environment variable to the README parameter table and the install_application docs (systemd service example + env reference). Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]>
170f543 to
8c90d09
Compare
Author
|
Added documentation for |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
PIPELINE_ENDED_SOUND="sounds/pipeline_ended.wav"in.envor--pipeline-ended-soundCLI argsounds/pipeline_ended.wav)Motivation
When using the voice assistant, there's no audio feedback when the pipeline ends without producing a response. The user says the wake word, the assistant starts listening, but if no speech is detected the session silently ends. This can be confusing — the user doesn't know if the assistant is still listening or has given up.
Changes
linux_voice_assistant/__main__.py— new--pipeline-ended-soundargument (default empty = disabled)linux_voice_assistant/models.py—pipeline_ended_soundfield onServerStatelinux_voice_assistant/satellite.py— play sound in_tts_finished()when pipeline ends without TTS.env.example— document the newPIPELINE_ENDED_SOUNDoptionsounds/pipeline_ended.wav— 0.28s 16kHz mono descending two-toneTest plan
PIPELINE_ENDED_SOUND="sounds/pipeline_ended.wav"and verify sound plays on timeout