spectral-visualizer - GitLite

KO | EN

gitlite — search

#hacktoberfest #typescript #llm #go #linux #nodejs #java #windows #cli #kubernetes #vue #pytorch #security #open-source

spectral-visualizer

(★ 106)

A spectral visualizer that analyzes the frequencies of music and sound, written in Godot 3.1.

File Explorer

Download Latest Version (.zip)

- demo.gif
- cube.dae
- cube.dae.import
- Cube.mesh
- mat_cube.material
- AssemblyInfo.cs
- Meteorite.wav
- Meteorite.wav.import
.gitignore
default_bus_layout.tres
default_env.tres
icon.png
icon.png.import
Meshes.cs
packages.config
Player.cs
Player.tscn
project.godot
README.md
Spectral Visualizer.csproj
Spectral Visualizer.sln

# Installation Guide

1. Get the code

git clone https://github.com/Bauxitedev/spectral-visualizer

Downloads the entire project code from GitHub to your computer.

cd spectral-visualizer

Moves into the project folder you just downloaded.

2. .NET

Medium Recommended

Prerequisites

Git Needed to download the project code from GitHub.
.NET SDK The SDK required for the dotnet command.

dotnet restore

Downloads the packages the project depends on.

dotnet run

Builds the project and runs it immediately.

✅ After dotnet run, check the message or address shown in the terminal.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Spectral Visualizer

This is a spectral visualizer that analyzes the frequencies of music and sound, written in Godot 3.1. The bar's length and intensity depend on the amplitude of its corresponding frequency.

![demo](https://raw.githubusercontent.com/Bauxitedev/spectral-visualizer/master/demo/demo.gif)

[Here's a video of it in action.](https://www.youtube.com/watch?v=7Ksw95gDI1c)

## Running

**Important: this requires [Godot 3.1 Alpha Mono edition](https://godotengine.org/article/dev-snapshot-godot-3-1-alpha-1). Older versions, such as Godot 3.0.x, will not work.**

Additionally, you need to install some packages using nuget. You can do this by [installing nuget if not yet installed](https://docs.microsoft.com/en-us/nuget/install-nuget-client-tools) and then running the following command in a terminal in the root of the project folder:

```
nuget restore
```

Then you can just open the project and run it as usual.

## How it works

The program uses the new Godot 3.1 API which enables you to get the raw byte array from an AudioStream, containing the entire audio file. The byte array is converted to an array of pairs of floats (since the sound is stereo) and then analyzed using MathNet's fourier transform functions. This is the main reason the program uses C# and not GDScript, since currently Godot does not expose any FFT functions to GDScript. Additionally, GDScript would probably be too slow.

Since Godot does not expose the position of the playback head of the stream, the program estimates the playback position by measuring the amount of time spent since the stream started and multiplying that by the sample rate. This works reasonably well, unless the playback is started/stopped regularly, which will cause the visualization to drift off in time compared to what you're seeing on the screen.

In the future I'd like this to work with an actual callback so you can get the stream of bytes in real-time, unfortunately this is not implemented in Godot yet. That would also enable visualization of audio captured in real time from e.g. a microphone.

## Music

The song is a cut-up version of Meterorite, a song that appears on my album [Meteorite Soundtrack](https://kenophos.bandcamp.com/album/meteorite-soundtrack).

## License

The code is licensed MIT. The song is released under the CC BY-SA 4.0 license.