SpectrumAnalyzer

KO | EN

gitlite — search

#javascript #hacktoberfest #react #ai #typescript #golang #docker #macos #awesome #cli #kubernetes #awesome-list #pytorch #mcp

SpectrumAnalyzer

(★ 37)

Not yet another spectrum analyzer — an experimental DSP & graphics playground. It combines real-time C++ performance with Python flexibility, offering fully customizable FFT visualizations without recompilation. Perfect for audio engineers, DSP researchers, graphics developers, students, and hobbyists.

SpectrumAnalyzer Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

---

## Simplified Video Overview: How it works
**This video provides a great, simplified explanation of how the application works under the hood:**

[![Spectrum Analyzer Simplified Overview](https://img.youtube.com/vi/SboZ2SoYo7I/maxresdefault.jpg)](https://www.youtube.com/watch?v=SboZ2SoYo7I)
---

## A ready-to-download version for Windows is available in the official Microsoft Store:

- **Not Yet Another Spectrum Analyzer**
  [Microsoft Store – Not Yet Another Spectrum Analyzer](https://apps.microsoft.com/detail/9ngnl3tjj7bg?hl=en-US&gl=US)

- **Not Yet Another Music Visualizer**
  [Microsoft Store – Not Yet Another Music Visualizer](https://apps.microsoft.com/detail/9n6f33xks0k9?hl=en-US&gl=US)

- **Not Yet Another Volume Meter**
  [Microsoft Store – Not Yet Another Volume Meter](https://apps.microsoft.com/detail/9nvg7hg4d3hx?hl=en-US&gl=US)

---

## Description

**SpectrumAnalyzer** is a real-time frequency spectrum visualization tool **written primarily in C++** for data processing and rendering, with **optional Python-based audio acquisition**.

By default, the application captures audio via PortAudio, computes its frequency spectrum using FFT, and visualizes it using OpenGL. **It supports multiple input sources, including microphones and system playback audio (e.g., Spotify, YouTube).**

The architecture is flexible — although processing and visualization are done in C++, audioConfig.py lets users replace the default input with any Python-defined source, such as playback streams, virtual devices, or custom sensors.

**The app allows you to customize parameters** — such as bar count, frequency ranges, and colors — using simple text configuration files stored in the config folder.

If something goes wrong, you can delete a file or the entire folder, and the app will recreate default settings. Each configuration file includes a description of its purpose. You can also create your own custom color themes if the default ones are not enough. For additional help, you can copy the file contents into **ChatGPT for guidance**.

SpectrumAnalyzer is useful for learning, signal analysis, experimentation, and entertainment — whether analyzing live microphone input, playback audio, or other types of signals.
This project is licensed under the **GNU General Public License v2 (GPLv2)**.

It also uses the following third-party libraries:

- PortAudio – MIT License  
- glText – zlib License  
- FFTW – GNU General Public License v2 (GPLv2)

---

**Full documentation is available in the Wiki:** 
[https://github.com/sylwekkominek/SpectrumAnalyzer/wiki](https://github.com/sylwekkominek/SpectrumAnalyzer/wiki)

---

## For programmers:

### For typical users: Ubuntu 24.04 or Windows 11 with WSL2.

```bash
sudo apt update && sudo apt install -y g++ cmake python3 python3-dev libglfw3-dev portaudio19-dev libfftw3-dev pkg-config git

git clone https://github.com/sylwekkominek/SpectrumAnalyzer.git
```

**Compilation and running:**
```bash
cd SpectrumAnalyzer && mkdir build && cd build && cmake .. && cmake --build . -j 4

(This step is only required for Raspberry Pi users: export MESA_GL_VERSION_OVERRIDE=4.5)

./spectrum-analyzer
```
do not forget to configure your input audio device
By default, the application runs in fullscreen mode with a resolution of 1920x1080 (Full HD). You can change this resolution by editing the config.py file.

---

### For typical users: Windows

Download and install msys2 from https://www.msys2.org/#installation

Open msys2 terminal and run:

```bash
 pacman -Syu
```

Close msys2 terminal and reopen it

```bash
pacman -S --noconfirm mingw-w64-x86_64-gcc mingw-w64-x86_64-cmake mingw-w64-x86_64-python mingw-w64-x86_64-fftw mingw-w64-x86_64-glfw mingw-w64-x86_64-portaudio git

```
**Compilation and running:**

If you are using a newer Python version, you need to specify a different folder name.

```bash
export PATH=/C/msys64/mingw64/bin:$PATH
export PYTHONHOME=/C/msys64/mingw64
export PYTHONPATH=/C/msys64/mingw64/lib/python3.12:/C/msys64/mingw64/lib/python3.12/lib-dynload

git clone https://github.com/sylwekkominek/SpectrumAnalyzer.git
cd SpectrumAnalyzer && mkdir build && cd build && cmake .. && cmake --build . -j 4
./spectrum-analyzer
```

---
### For advanced users:

**Compilation of unit tests and running:**
```bash
sudo apt update && sudo apt install -y libgtest-dev libgmock-dev
cd SpectrumAnalyzer && mkdir build && cd build && cmake .. -DENABLE_TESTS=ON && make -j4 && cd tests
./spectrum-analyzer-tests
```
**Docker - Running an App with Microphone**

Depending on your system configuration, you may need to adjust the Docker arguments (especially for GUI and audio support).
```bash
cd SpectrumAnalyzer

docker build -t spectrum-analyzer -f docker/spectrum-analyzer/Dockerfile .

xhost +local:docker

docker run  -e DISPLAY=$DISPLAY -v /tmp/.X11-unix:/tmp/.X11-unix   --device /dev/dri  --device /dev/snd   spectrum-analyzer
```
**Docker - Running an App with Audio Loopback**

Depending on your system configuration, you may need to adjust the Docker arguments (especially for GUI and audio support).
```bash
cd SpectrumAnalyzer

docker build -t spectrum-analyzer-loopback -f docker/spectrum-analyzer-loopback/Dockerfile .

xhost +local:docker

docker run -it --device /dev/dri --device /dev/snd -v /tmp/.X11-unix:/tmp/.X11-unix -v $XDG_RUNTIME_DIR/pulse:/run/user/1000/pulse -e DISPLAY=$DISPLAY -e PULSE_SERVER=unix:/run/user/1000/pulse/native spectrum-analyzer-loopback
```

**Docker - running tests**
```bash
cd SpectrumAnalyzer

docker build -t spectrum-analyzer-tests -f docker/spectrum-analyzer-tests/Dockerfile .

docker run spectrum-analyzer-tests
```

SpectrumAnalyzer

SpectrumAnalyzer Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

SpectrumAnalyzer

SpectrumAnalyzer Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README