nodejs-audio-visualizer 5.0.0 → 5.2.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

@@ -11,8 +11,9 @@ const config = {
   },
   // 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 each beat so the background edits with the music; omit or false for one continuous play-through from the start.
+  //   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

package/dist/audio.d.ts

@@ -1,12 +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 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,121 +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.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/audio.js.map

@@ -1 +1 @@
-{"version":3,"file":"audio.js","sourceRoot":"","sources":["../src/audio.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"audio.js","sourceRoot":"","sources":["../src/audio.ts"],"names":[],"mappings":"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"}

package/dist/beats.d.ts

@@ -1,19 +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 declare const createBeatDetector: (fps: number, options?: BeatDetectorOptions | undefined) => (spectrum: number[]) => BeatInfo;
+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[];