reactbeat

reactbeat is a local terminal music visualizer. It decodes an audio file, plays it back, analyzes short-time energy in sync with playback, and renders particle or fluid motion as packed braille graphics in a Textual TUI.The visual core is simulation-driven generative art, not FFT bars. Audio, analysis, simulation, and rendering all run locally.

Features

• TUI start screen with Browse and Recent Files choices.
• Folder browser filtered to supported audio files.
• Persistent recent-file list for reopening previously selected tracks.
• Custom braille renderer using Unicode braille cells and Rich styles.
• Numpy-vectorized particle simulation.
• Stable Fluids-style density/velocity simulation.
• Local WAV, FLAC, and OGG decode through soundfile.
• Callback-driven playback through sounddevice.
• Manual FFT energy analyzer with adaptive onset detection.
• Runtime visual styles: ember, aurora, voltage.
• One-file Linux PyInstaller build with bundled PortAudio and ALSA config.

Supported Audio

• WAV
• FLAC
• OGG/Vorbis