Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: Improve README usage instructions #7

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

lime-desu
Copy link

No description provided.

2. Copy the contents of _flavour_.cava into your Cava config file, as specified in [Cava's README](https://github.com/karlstav/cava#configuration). Typically, the config file is located at: `~/.config/cava/`. Ensure you replace the existing gradient settings.

> [!WARNING]
> Running any of the commands below may overwrite your existing cava configuration file.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Might be worth noting that this won't override the primary cava config, but will instead put the port colours alongside it.

@@ -18,9 +18,43 @@
## Usage

1. Choose your flavour.
2. Copy the contents of _flavour_.cava into your Cava config file (usually located at: `$HOME/.config/cava/`), replacing the existing gradient settings.
2. Copy the contents of _flavour_.cava into your Cava config file, as specified in [Cava's README](https://github.com/karlstav/cava#configuration). Typically, the config file is located at: `~/.config/cava/`. Ensure you replace the existing gradient settings.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

According to the Cava docs, the file is located at ~/.config/cava/config, rather than ~/.config/cava. We should be specific.


> [!WARNING]
> Running any of the commands below may overwrite your existing cava configuration file.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Would it be better to provide a cURL example instead? Is it more commonly installed OOTB than wget?

```sh
wget -O ~/.config/cava/config https://github.com/catppuccin/cava/raw/main/mocha.cava
```

3. Reload cava if it was already playing.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

According to the Cava docs, you can reload Cava without restarting by sending it SIGUSR1 :

$ pkill -USR1 cava

Is it worth noting this?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants