Skip to content

v0.1.0 - Release

Choose a tag to compare

@tobfd tobfd released this 28 Jul 20:17
· 9 commits to master since this 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 asyncio and websockets for maximum performance and zero polling overhead.

📦 Installation

pip install spicetify-websocket

Note: Requires the spicetify-connect-api extension to be enabled in your Spicetify setup.


🔗 Links

Full Changelog: https://github.com/tobfd/spicetify-websocket/commits/0.1.0