Metadata-Version: 2.4
Name: libspotifyctl
Version: 0.3.0
Summary: Offline (no Web API) library for reading from and controlling Spotify on Windows
Author: ColdMeekly
License: MIT
Project-URL: Homepage, https://github.com/ColdMeekly/spotifyctl
Project-URL: Issues, https://github.com/ColdMeekly/spotifyctl/issues
Project-URL: Source, https://github.com/ColdMeekly/spotifyctl
Keywords: spotify,windows,smtc,audio,automation
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python :: 3
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: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Multimedia :: Sound/Audio
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# libspotifyctl — Python bindings

Offline (no Web API) Python bindings for reading from and controlling Spotify on Windows.

Thin `ctypes` wrapper over the `libspotifyctl.dll` C ABI — no `node-gyp`-style
per-Python-version builds. One wheel (`py3-none-win_amd64`) serves all CPython
3.9+ on 64-bit Windows.

## Install

```bash
pip install libspotifyctl
```

## Quick start

```python
import time
from libspotifyctl import SpotifyClient

with SpotifyClient() as c:
    c.on_state_changed(lambda s: print(f"{s.artist} — {s.title}"))
    time.sleep(30)
```

See the project repo for the full API and the underlying C library:
https://github.com/ColdMeekly/spotifyctl
