waybar-cava - cava module

NAME  DESCRIPTION  FILES  ADDITIONAL FILES  CONFIGURATION  ACTIONS  DEPENDENCIES  SOLVING ISSUES  RISING ISSUES  EXAMPLES 

---

NAME

waybar - cava module

DESCRIPTION

cava module for karlstav/cava project. See it on github: https://github.com/karlstav/cava.

FILES

$XDG_CONFIG_HOME/waybar/config

Per user configuration file

ADDITIONAL FILES

libcava lives in:

1. /usr/lib/libcava.so or /usr/lib64/libcava.so
2. /usr/lib/pkgconfig/cava.pc or /usr/lib64/pkgconfig/cava.pc
3. /usr/include/cava

CONFIGURATION

Configuration can be provided as:

• The only cava configuration file which is provided through cava_config. The rest configuration can be skipped
• Without cava configuration file. In such case cava should be configured through provided list of the configuration option
• Mix. When provided both And cava configuration file And configuration options. In such case, waybar applies configuration file first and then overrides particular options by the provided list of configuration options

ACTIONS

DEPENDENCIES

• iniparser
• fftw3

SOLVING ISSUES

1. On start Waybar throws an exception "error while loading shared libraries: libcava.so: cannot open shared object file: No such file or directory". It might happen when libcava for some reason hasn’t been registered in the system. sudo ldconfig should help
2. Waybar is starting but cava module doesn’t react to the music

1. In such cases at first need to make sure usual cava application is working as well

2. If so, need to comment all configuration options. Uncomment cava_config and provide the path to the working cava config 3. You might set too huge or too small input_delay. Try to setup to 4 seconds, restart waybar, and check again 4 seconds past. Usual even on weak machines it should be enough 4. You might accidentally switch action mode to pause mode

RISING ISSUES

For clear understanding: this module is a cava API’s consumer. So for any bugs related to cava engine you should contact Cava upstream(https://github.com/karlstav/cava)
with the one Exception. Cava upstream doesn’t provide cava as a shared library. For that, this module author made a fork libcava(https://github.com/LukashonakV/cava).
So the order is:

1. cava upstream
2. libcava upstream.

In case when cava releases new version and you’re wanna get it, it should be raised an issue to libcava(https://github.com/LukashonakV/cava) with title
[Bump]x.x.x where x.x.x is cava release version.

EXAMPLES

"cava": {

			//"cava_config": "$XDG_CONFIG_HOME/cava/cava.conf",
			"framerate": 30,
			"autosens": 1,
			//"sensitivity": 100,
			"bars": 14,
			"lower_cutoff_freq": 50,
			"higher_cutoff_freq": 10000,
			"method": "pulse",
			"source": "auto",
			"stereo": true,
			"reverse": false,
			"bar_delimiter": 0,
			"monstercat": false,
			"waves": false,
			"noise_reduction": 0.77,
			"input_delay": 2,
			"format-icons" : ["â", "â", "â", "â", "â", "â", "â", "â" ],
			"actions": {
			"on-click-right": "mode"
			}

},

---