nodejs-audio-visualizer 5.1.0 → 5.3.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2019 VladislavPetyukevich
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2019 VladislavPetyukevich
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,80 +1,81 @@
-# nodejs-audio-visualizer
-Audio visualizer generator for Node.js with simple configuration.  
-Supports PNG, JPG for images, MP4/MOV/AVI/MKV for background videos, and MP3, WAV for audio.
-
-## Example
-```javascript
-const renderAudioVisualizer = require('nodejs-audio-visualizer').renderAudioVisualizer;
-const config = {
-  image: { // Optional.
-    path: 'media/background.png' // Supports PNG and JPG images. Use either 'image' or 'video', not both.
-  },
-  // OR use a video as background (optional):
-  // video: {
-  //   path: 'media/background.mp4', // Supports MP4, MOV, AVI, MKV. Loops automatically if shorter than audio.
-  //   autoEdit: true, // Optional. Detects scene cuts and advances between them on the detected BPM beat grid about every 2–4 beats so the background edits with the music; omit or false for one continuous play-through from the start. When enabled, a brief camera shake every second beat decays over about one-third of a beat.
-  // },
-  audio: {
-    path: 'media/audio.wav', // Supports MP3 and WAV audio
-    autoHighlight: true,
-    autoHighlightCount: 3, // Optional. With autoHighlight: how many non-overlapping 15s windows with the highest summed spectral energy to aim for (default 1; must be a whole number ≥ 1). You may get fewer videos if the track is too short or does not have that many valid windows. More than one window produces separate videos next to outVideo.path (e.g. out-1.mp4, out-2.mp4).
-  },
-  outVideo: {
-    path: 'media/out.mp4',
-    subtitles: { // Optional.
-      path: 'media/subtitles.lrc', // Optional. .srt or .lrc format.
-      rawContent: "1\n00:00:00,000 --> 99:59:59,999\nSome Artist - Some Song", // Only if path not specified.
-      alignment: "middle", // Optional. Available values: 'top', 'middle', 'bottom'. Default: 'bottom'.
-    },
-    fps: 25, // Default value: 30
-    resolution: { width: 1920, height: 1080 }, // Optional. Output frame size in pixels. Omit to keep the background image or video at its native resolution; when set, video frames are scaled to this size and images are resized (center-cropped first if landscape/portrait does not match the target aspect).
-    spectrum: { // Audio spectrum configuration (linear bar visualizer). Optional. If neither 'spectrum' nor 'polar' is specified, no visualizer is drawn.
-      width: '30%', // 30% of background image width. Default value: 33%. Also you can use absolute values. For example, value 300 for 300 pixels width.
-      height: '15%', // 15% of background image height. Default value: 160. Also you can use absolute values. For example, value 300 for 300 pixels height.
-      x: 'center', // Available values: 'left', 'center', right'. Also you can use absolute number values. For example, value 300 for 300 pixels x.
-      y: 'bottom', // Available values: 'top', 'middle', bottom'. Also you can use absolute number values. For example, value 300 for 300 pixels y.
-      rotation: 'mirror', // Available values: 'up', 'down', 'mirror'. Default value: 'mirror'.
-      effect: 'volume', // Available values: 'volume', 'smooth', undefined. Default value: undefined.
-      color: '#cccc99', // Default value: inverted color of background image
-      opacity: '70%' // Default value: '80%'.
-    },
-    polar: { // Polar/circular audio spectrum configuration. Optional. Use either 'spectrum' or 'polar', not both.
-      x: 'center', // Available values: 'left', 'center', 'right'. Also you can use absolute number values. Default value: 'center'.
-      y: 'middle', // Available values: 'top', 'middle', 'bottom'. Also you can use absolute number values. Default value: 'middle'.
-      innerRadius: 100, // Inner radius of the circular spectrum in pixels. Default value: 100.
-      maxBarLength: 160, // Maximum bar length in pixels. Default value: 160.
-      barWidth: 15, // Width of each bar in pixels. Default value: 15.
-      effect: 'volume', // Available values: 'volume', 'smooth', undefined. Default value: undefined.
-      color: '#cccc99', // Default value: inverted color of background image
-      opacity: '70%' // Default value: '80%'.
-    }
-  },
-  tweaks: { // Optional
-    ffmpeg_cfr: '30', // Default value: 23
-    ffmpeg_preset: 'ultrafast', // Default value: medium
-    frame_processing_delay: 1000, // Delay between processing frames in milliseconds
-    timeouts: { // Optional. FFmpeg I/O timeouts in milliseconds
-      readVideoFrame: 30000, // Max wait for one background video frame from ffmpeg. Default: 30000
-      waitDrain: 120000, // Max wait for ffmpeg stdin to accept more frames. Default: 120000
-      waitForProcessExit: 480000 // Max wait for ffmpeg to finish after all frames are sent. Default: 480000
-    }
-  }
-};
-
-const onProgress = (progressPercent: number) => { // not necessary callback
-  console.log(`progress: ${progressPercent} %`);
-};
-
-const shouldStop = () => { // not necessary callback
-  return false;
-};
-
-renderAudioVisualizer(config, onProgress, shouldStop)
-  .then(({ exitCode, outputVideoFiles }) => {
-    console.log(`exited with code: ${exitCode}`);
-    console.log(`written:`, outputVideoFiles);
-  });
-```
-
-## Output preview
-![frame of output video](example/media/out-sample.png)
+# nodejs-audio-visualizer
+Audio visualizer generator for Node.js with simple configuration.  
+Supports PNG, JPG for images, MP4/MOV/AVI/MKV for background videos, and MP3, WAV for audio.
+
+## Example
+```javascript
+const renderAudioVisualizer = require('nodejs-audio-visualizer').renderAudioVisualizer;
+const config = {
+  image: { // Optional.
+    path: 'media/background.png' // Supports PNG and JPG images. Use either 'image' or 'video', not both.
+  },
+  // OR use a video as background (optional):
+  // video: {
+  //   path: 'media/background.mp4', // Supports MP4, MOV, AVI, MKV. Loops automatically if shorter than audio. Can also be an array of paths, e.g. ['media/bg1.mp4', 'media/bg2.mp4']: with autoEdit false the videos play one after another (looping the sequence as needed), and with autoHighlight producing several videos each one starts with a different video from the array; with autoEdit true, cuts switch (shuffle) between the given videos instead of auto-detecting scene changes. Videos in an array should share the same resolution and frame rate for best results, especially when outVideo.resolution is not set.
+  //   autoEdit: true, // Optional. Detects scene cuts and advances between them on the detected BPM beat grid about every 2–4 beats so the background edits with the music; omit or false for one continuous play-through from the start. When enabled, a brief camera shake starts 0.1s after each cut and decays over about one-third of a beat (if the video has no detected scene changes, and so no cuts, it shakes every 2 beats instead).
+  //   cameraShake: false, // Optional. With autoEdit: set to false to disable the camera shake applied on cuts (default true).
+  // },
+  audio: {
+    path: 'media/audio.wav', // Supports MP3 and WAV audio
+    autoHighlight: true, // Optional. Cuts the most energetic ~15s of the track. Start and end are moved onto beats (by up to 1.5s each), preferring a length of whole 4-beat bars, so the highlight may run slightly shorter or longer than 15s.
+    autoHighlightCount: 3, // Optional. With autoHighlight: how many non-overlapping ~15s windows with the highest summed spectral energy to aim for (default 1; must be a whole number ≥ 1). You may get fewer videos if the track is too short or does not have that many valid windows. More than one window produces separate videos next to outVideo.path (e.g. out-1.mp4, out-2.mp4).
+  },
+  outVideo: {
+    path: 'media/out.mp4',
+    subtitles: { // Optional.
+      path: 'media/subtitles.lrc', // Optional. .srt or .lrc format.
+      rawContent: "1\n00:00:00,000 --> 99:59:59,999\nSome Artist - Some Song", // Only if path not specified.
+      alignment: "middle", // Optional. Available values: 'top', 'middle', 'bottom'. Default: 'bottom'.
+    },
+    fps: 25, // Default value: 30
+    resolution: { width: 1920, height: 1080 }, // Optional. Output frame size in pixels. Omit to keep the background image or video at its native resolution; when set, video frames are scaled to this size and images are resized (center-cropped first if landscape/portrait does not match the target aspect).
+    spectrum: { // Audio spectrum configuration (linear bar visualizer). Optional. If neither 'spectrum' nor 'polar' is specified, no visualizer is drawn.
+      width: '30%', // 30% of background image width. Default value: 33%. Also you can use absolute values. For example, value 300 for 300 pixels width.
+      height: '15%', // 15% of background image height. Default value: 160. Also you can use absolute values. For example, value 300 for 300 pixels height.
+      x: 'center', // Available values: 'left', 'center', right'. Also you can use absolute number values. For example, value 300 for 300 pixels x.
+      y: 'bottom', // Available values: 'top', 'middle', bottom'. Also you can use absolute number values. For example, value 300 for 300 pixels y.
+      rotation: 'mirror', // Available values: 'up', 'down', 'mirror'. Default value: 'mirror'.
+      effect: 'volume', // Available values: 'volume', 'smooth', undefined. Default value: undefined.
+      color: '#cccc99', // Default value: inverted color of background image
+      opacity: '70%' // Default value: '80%'.
+    },
+    polar: { // Polar/circular audio spectrum configuration. Optional. Use either 'spectrum' or 'polar', not both.
+      x: 'center', // Available values: 'left', 'center', 'right'. Also you can use absolute number values. Default value: 'center'.
+      y: 'middle', // Available values: 'top', 'middle', 'bottom'. Also you can use absolute number values. Default value: 'middle'.
+      innerRadius: 100, // Inner radius of the circular spectrum in pixels. Default value: 100.
+      maxBarLength: 160, // Maximum bar length in pixels. Default value: 160.
+      barWidth: 15, // Width of each bar in pixels. Default value: 15.
+      effect: 'volume', // Available values: 'volume', 'smooth', undefined. Default value: undefined.
+      color: '#cccc99', // Default value: inverted color of background image
+      opacity: '70%' // Default value: '80%'.
+    }
+  },
+  tweaks: { // Optional
+    ffmpeg_cfr: '30', // Default value: 23
+    ffmpeg_preset: 'ultrafast', // Default value: medium
+    frame_processing_delay: 1000, // Delay between processing frames in milliseconds
+    timeouts: { // Optional. FFmpeg I/O timeouts in milliseconds
+      readVideoFrame: 30000, // Max wait for one background video frame from ffmpeg. Default: 30000
+      waitDrain: 120000, // Max wait for ffmpeg stdin to accept more frames. Default: 120000
+      waitForProcessExit: 480000 // Max wait for ffmpeg to finish after all frames are sent. Default: 480000
+    }
+  }
+};
+
+const onProgress = (progressPercent: number) => { // not necessary callback
+  console.log(`progress: ${progressPercent} %`);
+};
+
+const shouldStop = () => { // not necessary callback
+  return false;
+};
+
+renderAudioVisualizer(config, onProgress, shouldStop)
+  .then(({ exitCode, outputVideoFiles }) => {
+    console.log(`exited with code: ${exitCode}`);
+    console.log(`written:`, outputVideoFiles);
+  });
+```
+
+## Output preview
+![frame of output video](example/media/out-sample.png)

package/dist/audio.d.ts

@@ -1,13 +1,13 @@
-/// <reference types="node" />
-export declare const skipEvery: <T>(skipIndex: number) => (element: T, index: number) => boolean;
-export declare const getPeaks: (spectrums: number[], prevPeaks?: number[] | undefined) => number[];
-export declare const correctPeaks: (spectrums: number[], peaks: number[]) => number[];
-export declare const createSpectrumsProcessor: (sampleRate: number, skipFramesCount: number) => (parseAudioData: () => number[]) => number[];
-export declare const bufferToUInt8: (buffer: Buffer, start: number, end: number) => number[];
-export declare const normalizeAudioData: (PCMData: number[]) => number[];
-export declare const pcmU8ToFloatSamples: (buffer: Buffer) => number[];
-export declare const spawnFfmpegAudioReader: (filename: string, format: string) => import("child_process").ChildProcessWithoutNullStreams;
-export declare const createAudioBuffer: (filename: string, format: string) => Promise<{
-    audioBuffer: Buffer;
-    sampleRate: number;
-}>;
+/// <reference types="node" />
+export declare const skipEvery: <T>(skipIndex: number) => (element: T, index: number) => boolean;
+export declare const getPeaks: (spectrums: number[], prevPeaks?: number[] | undefined) => number[];
+export declare const correctPeaks: (spectrums: number[], peaks: number[]) => number[];
+export declare const createSpectrumsProcessor: (sampleRate: number, skipFramesCount: number) => (parseAudioData: () => number[]) => number[];
+export declare const bufferToUInt8: (buffer: Buffer, start: number, end: number) => number[];
+export declare const normalizeAudioData: (PCMData: number[]) => number[];
+export declare const pcmU8ToFloatSamples: (buffer: Buffer) => number[];
+export declare const spawnFfmpegAudioReader: (filename: string, format: string) => import("child_process").ChildProcessWithoutNullStreams;
+export declare const createAudioBuffer: (filename: string, format: string) => Promise<{
+    audioBuffer: Buffer;
+    sampleRate: number;
+}>;

package/dist/audio.js

@@ -1,129 +1,129 @@
-"use strict";
-var __spreadArrays = (this && this.__spreadArrays) || function () {
-    for (var s = 0, i = 0, il = arguments.length; i < il; i++) s += arguments[i].length;
-    for (var r = Array(s), k = 0, i = 0; i < il; i++)
-        for (var a = arguments[i], j = 0, jl = a.length; j < jl; j++, k++)
-            r[k] = a[j];
-    return r;
-};
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-var child_process_1 = require("child_process");
-var ffmpeg_static_1 = __importDefault(require("ffmpeg-static"));
-var dsp_1 = require("./dsp");
-exports.skipEvery = function (skipIndex) { return function (element, index) {
-    return index % skipIndex === 0;
-}; };
-exports.getPeaks = function (spectrums, prevPeaks) {
-    if (!prevPeaks) {
-        return spectrums;
-    }
-    var resultPeaks = [];
-    for (var i = 0; i < spectrums.length; i++) {
-        var currValue = spectrums[i];
-        var currPrevPeak = prevPeaks[i] || 0;
-        resultPeaks.push((currValue > currPrevPeak) ? currValue : currPrevPeak);
-    }
-    return resultPeaks;
-};
-exports.correctPeaks = function (spectrums, peaks) {
-    var resultSpectrum = [];
-    for (var i = 0; i < spectrums.length; i++) {
-        var value = spectrums[i];
-        var peakValue = peaks[i] || 0;
-        if (value < 3) {
-            resultSpectrum.push(value / 3);
-        }
-        else {
-            resultSpectrum.push(value / peakValue);
-        }
-    }
-    return resultSpectrum;
-};
-var oldMax = 1;
-var newMin = 0.6;
-var getInterpolationFactor = function (skippedFramesCount, skipFramesCount) {
-    var interpolationFactor = 1 - (skippedFramesCount / skipFramesCount);
-    var interpolationFactorInRange = (interpolationFactor * (oldMax - newMin)) + newMin;
-    return interpolationFactorInRange;
-};
-exports.createSpectrumsProcessor = function (sampleRate, skipFramesCount) {
-    var prevAudioDataNormalized = [];
-    var prevPeaks = [];
-    var skippedFramesCount = 0;
-    var targetSpectrum = [];
-    var previousSpectrum = [];
-    return function (parseAudioData) {
-        if (skippedFramesCount === 0) {
-            skippedFramesCount = skipFramesCount;
-            var audioDataNomrmalized = exports.normalizeAudioData(parseAudioData());
-            prevAudioDataNormalized = audioDataNomrmalized;
-            var spectrum = dsp_1.getSpectrum(audioDataNomrmalized, sampleRate);
-            var peaks = exports.getPeaks(spectrum, prevPeaks);
-            var correctedSpectrum = prevPeaks.length === 0 ?
-                Array(dsp_1.FREQUENCY_BANDS.length).fill(0) :
-                exports.correctPeaks(spectrum, peaks);
-            prevPeaks = peaks;
-            previousSpectrum = __spreadArrays(targetSpectrum);
-            targetSpectrum = correctedSpectrum;
-        }
-        else {
-            skippedFramesCount--;
-        }
-        var interpolationFactor = getInterpolationFactor(skippedFramesCount, skipFramesCount);
-        var interpolatedSpectrum = targetSpectrum.map(function (target, i) {
-            var prev = previousSpectrum[i] || target;
-            return prev + (target - prev) * interpolationFactor;
-        });
-        return interpolatedSpectrum;
-    };
-};
-exports.bufferToUInt8 = function (buffer, start, end) {
-    var numbers = [];
-    for (var i = start; i < end; i += 1) {
-        numbers.push(buffer.readUInt8(i));
-    }
-    return numbers;
-};
-exports.normalizeAudioData = function (PCMData) {
-    return PCMData.map(function (num) { return (num - 128) / 128; });
-};
-exports.pcmU8ToFloatSamples = function (buffer) {
-    var n = buffer.length;
-    var samples = new Array(n);
-    for (var i = 0; i < n; i++) {
-        samples[i] = (buffer[i] - 128) / 128;
-    }
-    return samples;
-};
-exports.spawnFfmpegAudioReader = function (filename, format) {
-    if (!ffmpeg_static_1.default) {
-        throw new Error('ffmpeg path not found');
-    }
-    var ffmpegProcess = child_process_1.spawn(ffmpeg_static_1.default, ['-i', filename, '-f', format, '-ac', '1', '-']);
-    return ffmpegProcess;
-};
-exports.createAudioBuffer = function (filename, format) {
-    return new Promise(function (resolve, reject) {
-        var sampleRate;
-        var sampleRateRegExp = /(\d+) Hz/m;
-        var audioBuffers = [];
-        var ffmpegAudioReader = exports.spawnFfmpegAudioReader(filename, format);
-        ffmpegAudioReader.stderr.on('data', function (data) {
-            var match = data.toString().match(sampleRateRegExp);
-            if (!sampleRate && match) {
-                sampleRate = match[1];
-            }
-        });
-        ffmpegAudioReader.stdout.on('data', function (chunkBuffer) {
-            audioBuffers.push(chunkBuffer);
-        });
-        ffmpegAudioReader.stdout.on('end', function () {
-            var audioBuffer = Buffer.concat(audioBuffers);
-            resolve({ audioBuffer: audioBuffer, sampleRate: sampleRate });
-        });
-    });
-};
+"use strict";
+var __spreadArrays = (this && this.__spreadArrays) || function () {
+    for (var s = 0, i = 0, il = arguments.length; i < il; i++) s += arguments[i].length;
+    for (var r = Array(s), k = 0, i = 0; i < il; i++)
+        for (var a = arguments[i], j = 0, jl = a.length; j < jl; j++, k++)
+            r[k] = a[j];
+    return r;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+var child_process_1 = require("child_process");
+var ffmpeg_static_1 = __importDefault(require("ffmpeg-static"));
+var dsp_1 = require("./dsp");
+exports.skipEvery = function (skipIndex) { return function (element, index) {
+    return index % skipIndex === 0;
+}; };
+exports.getPeaks = function (spectrums, prevPeaks) {
+    if (!prevPeaks) {
+        return spectrums;
+    }
+    var resultPeaks = [];
+    for (var i = 0; i < spectrums.length; i++) {
+        var currValue = spectrums[i];
+        var currPrevPeak = prevPeaks[i] || 0;
+        resultPeaks.push((currValue > currPrevPeak) ? currValue : currPrevPeak);
+    }
+    return resultPeaks;
+};
+exports.correctPeaks = function (spectrums, peaks) {
+    var resultSpectrum = [];
+    for (var i = 0; i < spectrums.length; i++) {
+        var value = spectrums[i];
+        var peakValue = peaks[i] || 0;
+        if (value < 3) {
+            resultSpectrum.push(value / 3);
+        }
+        else {
+            resultSpectrum.push(value / peakValue);
+        }
+    }
+    return resultSpectrum;
+};
+var oldMax = 1;
+var newMin = 0.6;
+var getInterpolationFactor = function (skippedFramesCount, skipFramesCount) {
+    var interpolationFactor = 1 - (skippedFramesCount / skipFramesCount);
+    var interpolationFactorInRange = (interpolationFactor * (oldMax - newMin)) + newMin;
+    return interpolationFactorInRange;
+};
+exports.createSpectrumsProcessor = function (sampleRate, skipFramesCount) {
+    var prevAudioDataNormalized = [];
+    var prevPeaks = [];
+    var skippedFramesCount = 0;
+    var targetSpectrum = [];
+    var previousSpectrum = [];
+    return function (parseAudioData) {
+        if (skippedFramesCount === 0) {
+            skippedFramesCount = skipFramesCount;
+            var audioDataNomrmalized = exports.normalizeAudioData(parseAudioData());
+            prevAudioDataNormalized = audioDataNomrmalized;
+            var spectrum = dsp_1.getSpectrum(audioDataNomrmalized, sampleRate);
+            var peaks = exports.getPeaks(spectrum, prevPeaks);
+            var correctedSpectrum = prevPeaks.length === 0 ?
+                Array(dsp_1.FREQUENCY_BANDS.length).fill(0) :
+                exports.correctPeaks(spectrum, peaks);
+            prevPeaks = peaks;
+            previousSpectrum = __spreadArrays(targetSpectrum);
+            targetSpectrum = correctedSpectrum;
+        }
+        else {
+            skippedFramesCount--;
+        }
+        var interpolationFactor = getInterpolationFactor(skippedFramesCount, skipFramesCount);
+        var interpolatedSpectrum = targetSpectrum.map(function (target, i) {
+            var prev = previousSpectrum[i] || target;
+            return prev + (target - prev) * interpolationFactor;
+        });
+        return interpolatedSpectrum;
+    };
+};
+exports.bufferToUInt8 = function (buffer, start, end) {
+    var numbers = [];
+    for (var i = start; i < end; i += 1) {
+        numbers.push(buffer.readUInt8(i));
+    }
+    return numbers;
+};
+exports.normalizeAudioData = function (PCMData) {
+    return PCMData.map(function (num) { return (num - 128) / 128; });
+};
+exports.pcmU8ToFloatSamples = function (buffer) {
+    var n = buffer.length;
+    var samples = new Array(n);
+    for (var i = 0; i < n; i++) {
+        samples[i] = (buffer[i] - 128) / 128;
+    }
+    return samples;
+};
+exports.spawnFfmpegAudioReader = function (filename, format) {
+    if (!ffmpeg_static_1.default) {
+        throw new Error('ffmpeg path not found');
+    }
+    var ffmpegProcess = child_process_1.spawn(ffmpeg_static_1.default, ['-i', filename, '-f', format, '-ac', '1', '-']);
+    return ffmpegProcess;
+};
+exports.createAudioBuffer = function (filename, format) {
+    return new Promise(function (resolve, reject) {
+        var sampleRate;
+        var sampleRateRegExp = /(\d+) Hz/m;
+        var audioBuffers = [];
+        var ffmpegAudioReader = exports.spawnFfmpegAudioReader(filename, format);
+        ffmpegAudioReader.stderr.on('data', function (data) {
+            var match = data.toString().match(sampleRateRegExp);
+            if (!sampleRate && match) {
+                sampleRate = match[1];
+            }
+        });
+        ffmpegAudioReader.stdout.on('data', function (chunkBuffer) {
+            audioBuffers.push(chunkBuffer);
+        });
+        ffmpegAudioReader.stdout.on('end', function () {
+            var audioBuffer = Buffer.concat(audioBuffers);
+            resolve({ audioBuffer: audioBuffer, sampleRate: sampleRate });
+        });
+    });
+};
 //# sourceMappingURL=audio.js.map

package/dist/beats.d.ts

@@ -1,39 +1,39 @@
-export interface BeatInfo {
-    isBeat: boolean;
-    intensity: number;
-    energy: number;
-    threshold: number;
-}
-export interface BeatDetectorOptions {
-    /** Number of past frames to average for adaptive threshold (~1.5s by default) */
-    historySize?: number;
-    /** Energy must exceed average * this multiplier to trigger a beat */
-    thresholdMultiplier?: number;
-    /** How fast the beat intensity fades between beats (0-1, lower = faster fade) */
-    decayRate?: number;
-    /** Minimum frames between consecutive beats (~150ms by default) */
-    cooldownFrames?: number;
-    /** How many low-frequency spectrum bands contribute to energy (sub-bass + bass) */
-    bassEndIndex?: number;
-}
-export interface TempoEstimate {
-    bpm: number;
-    periodFrames: number;
-    phaseFrame: number;
-    /** Beat times in seconds from the start of the analyzed audio. */
-    beatsSec?: number[];
-}
-export declare const MIN_TEMPO_BPM = 70;
-export declare const MAX_TEMPO_BPM = 180;
-export declare const PREFERRED_TEMPO_BPM_MIN = 90;
-export declare const PREFERRED_TEMPO_BPM_MAX = 160;
-export declare const DEFAULT_BASS_END_INDEX = 8;
-/** Longest PCM window passed to music-tempo (seconds), taken from the start of the audio. */
-export declare const MAX_TEMPO_ANALYSIS_SECONDS = 90;
-export declare const frameBassEnergy: (spectrum: number[], bassEndIndex?: number) => number;
-export declare const createBeatDetector: (fps: number, options?: BeatDetectorOptions | undefined) => (spectrum: number[]) => BeatInfo;
-export declare const estimateTempo: (samples: ArrayLike<number>, sampleRate: number, fps: number) => TempoEstimate | null;
-export declare const shiftTempoPhase: (tempo: TempoEstimate, startFrame: number) => TempoEstimate;
-/** Beat-grid phase for a later audio window, using in-window beat times when available. */
-export declare const tempoForWindow: (tempo: TempoEstimate, startFrame: number, fps: number, windowFrames?: number | undefined, localOnsetFrames?: number[] | undefined) => TempoEstimate;
-export declare const beatGridFrameIndices: (tempo: Pick<TempoEstimate, "periodFrames" | "phaseFrame">, totalFrames: number, stride?: number) => number[];
+export interface BeatInfo {
+    isBeat: boolean;
+    intensity: number;
+    energy: number;
+    threshold: number;
+}
+export interface BeatDetectorOptions {
+    /** Number of past frames to average for adaptive threshold (~1.5s by default) */
+    historySize?: number;
+    /** Energy must exceed average * this multiplier to trigger a beat */
+    thresholdMultiplier?: number;
+    /** How fast the beat intensity fades between beats (0-1, lower = faster fade) */
+    decayRate?: number;
+    /** Minimum frames between consecutive beats (~150ms by default) */
+    cooldownFrames?: number;
+    /** How many low-frequency spectrum bands contribute to energy (sub-bass + bass) */
+    bassEndIndex?: number;
+}
+export interface TempoEstimate {
+    bpm: number;
+    periodFrames: number;
+    phaseFrame: number;
+    /** Beat times in seconds from the start of the analyzed audio. */
+    beatsSec?: number[];
+}
+export declare const MIN_TEMPO_BPM = 70;
+export declare const MAX_TEMPO_BPM = 180;
+export declare const PREFERRED_TEMPO_BPM_MIN = 90;
+export declare const PREFERRED_TEMPO_BPM_MAX = 160;
+export declare const DEFAULT_BASS_END_INDEX = 8;
+/** Longest PCM window passed to music-tempo (seconds), taken from the start of the audio. */
+export declare const MAX_TEMPO_ANALYSIS_SECONDS = 90;
+export declare const frameBassEnergy: (spectrum: number[], bassEndIndex?: number) => number;
+export declare const createBeatDetector: (fps: number, options?: BeatDetectorOptions | undefined) => (spectrum: number[]) => BeatInfo;
+export declare const estimateTempo: (samples: ArrayLike<number>, sampleRate: number, fps: number) => TempoEstimate | null;
+export declare const shiftTempoPhase: (tempo: TempoEstimate, startFrame: number) => TempoEstimate;
+/** Beat-grid phase for a later audio window, using in-window beat times when available. */
+export declare const tempoForWindow: (tempo: TempoEstimate, startFrame: number, fps: number, windowFrames?: number | undefined, localOnsetFrames?: number[] | undefined) => TempoEstimate;
+export declare const beatGridFrameIndices: (tempo: Pick<TempoEstimate, "periodFrames" | "phaseFrame">, totalFrames: number, stride?: number) => number[];