Repository navigation
v0.1.0 - Release
🎉 Initial Release v0.1.0
We are excited to announce the first official release of spicetify-websocket! 🚀
An asynchronous Python wrapper and WebSocket server for controlling the Spotify desktop client via Spicetify and the spicetify-connect-api extension.
✨ Highlights
- ⚡ Real-Time Push Events: Receive instant updates for song changes, volume adjustments, play/pause state, repeat mode, shuffle, and timeline seeking.
- 🎮 Full Playback Control: Play, pause, skip, force previous track, seek, set volume (0–100%), toggle mute, shuffle, and repeat modes.
- 🛠️ Convenience Decorators: Expressive event listening with syntax like
@server.on_song_changed. - 🏷️ Fully Typed Models: Built on Pydantic V2 (
TrackInfo,PlayerState,RepeatMode). - 🔄 Non-Blocking Async: Powered by
asyncioandwebsocketsfor maximum performance and zero polling overhead.
📦 Installation
pip install spicetify-websocketNote: Requires the
spicetify-connect-apiextension to be enabled in your Spicetify setup.
🔗 Links
- PyPI: pypi.org/project/spicetify-websocket
- Documentation: spicetify-websocket.readthedocs.io
- Extension: github.com/tobfd/spicetify-connect-api
Full Changelog: https://github.com/tobfd/spicetify-websocket/commits/0.1.0