-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Signed-off-by: Tomkoid <[email protected]>
- Loading branch information
Showing
1 changed file
with
32 additions
and
23 deletions.
There are no files selected for viewing
This file contains 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
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,38 +1,47 @@ | ||
AudStopper | ||
What is AudStopper? | ||
AudStopper is a daemon that stops audio from playing when the audio output changes. It's designed to prevent audio from continuing to play when the output device is changed, such as when switching from headphones to speakers. | ||
# AudStopper | ||
|
||
Installation Guide | ||
Compiling from Source | ||
To compile AudStopper from source, you'll need to have Go installed on your system. You can download the Go installer from the official Go website. | ||
## What is AudStopper? | ||
|
||
AudStopper 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. | ||
|
||
Once you have Go installed, clone the AudStopper repository: | ||
# Installation | ||
|
||
## From Source | ||
|
||
git clone https://codeberg.org/tomkoid/audstopper.git | ||
Change into the cloned repository and run the following command to build AudStopper: | ||
To compile AudStopper from source, you'll need to have Go installed on your system. You can download the Go installer from the official Go website. | ||
|
||
go build main.go | ||
This will create an executable file called audstopper in the current directory. | ||
Once you have Go installed, run the following command to install audstopper: | ||
|
||
Installing the Binary | ||
If you don't want to compile AudStopper from source, you can download the pre-compiled binary from the releases page. | ||
```bash | ||
go install codeberg.org/tomkoid/audstopper@latest | ||
``` | ||
|
||
Once you've downloaded the binary, you can install it to a directory of your choice. For example, to install it to /usr/local/bin, run the following command: | ||
# Running | ||
|
||
sudo install audstopper /usr/local/bin | ||
Running AudStopper | ||
To run AudStopper, simply execute the audstopper command: | ||
|
||
```bash | ||
audstopper | ||
``` | ||
|
||
This will start the AudStopper daemon, which will monitor audio output changes and stop audio playback when necessary. | ||
|
||
License | ||
AudStopper is licensed under the MIT License. See the LICENSE file for more information. | ||
# Configuring | ||
|
||
Acknowledgments | ||
AudStopper was inspired by the Audacious audio player and its plugins. The project's code is influenced by the RPM spec file for Audacious, which can be found in the Fedora repository. | ||
To configure AudStopper, you can edit the configuration file located at `~/.config/audstopper/config.toml`. Here is an example configuration file: | ||
|
||
Contributing | ||
If you'd like to contribute to AudStopper, 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. | ||
```toml | ||
# Enable MPC pausing | ||
mpc = true | ||
|
||
go install codeberg.org/tomkoid/audstopper@latest | ||
# Enable playerctl stopping | ||
playerctl = true | ||
``` | ||
|
||
# License | ||
|
||
AudStopper is licensed under the MIT License. See the LICENSE file for more information. | ||
|
||
# Contributing | ||
|
||
If you'd like to contribute to AudStopper, 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. |