spectropython 0.3.0

Interactive multi-resolution spectrogram viewer for audio files

Spectropython

Interactive multi-resolution spectrogram viewer for audio files.

Installation

pip install spectropython

Usage

spectropython file.wav
spectropython file.mp3

Supported formats: WAV, MP3, FLAC, OGG, AIFF, AU, and any format readable by librosa.

Controls

Action	Input
Frequency zoom	Scroll wheel
Time zoom	Ctrl + Scroll
Pan	Ctrl + Drag
Time/frequency selection	Shift + Drag
Play / Pause	Space or button
Move playhead	Left click

Linux integration (open from file manager)

To associate spectropython with audio files on Linux (double-click, set as default application), run the provided install script.

Prerequisites: install spectropython via pipx first:

pipx install --python python3.11 spectropython-0.1.0.tar.gz

Then run:

bash install.sh

The script will:

• install the icon to ~/.local/share/icons/
• install the .desktop file to ~/.local/share/applications/
• register spectropython as the default application for: WAV, MP3, FLAC, OGG, AIFF

Changes take effect immediately in most desktop environments (GNOME, KDE, XFCE…).

Dependencies

• numpy
• librosa
• soundfile
• sounddevice
• PySide6
• pyqtgraph

License

Copyright (c) 2026 Mehdi.A — AGPL-3.0-or-later