Metadata-Version: 2.4
Name: pysoniq
Version: 0.1.1
Summary: Lightweight, pure-Python cross-platform audio playback library
Author: laelume
License-Expression: MIT
Project-URL: Homepage, https://github.com/laelume/pysoniq
Project-URL: Repository, https://github.com/laelume/pysoniq
Project-URL: Issues, https://github.com/laelume/pysoniq/issues
Keywords: audio,sound,playback,music,cross-platform,pure-python,audio-playback,audio-player,sound-playback,wav
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: OS Independent
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Sound/Audio
Classifier: Topic :: Multimedia :: Sound/Audio :: Players
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy>=1.19.0
Dynamic: license-file

# pysoniq

Minimal, pure-Python cross-platform audio playback library.

- **Pure Python** - No compiled extensions
- **Cross-platform** - Windows, macOS, Linux
- **Minimal dependencies** - Only numpy
- **Simple API** - Play, pause, stop, loop

## Installation
```bash
pip install pysoniq
```

## Use in context
```python
import pysoniq
import numpy as np

# Play WAV file
pysoniq.play('audio.wav')

# Play as numpy array
sr = 44100
t = np.linspace(0, 1.0, sr)
audio = 0.3 * np.sin(2 * np.pi * 440 * t)
pysoniq.play(audio, samplerate=sr)

# Loop playback
pysoniq.set_loop(True)
pysoniq.play(audio, sr)

# Stop
pysoniq.stop()
```

## Features

**Playback**
```python
pysoniq.play(data, samplerate)  # Play audio
pysoniq.stop()                   # Stop playback
pysoniq.pause()                  # Pause
pysoniq.resume()                 # Resume
```

**Looping**
```python
pysoniq.set_loop(True)   # Enable loop
pysoniq.is_looping()     # Check status
```

**Gain Control**
```python
pysoniq.set_gain(0.5)           # 50% volume
pysoniq.set_volume_db(-6.0)     # Set dB
audio = pysoniq.adjust_gain_level(audio, 1.5)
```

**Audio I/O**
```python
audio, sr = pysoniq.load('file.wav')
pysoniq.save('output.wav', audio, sr)
```

## Platform Requirements

- **Windows**: Built-in (winsound)
- **macOS**: Built-in (afplay)
- **Linux**: ALSA (aplay) - usually pre-installed

## Limitations

- WAV format only (for now)
- Pause/resume uses time-based estimation
- Gain changes apply on next loop iteration

## License

MIT

## Author

laelume
