cody-music

@software/music

Control Spotify and iTunes, currently only on Mac OSX with NodeJS.

Installation

$ npm install @software/music

Running unit tests

$ npm test

API

playTrack(uri)

Play a track with Music URI uri.

Specify either "Spotify" or "iTunes" (case-insensitive).

const music = require("@software/music");

// get the track info using get state
music.getState("iTunes").then(state => {
    // - "genre" will be empty from Spotify
    // - duration is in milliseconds
    // {artist, album, genre, disc_number, duration, played_count, track_number, id, name, state}
    console.log(state);
});

// play a specific spotify track
music
    .playTrack("Spotify", "spotify:track:2YarjDYjBJuH63dUIh9OWv")
    .then(result => {
        // track is playing
    });

// play an iTunes track number
music.playTrack("iTunes", 1).then(result => {
    // track is playing
});

// handling errors
music.playTrack("iTunes", 1000000000).then(result => {
    // result will contain the "error" attribute with the error message
    if (result.error) {
        console.log(`Unable to play track, error: ${result.error}`);
    }
});

play("Spotify")

Resume playing current track.

pause("Spotify")

Pause playing track.

playPause("Spotify")

Toggle play.

next("Spotify")

Play next track.

previous("Spotify")

Play previous track.

volumeUp("Spotify")

Turn volume up.

volumeDown("Spotify")

Turn volume down.

setVolume("Spotify", volume)

Sets the volume.

music.setVolume("Spotify", 42).then(() => {
    music.getState(state => {
        console.log(state.volume);
    });
});

muteVolume("Spotify")

Reduces audio to 0, saving the previous volume.

unmuteVolume("Spotify")

Returns audio to original volume.

isRunning("Spotify")

Check if the music player is running.

music.isRunning("Spotify").then(isRunning => {
    console.log(isRunning); // true || false
});

isRepeating("Spotify")

Is repeating on or off?

music.isRepeating("Spotify").then(isRepeating => {
    console.log(isRepeating); // true || false
});

setShufflingOn("Spotify")

Is shuffling on or off?

music.isShuffling("Spotify").then(isShuffling => {
    console.log(isShuffling); // true || false
});

Contributors

• Cody

License