Metadata-Version: 2.4
Name: libspotifyctl
Version: 0.3.4
Summary: Offline (no Web API) library for reading from and controlling Spotify on Windows
Author: ColdMeekly
License: MIT
Project-URL: Homepage, https://spotifyctl.cldmk.ly
Project-URL: Source, https://github.com/ColdMeekly/spotifyctl
Project-URL: Issues, https://github.com/ColdMeekly/spotifyctl/issues
Project-URL: Changelog, https://github.com/ColdMeekly/spotifyctl/blob/main/CHANGELOG.md
Keywords: spotify,spotifyctl,windows,smtc,audio,now-playing,media-controls,automation,cli
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Win32 (MS Windows)
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: Microsoft :: Windows :: Windows 10
Classifier: Operating System :: Microsoft :: Windows :: Windows 11
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
Classifier: Topic :: Multimedia :: Sound/Audio :: Players
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
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
