A small command-line tool for viewing audio recordings as a waveform and spectrogram.

It is designed for simple inspection of recordings, showing how signal energy varies over time and frequency. The output combines a waveform view with a time–frequency spectrogram, making it easy to see structure, timing, and frequency content at a glance.

The tool was originally developed for exploring bat recordings (time expansion and heterodyne), but it can be used with any WAV audio file.

To run the application, first create and activate a virtual environment by running the following at the root of the project:

python -m venv venv
source ./venv/bin/activate

Then, install the project dependencies:

pip install --upgrade pip
pip install -e .

This assumes a Mac or Linux-based setup and should be modified if running on Windows.

Open a terminal window and run the following:

python -m spectrogram --file /path/to/audio/file.wav --title "Chart Title"

A window should be displayed showing the charts:

• Dave Walker - Initial work

To file issues or suggestions, please use the Issues page for this project on GitHub.

This project is licensed under the MIT License - see the LICENSE file for details