Skip to content

Commit

Permalink
docs(readme): init
Browse files Browse the repository at this point in the history
Signed-off-by: Tomkoid <[email protected]>
  • Loading branch information
tomkoid committed May 6, 2024
1 parent 062d03e commit 5a28239
Showing 1 changed file with 32 additions and 23 deletions.
55 changes: 32 additions & 23 deletions README.md
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.

0 comments on commit 5a28239

Please sign in to comment.