mySpottyAPI

real time listening status based on Spotify

real time listening status image - try reloading the page!

the guide

I've made a guide on how to deploy your own version of this API, you can find it here

the android app

mySpotty is the android app that makes the usage of the API easier


Key Features

home page
Home page
home page last listened
Last listened song in home page
sotd sheet in home page
Song of The Day sheet in home page
settings page
Settings page
shared link page
Shared link page

Please vote my App on the dessert form

What can this server do?

The listening API

listening API

A simpler api that makes it easy to know what the current or last song is.


GET /api

Get the currently (or last) played song


    GET /api/last
    
Get the last played song


    


    

    
To see a better usage of this API go to reloia.github.io






    
Generate an image to put on any website

    
Like the one you can see at the top of the page!

    


    
That shows your currently played song.

    
To generate the image, you need to put the url to the widget's endpoint.

    

    
The widget is generated using JavaScript Canvas (Node.js)

    


    It can also be customized with the following query parameters:

    backgroundColor - the background color of the widget

    barColor - the color of the bar that separates the image from the text

    barBackgroundColor - the color of the bar's background

    borderRadius - the border radius of the widget


    The widget's endpoint is /widgets/listening





    
the Song of the Day

    sotd
    
An API widget that allows to store your favorite songs with date and other info.

    
It can be used to show the song of the day on your website, and it saves them in a file



    GET /sotd/
    
Get the song of the day

    

    The following requires an Authentication header



    POST /sotd/clear
    
Clear the song list



    POST /sotd/
    
Post a new song of the day



    POST /sotd/url
    
Post a new song of the day with an url



    POST /sotd/remove
    
Remove a song of the day at a certain index


    POST /sotd/remove/url
    
Remove a song of the day with a certain url


    POST /sotd/remove/date
    
Remove a song of the day with a certain date






    
Paint Canvas

    canvas
    
A canvas that works using pixel stored as single objects of an array.

    

    GET /paintcanvas/status
    
Get the paint canvas' current status

    

    POST /paintcanvas
    
Update a pixel on the canvas






All of this works with Node.js and Spotify's API.