Metadata-Version: 2.4
Name: sonos-fade
Version: 0.1.0
Summary: Gradually fade the volume of a Sonos group on your LAN.
Project-URL: Homepage, https://github.com/matteosandrin/sonos-fade
Project-URL: Repository, https://github.com/matteosandrin/sonos-fade
Project-URL: Issues, https://github.com/matteosandrin/sonos-fade/issues
Author-email: Matteo Sandrin <sandrin98@gmail.com>
License: MIT
License-File: LICENSE
Keywords: audio,cli,fade,sonos,volume
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Sound/Audio
Requires-Python: >=3.10
Requires-Dist: requests
Requires-Dist: rich>=13
Requires-Dist: soco>=0.30
Description-Content-Type: text/markdown

# sonos-fade

Gradually fade the volume of a Sonos group on your LAN.

Discovers Sonos speakers via SSDP, lets you pick a group, and ramps the volume
to a target level one step at a time — handy for nudging music down at the end
of an evening without a jarring cut.

## Install

```bash
pip install sonos-fade
```

## Usage

Interactive (prompts for group and target volume):

```bash
sonos-fade
```

List discovered groups:

```bash
sonos-fade list
```

Non-interactive fade:

```bash
sonos-fade fade --group "Living Room" --target 5 --seconds-per-step 2
```

### Options

- `--group` — group label or coordinator name. Prompts if omitted or no match.
- `--target` — target volume (0–100). Prompts if omitted.
- `--seconds-per-step` — seconds between each 1-unit volume change.

## Requirements

- Python 3.10+
- Sonos speakers reachable on the local network

## License

MIT — see [LICENSE](LICENSE).
