acrcloud
    TypeScript icon, indicating that this package has built-in type declarations

    1.4.0 • Public • Published

    ACRCloud npm module

    Node version Dependencies

    How to use

    Before you can begin identifying audio with ACRCloud's API, you need to sign up for a free trial over at https://www.acrcloud.com and create an Audio & Video recognition project. This will generate a host, access_key, and access_secret for you to use.

    Set up

    To create a new instance of ACRCloud, all you need to do is install the module and require it in the head of your project.

    const acrcloud = require("acrcloud");
     
    const acr = new acrcloud({
      host: "us-west-2.api.acrcloud.com",
      access_key: "*****",
      access_secret: "*****"
    });

    Usage

    To identify an audio file, use the identify() function and pass it a file buffer from a local directory.

    const fs = require("fs");
    const sample = fs.readFileSync("/path-to-file.wav");
     
    acr.identify(sample).then(metadata => {
      console.log(metadata);
    });

    Audio file vs Audio fingerprint

    The ACRCloud API accepts either a raw audio file (WAV, MP3, AIFC, etc), or an audio fingerprint as the POST body. At the time of writing, this module is only set up to accept a raw audio file. Finterprints will be included in a future update, or you can modify the script yourself to accept them.

    Optional parameters

    By default, creating a new instance will assume that your audio file has all the necessary headers in order to successfully parse and identify the file. There are additional optional parameters you can use when creating the acr instance.

    • audio_format The format of your audio data, like "mp3, wav, ma4, pcm, amr" etc, If your audio file does not have audio header, this parameter should be included
    • sample_rate If your audio file does not have audio header, this parameter should be included
    • audio_channels If your audio file does not have audio header, this parameter should be included. Allowed values: 1, 2
    const acr = new acrcloud({
      host: "us-west-2.api.acrcloud.com",
      access_key: "*****",
      access_secret: "*****",
      audio_format: "wav",
      sample_rate: 44100,
      audio_channels: 2
    });

    TODO

    • ☐ Accept audio fingerprints in addition to audio files.
    • ☐ Remove fetch dependency and replace with https module.
    • ☐ Write better tests.

    Install

    npm i acrcloud

    DownloadsWeekly Downloads

    187

    Version

    1.4.0

    License

    MIT

    Unpacked Size

    9.18 kB

    Total Files

    8

    Last publish

    Collaborators

    • arronhunt