spotilocal
    TypeScript icon, indicating that this package has built-in type declarations

    0.4.4 • Public • Published

    spotilocal

    Unofficial api for Spotify's local web server.

    How it works

    It uses the same method as https://developer.spotify.com/technologies/widgets/spotify-play-button/ does. Basically Spotify desktop runs a web server on 127.0.0.1 that can accept specific commands and even open Spotify client itself.

    Spotify domain spotilocal.com that simply points to 127.0.0.1. Apparently in order to bypass browser's limitation of amount of concurrent connection to the same domain they use randomly generated subdomains of spotilocal.com.

    Api

    Spotilocal#init(defaultPort?:number)

    Initializes the Spotilocal client. Returns a Promise for Spotilocal client.

    defaultPort - Port to try first.

    Spotilocal#getStatus(returnOn?:Array<play|pause|login|logout|error|ap>, returnAfter?:number)

    Returns a Promise for Status.

    returnOn - Activates long-polling to return when one or more specific event(s) occur.

    returnAfter - Defines a timeout. Pass 0 to disable. Default is 0.

    Spotilocal#pause(pause:boolean)

    Pauses or unpauses current playback. Returns a Promise for Status.

    Spotilocal#play(uri:string, context?:string)

    Plays song with uri in provided context.

    uri - track uri.

    context - of song(where it exists). Examples: playlist uri, album uri and so on.

    Returns a Promise for Status.

    Example usage

    import {Spotilocal} from 'spotilocal';
     
    const spotilocal = new Spotilocal();
    const trackUri = 'spotify:track:3cANM3NuUjRDTi8fdU8P6q';
    spotilocal.init().then((spotilocal) => {
        return spotilocal.play(trackUri, 'spotify:user:shyyko.serhiy:playlist:4SdN0Re3tJg9uG08z2Gkr1')
    }).then((status) => {
        console.log(`Playing:   ${status.playing}`);
        console.log(`Song Name: ${status.track.track_resource.name}`);
        return spotilocal.pause(true);
    }).catch(console.error);

    Install

    npm i spotilocal

    DownloadsWeekly Downloads

    18

    Version

    0.4.4

    License

    MIT

    Last publish

    Collaborators

    • avatar