🎧 CLI Audio Visualizer

Terminal-based audio visualizer built with Node.js. Real-time spectrum analysis, waveform rendering, and a volume/peak meter — all inside your terminal.

📸 Preview

Bars

Wave

Circle

✨ Features

• 📊 Spectrum bars visualization
• 🌊 Waveform view
• 🔵 Circular visualization
• 🔊 Real-time volume (RMS)
• 📍 Peak meter with smooth decay
• ⚡ Fast and lightweight
• ⌨️ Keyboard controls

📦 Requirements

• Node.js (>= 16)

Audio input:

• macOS → ffmpeg
• Linux → sox (rec command)

🔧 Installation

git clone 
cd node-cli
npm install

▶️ Usage

node index.js

🎮 Controls

| Key | Action | | ------- | ------------------------------- | | m | Switch visualization mode | | + / - | Increase / decrease sensitivity | | space | Pause / resume | | q | Quit |

🔊 Volume Meter

On the right side you will see:

• Vol — current loudness (RMS)
• Peak — maximum detected level (with smooth decay)

Example:

Vol : [██████████░░░░░░░░]
Peak:        |

🧠 How it works

• Captures raw audio from system/microphone
• Converts PCM → float samples
• Uses FFT for frequency analysis
• Calculates RMS for loudness
• Applies smoothing for stable visualization
• Renders UI using terminal graphics

⚙️ Configuration

You can tweak these values in the code:

const SAMPLE_RATE = 16000;
const FFT_SIZE = 1024;

📌 Notes

• Works best in a large terminal window
• Requires access to an audio input device
• Peak meter uses exponential decay for smoother visuals

🚀 Future Improvements

• 🎨 Gradient colors (green → yellow → red)
• 🔴 Clip indicator
• 📈 Auto gain normalization
• 🎚️ Stereo support

📄 License

MIT