Soundscope — a CLI audio file analyzer tool.

Soundscope is a crossplatform CLI tool for analyzing audio files.

✨ Features

• 📊 FFT Spectrum — view the frequency distribution.
• 📉 Waveform Display — see the amplitude over time.
• 🔊 LUFS Metering and True Peak — measure loudness precisely.

🚀 Installation

Using Cargo

cargo install soundscope

or

cargo install --git https://github.com/bananaofhappiness/soundscope

Precompiled Binaries

Grab the latest release for your platform from the Releases page.

🔧 Usage

• Run the tool using soundscope command
• Open the explorer by pressing E.
• Navigate to your audio file using arrow keys or H, J, K, L (Vim-style navigation).
• Press Enter to select it.
• Play or pause audio by pressing Space.
• Turn Mid and Side Frequencies on/of by pressing M and S respectively.
• Press L to check LUFS and F to check frequencies.
• Use the right and left arrow keys to move playhead 5 seconds forward or backward.
• When you are done, press Q to quit.

🎥 Demo Video

Watch the demo on YouTube.

🐛 Known Issues

• The programm may crash while opening files with length < 15 sec.
• After the playhead reaches the end of the file, the file needs to be reopened in order to be played again. This isn't a bug, but fixing it would be a useful quality‑of‑life (QoL) improvement.
• It works fine with stereo tracks but was not tested with tracks that have different number of channels.

🛣 Roadmap

• Zooming the Waveform in and out.
• Custom themes support.

🤝 Contributing

Pull Requests, Issues and Suggestions are welcome!

📜 License

This project is licensed under the MIT License — see LICENSE for details.

☕ Support

If you like soundscope and want to support its development:

• Boosty

Your support helps keep this project alive ❤️