erela.js-spotify

Spotify plugin for Erela.JS

Usage no npm install needed!

<script type="module">
  import erelaJsSpotify from 'https://cdn.skypack.dev/erela.js-spotify';
</script>

README

This a plugin for Erela.JS to allow the use of Spotify URL's, it uses direct URL's being tracks, albums, and playlists and gets the YouTube equivalent.

Documentation & Guides

It is recommended to read the documentation to start, and the guides to use the plugin.

Prerequisites

Installation

NPM :

npm install erela.js-spotify

Yarn :

yarn add erela.js-spotify

Options

  • clientID

The Spotify client ID.
This is required to use this plugin.

  • clientSecret

The Spotify client secret.
This is required to use this plugin.

  • playlistLimit

The amount of pages to load when a playlist is searched with each page having 100 tracks.
By default this retrieves all tracks in the playlist.
Note: This must be 1 or higher, 0 will load all.

  • albumLimit

The amount of pages to load when an album is searched with each page having 50 tracks.
By default this retrieves all tracks on the album.
Note: This must be 1 or higher, 0 will load all.

  • convertUnresolved

Converts all UnresolvedTracks into a Track.
NOTE: THIS IS NOT RECOMMENDED AS IT WILL ATTEMPT TO CONVERT EVERY TRACK, INCLUDING ALBUMS AND PLAYLISTS TRACKS.
DEPENDING ON THE AMOUNT THIS WILL TAKE A WHILE AND MAY RATELIMIT YOUR LAVALINK NODE.

Example Usage

const { Manager } = require("erela.js");
const Spotify  = require("erela.js-spotify");

const clientID = "example ID"; // clientID from your Spotify app
const clientSecret = "example secret"; // clientSecret from your Spotify app

const manager = new Manager({
  plugins: [
    // Initiate the plugin and pass the two required options.
    new Spotify({
      clientID,
      clientSecret
    })
  ]
});

manager.search("https://open.spotify.com/track/4uLU6hMCjMI75M1A2tKUQC");