spotipyFree 1.9.6

A Spotipy-compatible wrapper using SpotAPI

SpotipyFree

A lightweight drop-in replacement for Spotipy without using the spotify api. This project was build because spotify removed access to its API for non-premium users. This project doesn't use ANY Spotify APIs.

---

Features

• Drop-in style response compatible with spotipy

• No Spotify account required

• Returns playback data structured like the official Spotify API

---

Current Status

This project is experimental.

Currently implemented:

• search()
• track()
• playlist()
• playlist_items()
• artist()
• artist_albums()
• album()
• album_tracks()
• current_user_recently_played() - must first run startRecentlyPlayedListener
• current_user_saved_tracks()
• current_user_saved_tracks_contains()
• current_user_playlists()
• current_playback()
• current_user()
• me()
• seek_track()
• next_track()
• previous_track()
• start_playback()
• pause_playback()

---

There is also a feature to host the api as a Flask endpoint.

Installation

Bash

pip install spotipyFree

---

Usage without login

from SpotipyFree import Spotify

sp = Spotify()

search = sp.search("Blinding Light - Weekend")
artist = sp.artist("3Bd1cgCjtCI32PYvDC3ynO")
artistAlbums = sp.artist_albums("3Bd1cgCjtCI32PYvDC3ynO", include_groups="album,single,compilation")
playlist = sp.playlist_items("6lnfkAgnVtNzvj8KScLSkj")
track = sp.track("67Hna13dNDkZvBpTXRIaOJ")
album = sp.album("4m2880jivSbbyEGAKfITCa")
albumTracks = sp.album_tracks("4m2880jivSbbyEGAKfITCa")

Usage with login

sp = Spotify()
sp.login()

status = spotapi.player.PlayerStatus(sp.user_auth)
sp.startRecentlyPlayedListener()
state = status.state.__dict__
saved = sp.current_user_saved_tracks()
me = sp.me()

Usage with web API

Hosting the web api:

python -c "import SpotipyFree.web as web; web.runWebAPI()"

Using the web api

import json
import requests

BASE_URL = "http://127.0.0.1:5000"

url = f"{BASE_URL}/search"
response = requests.post(url, json=["Blinding Light - Weekend"])

print(f"Status: {response.status_code}")
print(response.json())

This project is in no way affiliated with Spotify.