node-mp3-player

    1.0.3 • Public • Published

    node-mp3-player

    Coverage Status Build Status JavaScript Style Guide

    Use the browser Audio api to play mp3 files in node. Browser api brought to you by electron (specifically electron-spawn) The motivation being this should be more cross-platform friendly. API is still early stages and supports the basic stuff, we're open to new functionality being requested and/or contributed.

    usage

    Require the createAudio method and use it to get the Audio constructor. The Audio constructor has more or less the same API as the browser Audio global. See the API section for specific quircks.

    Please note that the createAudio method instantiates an electron child_process in order to access the the browser API. Calling it multiple times will instantiate multiple electron processes. This is probably not what you want. You probably want to create multiple files using the Audio pseudo constructor. Though if multiple electron instances is your thing, knock your socks off.

    const { createAudio } = require('node-mp3-player')
    const Audio = createAudio();
     
    (async () => {
      const myFile = await Audio(`${__dirname}/mp3/foo.mp3`)
      await myFile.volume(0.5)
      const currentVolume = await myFile.volume() // 0.5
      await myFile.loop()
      await myFile.stop()
    })()
     

    API

    Should be the same as the browser Audio api, except it returns promises and thus uses traditional functions rather than getters/setters.

    constructor

    const myFile = await Audio('/path/to/my/file')

    play / stop

    const myFile = await Audio('/path/to/my/file')
    await myFile.play() // plays the file
    await myFile.stop() // stops the file

    volume

    const myFile = await Audio('/path/to/my/file')
    await myFile.volume(0.5) // changes the volume, similar to the browser myFile.volume = 0.5

    loop

    const myFile = await Audio('/path/to/my/file')
    await myFile.loop(true) // loops the file similar to the browser myFile.loop = true
    await myFile.loop(false) // unloops the file similar to the browser myFile.loop = false

    license

    MIT

    Install

    npm i node-mp3-player

    DownloadsWeekly Downloads

    18

    Version

    1.0.3

    License

    MIT

    Unpacked Size

    236 kB

    Total Files

    28

    Last publish

    Collaborators

    • imsnif