Baike.dev
All toolsOnline toolsAI codingTrendingOpen sourceNewsSubmit
Log in
< Back to tools
S

spotify-websocket-api

> 编程语言
Open source

Spotify Websocket API is a fully open source Spotify library based on the WebSocket API used in the Spotify Web beta

397 stars0 likes0 views
WebsiteGitHub

About

Spotify Websocket API is a fully open source Spotify library based on the WebSocket API used in the Spotify Web beta

Spotify WebSocket API

Getting started

NOTE: This API will only work with paid Spotify accounts. I'm perfectly fine with this restriction and won't be attempting to circumvent it, nor will I merge patches that do. It'd only end in a game of cat and mouse which is a waste of everyone's time. If you like Spotify, buy a Premium account and tell the industry that it's a great payment model for music.

Firstly, try out the demo script to make sure you've got the dependencies installed properly:

  • requests >= 1.0
  • ws4py
  • protobuf
  • lxml

Then you can try one of the example scripts

cd examples python blocking.py <username> <password> album

This should show an album title and a list of track titles for it.

Using the API is pretty simple, here's the basics:

sp = Spotify("username", "password") results = sp.search("carly rae jepsen") for track in results.getTrack() print track

Experimental client

Included is an experimental client called respotify, based on this API. It's almost identical to despotify-simple in terms of functionality. Be sure to have the following additional dependencies installed:

  • cherrypy
  • web.py

Once you've installed these, you can run the client like this:

cd clients/respotify ./respotify.py <username> <password>

                               _    ___       
                           _  (_)  / __)      

____ _____ ___ ____ ___ | | _ | |_ _ _ / ) ___ |/) _ \ / _ (_ ) ( ) | | | | | | | | || | || || || | | | | || | || |___|__/| / _/ _)| || __ | || (___/

info shows account information play plays the track with given index help shows help information stop stops any currently playing track album view the album for a specific track quit quits the application artist view the artist for a specific track list lists your rootlist or a playlist uri lists metadata for a URI (album) next plays the next track in the current playlist current shows the current playlist we're playing prev plays the previous track in the current playlist

What's implemented?

  • Login via username/password
  • Metadata retrieval (track/album/artist)
  • Playlist and rootlist support (add/remove tracks, creation/renaming/deletion)
  • Toplists for both regions and users (track/album/artist only)
  • Starring/unstarring tracks
  • MP3 playback URL retrieval

What's NOT implemented?

  • Inbox (not currently supported via the web client it appears)
  • Subscribing to playlist updates
  • Social functionality

TODO

Want to help out? Great! Here's a a list of things that need doing or improving:

  • An example graphical client using the API (preferably multi-platform, OSX/Linux)
  • Anything from the unimplemented list above

Want to write a library in another language?

If you'd like to help out with this library or write a new one for another language do let me know and pop into #despotify on EFnet. I'm aware of people working on Java and Node.js libraries currently, more are of course welcome.

Issues· 14 open

View all issuesOpen on GitHub

No open issues yet, or sync has not completed.

> Tags

Python

No comments yet. Be the first to share.

> Details

PublishedAug 1, 2026
UpdatedSep 17, 2026
Category编程语言
PricingOpen source

> Related tools

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言