Home

Awesome

Crescendo

Logo
Crescendo is a music player controller that can retrieve information about a player via dbus in real-time, control it, and change the output sound device for this player using PulseAudio or PipeWire.

Features

Dependencies:

Installation

To install Crescendo, follow these steps:

  1. Clone the project from the GitHub repository:
$ git clone https://github.com/PolisanTheEasyNick/Crescendo.git
  1. Install the dependencies required for the project You need to do it specifially for your package manager.
    For example, for Arch Linux:
$ sudo pacman -Sy pugixml gtkmm-4.0 dbus pulseaudio sdl2 sdl2_mixer taglib  sdbus-cpp

Don't forget that PulseAudio or PipeWire, SDL2, SDL2_mixer, taglib and sdbus-cpp packages are optional.
3. Build the project:

$ cd Crescendo
$ mkdir build && cd build
$ cmake ..
$ make
  1. Run the application:
$ ./сrescendo

Usage

When you run Crescendo, you will see a graphical user interface that looks like default player. You can select a player by clicking the Player button. The information from choosed player will be displayed in real-time in the Crescendo window. You can control the player by using the controls provided in the Crescendo window. You can also change the output sound device for the player by clicking the button with headphones icon and selecting the desired output device from the dropdown menu. image image

Contributing

To contribute to Crescendo, follow these steps:

  1. Fork the repository from GitHub.
  2. Clone the forked repository to your local machine.
  3. Create a new branch for your changes.
  4. Make your changes and commit them.
  5. Push your changes to your forked repository.
  6. Submit a pull request to the original repository.

If you encounter any issues or have ideas for new features, please open an issue on GitHub.