Metadata-Version: 2.4
Name: spectropython
Version: 0.3.0
Summary: Interactive multi-resolution spectrogram viewer for audio files
Project-URL: Homepage, https://pypi.org/project/spectropython/
Author: Mehdi.A
License-Expression: AGPL-3.0-or-later
Keywords: audio,pyside6,spectrogram,stft,visualization
Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Multimedia :: Sound/Audio :: Analysis
Requires-Python: >=3.9
Requires-Dist: librosa
Requires-Dist: numpy
Requires-Dist: pyqtgraph
Requires-Dist: pyside6
Requires-Dist: sounddevice
Requires-Dist: soundfile
Description-Content-Type: text/markdown

# Spectropython

Interactive multi-resolution spectrogram viewer for audio files.

## Installation

```bash
pip install spectropython
```

## Usage

```bash
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:

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

**Then run:**

```bash
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
