Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/thewisker/cavasik

Audio visualizer based on CAVA
https://github.com/thewisker/cavasik

audio audio-visualizer cava eye-candy flatpak gnome python

Last synced: 7 days ago
JSON representation

Audio visualizer based on CAVA

Awesome Lists containing this project

README 

        
Cavasik




    

        

    



Audio visualizer based on CAVA



Index





    

  [Description][description]

  

  [Features][features]

  

  [Screenshots][screenshots]

  

  [Installation][installation]

  

  [Dependencies][dependencies]

  

  [Contributions][contributions]



  [Translations][translations]



  [Metrics][metrics]



  [License][license]

  

  [Code of Conduct][coc]

  

  [Credits][credits]






Description [↑]



This is an audio visualizer based on CAVA with extended capabilities.



Features [↑]



The visualizer features:



- Five **normal** drawing modes!

- Two **circle** drawing modes!

- Three **mirror** drawing modes!

- Four drawing **directions**!

- Customizable **LibAdwaita** interface!

- Set a single color or up to a 10 color linear gradient for **background** and **foreground**!

- Select different **foreground** colors for the mirrored images in **mirror** mode!

- Set up a **color animation** that changes the colors gradually in a loop!

- Configure *smoothing*, *noise reduction* and a few other **CAVA** settings!

- Change **background** and **foreground** colors through a **DBus interface**!



Screenshots [↑]





    




Waves mode





    




Levels mode





    




Particles mode





    




Spine mode





    




Bars mode





    




Waves mode + Circle shape





    




Bars mode + Circle shape





    




Normal mirror + Waves mode





    




Inverted mirror + Waves mode





    




Overlapping mirror + Waves mode





    




Direction top-bottom + Waves mode





    




Normal mirror + Direction left-right + Waves mode





    




Installation [↑]



Flathub



You can install the **Cavasik** app from [Flathub][flathub] in its [app page][flathub-cavasik].










- For information on how to setup *flatpak* on any distro read [this][flatpak-setup].



Arch Linux



You can install **Cavasik** from the [AUR][aur] repository:










- For information on how to install an [AUR][aur] package read [this][aur-wiki] wiki.



Manually



To manually install **Cavasik** start by **downloading** a [release][releases].

Then, **uncompress** the downloaded release into a resulting folder.

Make sure you have all the [dependencies][dependencies] needed.

Then, proceed to **run** the following commands:



```

#BUILD

arch-meson Cavasik build

meson compile -C build



#TEST

meson test -C build --print-errorlog



#INSTALL

meson install -C build

install -Dm644 Cavasik/LICENSE -t "/usr/share/licenses/cavasik"

```



Dependencies [↑]



Buildtime



The **Cavasik** application has the following *buildtime* dependencies:



- [meson][meson]



Runtime



The **Cavasik** application has the following *runtime* dependencies:



- [cava][cava]

- [libadwaita][libadwaita]

- [python-gobject][python-gobject]

- [python-cairo][python-cairo]

- [python-pydbus][python-pydbus]



Contributions [↑]



First and foremost, all contributions are welcome!

The **steps** involved when making a contribution are **explained** in the [CONTRIBUTING.md][contributing] file.

We look forward to your contributions!



- The **contributors** list is located [here][contributors].



Translations [↑]



Secondly, all translations are also welcome!

The **steps** involved when making a translation are **explained** in the [CONTRIBUTING.md][contributing] file.

More **specific steps** can be found in the [CONTRIBUTING.md][lang-contributing] file in the `/lang` folder.

We look forward to your translations!



- The **credits** of the translators are located [here][translator-credits].



Metrics [↑]





  

    

  






  

    

  




License [↑]





  

    

  




Code of Conduct [↑]

























 This project follows the Contributor Covenant Code of Conduct.



Credits [↑]





    

| Author | Forked From |

| ------------- | ------------- |

|   |   |

| TheWisker | Fsobolev |






[description]: https://github.com/TheWisker/Cavasik#description-

[features]: https://github.com/TheWisker/Cavasik#features-

[screenshots]: https://github.com/TheWisker/Cavasik#screenshots-

[installation]: https://github.com/TheWisker/Cavasik#installation-

[dependencies]: https://github.com/TheWisker/Cavasik#dependencies-

[contributions]: https://github.com/TheWisker/Cavasik#contributions-

[translations]: https://github.com/TheWisker/Cavasik#translations-

[metrics]: https://github.com/TheWisker/Cavasik#metrics-

[license]: https://github.com/TheWisker/Cavasik#license-

[coc]: https://github.com/TheWisker/Cavasik#code-of-conduct-

[credits]: https://github.com/TheWisker/Cavasik#credits-

[flathub]: https://flathub.org/

[flathub-cavasik]: https://flathub.org/apps/io.github.TheWisker.Cavasik

[flatpak-setup]: https://flatpak.org/setup/

[aur]: https://aur.archlinux.org/

[aur-wiki]: https://wiki.archlinux.org/title/Arch_User_Repository

[releases]: https://github.com/TheWisker/Cavasik/releases/

[meson]: https://mesonbuild.com/

[cava]: https://github.com/karlstav/cava

[libadwaita]: https://gitlab.gnome.org/GNOME/libadwaita

[python-gobject]: https://pygobject.readthedocs.io/en/latest/

[python-cairo]: https://pycairo.readthedocs.io/en/latest/

[python-pydbus]: https://pydbus.readthedocs.io/en/latest/gettingstarted.html

[contributing]: ./CONTRIBUTING.md

[contributors]: ./CONTRIBUTORS.md

[lang-contributing]: ./lang/CONTRIBUTING.md

[translator-credits]: ./lang/CREDITS.json