nodejs-audio-visualizer 5.5.3 → 5.6.3

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,83 +1,84 @@
-# 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.
-  //   hookPath: 'media/hook.mp4', // Optional. Video played once before the 'path' video(s). Plays in full; with audio.autoHighlight, each highlight is chosen so the hook ends on a detected drop (the biggest jump in energy on a beat) and 'path' starts with it and plays for ~15s (the hook is added before the ~15s, not counted in it); the whole hook always plays (when the drop is closer to the track start than the hook's length, silence is added before the track), and if no drop fits, the hook plays before the loudest ~15s window instead. The hook's sound, if it has any, is mixed over the track, which fades in from silence to full volume while the hook plays. With several highlight videos, each one opens with the hook.
-  //   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).
-    enhanceFilters: true, // Optional. Denoise, sharpen and boost contrast/saturation of the output video (FFmpeg hqdn3d, unsharp, eq; Lanczos scaling). Default: false
-    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.
+  //   hookPath: 'media/hook.mp4', // Optional. Video played once before the 'path' video(s). Plays in full; with audio.autoHighlight, each highlight is chosen so the hook ends on a detected drop (the biggest jump in energy on a beat) and 'path' starts with it and plays for ~15s (the hook is added before the ~15s, not counted in it); the whole hook always plays (when the drop is closer to the track start than the hook's length, silence is added before the track), and if no drop fits, the hook plays before the loudest ~15s window instead. The hook's sound, if it has any, is mixed over the track, which fades in from silence to full volume while the hook plays. With several highlight videos, each one opens with the hook.
+  //   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).
+  //   cutZoom: true, // Optional. With autoEdit: starts each cut zoomed in (115%) and quickly zooms out to normal over about one-third of a beat (every 2 beats when there are no cuts). Can be combined with cameraShake (default false).
+  // },
+  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).
+    enhanceFilters: true, // Optional. Denoise, sharpen and boost contrast/saturation of the output video (FFmpeg hqdn3d, unsharp, eq; Lanczos scaling). Default: false
+    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[];