Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »

    stream-playerpublic

    node-stream-player

    npm version

    For all of your mp3 streaming needs. Queue mp3 streams and play them through your computers speakers.

    Installation

    $ npm install stream-player
    

    Example

    var StreamPlayer = require('stream-player');
    var player = new StreamPlayer();
     
    // Add a song url to the queue
    player.add('http://path-to-mp3.com/example.mp3');
     
    // Add a song url to the queue along with some metadata about the song
    // Metadata can be any object that you want in any format you want
    var metadata = {
      "title": "Some song",
      "artist": "Some artist",
      "duration": 234000,
      "humanTime": "3:54"
    };
     
    player.add('http://path-to-mp3.com/example.mp3', metaData);
     
    // Start playing all songs added to the queue (FIFO)
    player.play();
     
    // Get the metadata for the current playing song and a time stamp when it started playing
    player.nowPlaying();
     
    // Get an array of metadata for the songs in the queue (excludes the current playing song)
    player.getQueue();
     
    // Get if the player is currently playing
    player.isPlaying()
     
     
    // EMIT EVENTS
     
    player.on('play start', function() {
      // Code here is executed every time a song starts playing
    });
     
    player.on('play end', function() {
      // Code here is executed every time a song ends
    });
     
    player.on('song added', function() {
      // Code here is executed every time a song is added to the queue
    });
     

    Methods

    add(url [, metadata])

    Adds the mp3 stream located at url to the queue. The optional metadata parameter can be any JS object that holds information about the song. If no metadata is given then it will be undefined when referenced.

    play()

    Starts playing the next song in the queue out of the speakers. throws new Error('A song is already playing.') throws new Error('The queue is empty.')

    pause()

    Pause the current playing sound. Call play() to resume.

    getQueue()

    Returns an array of song metadata in the queue.

    isPlaying()

    Returns true if a song is currently playing and false otherwise.

    nowPlaying()

    Returns an object containing the current playing song's metadata and the Unix time stamp of when the song started playing. throws new Error('No song is currently playing.')

    Example
    {
      track: {
        title: "Some song",
        artist: "Some artist"
      },
      timestamp: 1438489161
    }

    Roadmap

    • Support for more audio file types

    install

    npm i stream-player

    Downloadsweekly downloads

    29

    version

    0.3.0

    license

    MIT

    repository

    githubgithub

    last publish

    collaborators

    • avatar