:headphones: spectrum

A simple and intuitive console-based music player written in C++

https://github.com/v1nns/spectrum/assets/22479290/5ab537cf-34d6-4627-8d66-4f7128cd6915

Introducing yet another music player for tech enthusiasts that will simplify the way you experience your favorite tunes! Immerse yourself in the sound with the powerful equalizer, allowing you to fine-tune every aspect of the music to your exact specifications, perfectly matching your mood.

With an intuitive user interface and lightning-fast performance, this music player is the perfect addition to any audiophile's collection. Whether you're a casual listener or a serious music lover, this console-based music player will exceed your expectations.

Features :speech_balloon:

Simple and intuitive terminal user interface;
Plays music in any format;
Basic playback controls such as play, pause, stop, and skip;
Displays information about the currently playing track;
Audio spectrum visualizer;
Audio equalizer;
Fetch song lyrics.

Installation :floppy_disk:

To build spectrum, you need to have a C++ compiler installed on your system.

# Package dependencies (on Ubuntu)
sudo apt install build-essential libasound2-dev libavcodec-dev \
     libavfilter-dev libavformat-dev libfftw3-dev libswresample-dev \
     libcurl4-openssl-dev libxml++2.6-dev

# Clone repository
git clone https://github.com/v1nns/spectrum.git
cd spectrum

# Generate build system in the build directory
cmake -S . -B build

# Build executable
cmake --build build

# Install to /usr/local/bin/ (optional)
sudo cmake --install build

# OR just execute it
./build/src/spectrum

Credits :placard:

This software uses the following open source packages:

FFmpeg
FFTW
curl
libxml++
FTXUI
cava ^{(visualizer is based on Cava algorithm)}

Contributing

Contributions are always welcome! If you find any bugs or have suggestions for new features, please open an issue or submit a pull request.

License

This project is licensed under the MIT License. See the LICENSE file for details.

v1nns / spectrum

readme