erela.js-spotify
v1.2.0
Published
Spotify plugin for Erela.JS
Downloads
2,767
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.
- https://open.spotify.com/track/4uLU6hMCjMI75M1A2tKUQC
- https://open.spotify.com/album/6N9PS4QXF1D0OWPk0Sxtb4
- https://open.spotify.com/playlist/37i9dQZF1DZ06evO05tE88
Documentation & Guides
It is recommended to read the documentation to start, and the guides to use the plugin.
Prerequisites
- Spotify App for the clientID & clientSecret
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");