Metadata-Version: 2.4
Name: audio-workbench
Version: 0.0.9
Summary: Python wrapper for Audio Workbench Player (HTML/Streamlit embedding)
Author: Perch Contributors
License-Expression: AGPL-3.0-only
Project-URL: Homepage, https://github.com/LimitlessGreen/Audio-Workbench
Project-URL: Repository, https://github.com/LimitlessGreen/Audio-Workbench
Project-URL: Issues, https://github.com/LimitlessGreen/Audio-Workbench/issues
Keywords: audio,player,streamlit,jupyter,embed,waveform,spectrogram
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.9
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: streamlit
Requires-Dist: streamlit>=1.30; extra == "streamlit"
Provides-Extra: gradio
Requires-Dist: gradio>=4.0; extra == "gradio"
Dynamic: license-file

# audio-workbench (Python wrapper)

Python helper package to embed `audio-workbench` in Streamlit, Jupyter, and other HTML-capable UIs.

## Install (PyPI)

```bash
pip install audio-workbench
```

Optional demo dependencies:

```bash
pip install "audio-workbench[streamlit]"
pip install "audio-workbench[gradio]"
```

## Install (local dev)

```bash
pip install -e .
```

## Usage

```python
from audio_workbench import render_daw_player
html = render_daw_player(
    audio_bytes,
    iframe_height=320,
    viewMode="spectrogram",
    transportStyle="hero",
    transportOverlay=True,
    showOverview=False,
    showFileOpen=False,
    showStatusbar=False,
)
```

## Demo Features

- Presets: `Full DAW`, `Compact`, `Preview Waveform Hero`, `Preview Spectrogram Hero`, `Ultra Compact Hero`
- Advanced toggles for all relevant player sections
- Live options preview as JSON

## Streamlit demo

```bash
streamlit run demo_streamlit.py
```

## Gradio demo

```bash
pip install gradio
python demo_gradio.py
```

## License

GNU AGPL-3.0
