Skip to content

Stop audio from playing when the audio output changes

License

Notifications You must be signed in to change notification settings

tomkoid/supershush

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

25 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Logo

SuperShush

Stop audio from playing when the audio output changes
Report Bug · Request Feature

What is SuperShush?

SuperShush is a daemon that is designed to prevent audio from continuing to play when the output device is changed, such as when switching from headphones to speakers.

Installation

To stop audio playback when the output device is changed, SuperShush requires the playerctl package if the option in the config is enabled.

From Source

To compile SuperShush from source, you'll need to have Go installed on your system. You can download the Go installer from the official Go website.

Once you have Go installed, run the following command to install SuperShush:

go install codeberg.org/tomkoid/[email protected]

Running

To run supershush, simply execute the supershush command:

supershush

This will start the SuperShush daemon, which will monitor audio output changes and stop audio playback when necessary.

Configuring

To configure SuperShush, you can edit the configuration file located at ~/.config/supershush/config.toml. Here is an example configuration file:

# Resume audio after you change output back
# WARNING: This feature is not stable yet. The current implementation has big issues.
# Example: audio is playing on audio 1 and then you switch to
#          audio 2, the audio gets paused. after you switch
#          back to audio 1, the audio gets unmuted.
resume = false

# Enable MPC pausing 
mpc = false

# Enable playerctl stopping 
playerctl = true

License

SuperShush is licensed under the MIT License. See the LICENSE file for more information.

Contributing

If you'd like to contribute to SuperShush, please fork the repository and submit a pull request with your changes. You can also report issues or suggest new features on the issue tracker.