nodejs-audio-visualizer 3.0.0 → 4.1.0

package/dist/video.js

@@ -1,9 +1,19 @@
 "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 fs_1 = require("fs");
+var path_1 = require("path");
+var os_1 = require("os");
 var ffmpeg_static_1 = __importDefault(require("ffmpeg-static"));
 exports.spawnFfmpegVideoWriter = function (config) {
     if (!ffmpeg_static_1.default) {
@@ -27,6 +37,139 @@ exports.spawnFfmpegVideoWriter = function (config) {
     }
     return ffmpeg;
 };
+exports.detectSceneChanges = function (videoPath, threshold) {
+    if (threshold === void 0) { threshold = 0.4; }
+    return new Promise(function (resolve, reject) {
+        if (!ffmpeg_static_1.default) {
+            reject(new Error('ffmpeg path not found'));
+            return;
+        }
+        var ffmpeg = child_process_1.spawn(ffmpeg_static_1.default, [
+            '-i', videoPath,
+            '-filter:v', "select='gt(scene," + threshold + ")',showinfo",
+            '-f', 'null',
+            '-'
+        ]);
+        var stderr = '';
+        ffmpeg.stderr.on('data', function (data) { stderr += data.toString(); });
+        ffmpeg.on('close', function () {
+            var sceneChanges = [];
+            for (var _i = 0, _a = stderr.split('\n'); _i < _a.length; _i++) {
+                var line = _a[_i];
+                if (!line.includes('Parsed_showinfo'))
+                    continue;
+                var nMatch = line.match(/n:\s*(\d+)/);
+                var ptsMatch = line.match(/pts:\s*(\d+)/);
+                var ptsTimeMatch = line.match(/pts_time:\s*([\d.]+)/);
+                if (nMatch && ptsTimeMatch) {
+                    sceneChanges.push({
+                        frameNumber: parseInt(nMatch[1]),
+                        pts: ptsMatch ? parseInt(ptsMatch[1]) : 0,
+                        ptsTime: parseFloat(ptsTimeMatch[1]),
+                    });
+                }
+            }
+            resolve(sceneChanges);
+        });
+        ffmpeg.on('error', reject);
+    });
+};
+exports.getVideoInfo = function (videoPath) {
+    return new Promise(function (resolvePromise, reject) {
+        if (!ffmpeg_static_1.default) {
+            reject(new Error('ffmpeg path not found'));
+            return;
+        }
+        var ffmpeg = child_process_1.spawn(ffmpeg_static_1.default, ['-i', videoPath, '-hide_banner']);
+        var stderr = '';
+        ffmpeg.stderr.on('data', function (data) { stderr += data.toString(); });
+        ffmpeg.on('close', function () {
+            var dimMatch = stderr.match(/Stream.*Video:.*?(\d{2,5})x(\d{2,5})/);
+            if (!dimMatch) {
+                reject(new Error("Could not determine video dimensions for: " + videoPath));
+                return;
+            }
+            var durMatch = stderr.match(/Duration:\s*(\d+):(\d+):([\d.]+)/);
+            var duration = durMatch
+                ? parseInt(durMatch[1]) * 3600 + parseInt(durMatch[2]) * 60 + parseFloat(durMatch[3])
+                : 0;
+            resolvePromise({
+                width: parseInt(dimMatch[1]),
+                height: parseInt(dimMatch[2]),
+                duration: duration,
+            });
+        });
+    });
+};
+var isOrientationMismatch = function (sw, sh, tw, th) {
+    return (sw > sh && tw < th) || (sw < sh && tw > th);
+};
+exports.buildVideoFilter = function (sourceWidth, sourceHeight, targetWidth, targetHeight) {
+    if (!isOrientationMismatch(sourceWidth, sourceHeight, targetWidth, targetHeight)) {
+        return "scale=" + targetWidth + ":" + targetHeight;
+    }
+    var targetAspect = targetWidth / targetHeight;
+    var makeEven = function (n) { return Math.floor(n / 2) * 2; };
+    var cropW, cropH, cropX, cropY;
+    if (sourceWidth / sourceHeight > targetAspect) {
+        cropW = makeEven(Math.round(sourceHeight * targetAspect));
+        cropH = makeEven(sourceHeight);
+        cropX = Math.floor((sourceWidth - cropW) / 2);
+        cropY = Math.floor((sourceHeight - cropH) / 2);
+    }
+    else {
+        cropW = makeEven(sourceWidth);
+        cropH = makeEven(Math.round(sourceWidth / targetAspect));
+        cropX = Math.floor((sourceWidth - cropW) / 2);
+        cropY = Math.floor((sourceHeight - cropH) / 2);
+    }
+    return "crop=" + cropW + ":" + cropH + ":" + cropX + ":" + cropY + ",scale=" + targetWidth + ":" + targetHeight;
+};
+exports.spawnVideoFrameReader = function (config) {
+    if (!ffmpeg_static_1.default) {
+        throw new Error('ffmpeg path not found');
+    }
+    var args = [
+        '-stream_loop', '-1',
+        '-i', config.videoPath,
+        '-r', "" + config.fps,
+        '-frames:v', "" + config.totalFrames,
+    ];
+    if (config.width && config.height) {
+        var filter = config.sourceWidth && config.sourceHeight
+            ? exports.buildVideoFilter(config.sourceWidth, config.sourceHeight, config.width, config.height)
+            : "scale=" + config.width + ":" + config.height;
+        args.push('-vf', filter);
+    }
+    args.push('-f', 'rawvideo', '-pix_fmt', 'bgr24', '-v', 'quiet', 'pipe:1');
+    return child_process_1.spawn(ffmpeg_static_1.default, args);
+};
+exports.readVideoFrame = function (stream, frameSize) {
+    return new Promise(function (resolve) {
+        var tryRead = function () {
+            var data = stream.read(frameSize);
+            if (data !== null) {
+                resolve(data.length === frameSize ? data : null);
+                return;
+            }
+            var onReadable = function () {
+                cleanup();
+                tryRead();
+            };
+            var onEnd = function () {
+                cleanup();
+                resolve(null);
+            };
+            var cleanup = function () {
+                stream.removeListener('readable', onReadable);
+                stream.removeListener('end', onEnd);
+            };
+            stream.once('readable', onReadable);
+            stream.once('end', onEnd);
+        };
+        tryRead();
+    });
+};
 exports.getProgress = function (onProgress) {
     return function (stderrOutput) {
         var matchResult = stderrOutput.toString().match(/frame=[ ]+(\d+)/);
@@ -48,4 +191,105 @@ exports.calculateProgress = function (framesCount, callback) {
 exports.waitDrain = function (stream) {
     return new Promise(function (resolve) { return stream.once('drain', resolve); });
 };
+var mergeSmallScenes = function (sceneChanges, videoDuration, minDuration) {
+    if (minDuration === void 0) { minDuration = 2; }
+    if (sceneChanges.length === 0)
+        return [];
+    var merged = [sceneChanges[0]];
+    for (var i = 1; i < sceneChanges.length; i++) {
+        var lastKept = merged[merged.length - 1];
+        var gap = sceneChanges[i].ptsTime - lastKept.ptsTime;
+        if (gap >= minDuration) {
+            merged.push(sceneChanges[i]);
+        }
+    }
+    var lastScene = merged[merged.length - 1];
+    if (videoDuration - lastScene.ptsTime < minDuration && merged.length > 1) {
+        merged.pop();
+    }
+    return merged;
+};
+exports.buildBeatSyncedSegments = function (beatFrameIndices, totalFrames, sceneChanges, videoDuration) {
+    if (sceneChanges.length === 0) {
+        return [
+            {
+                outputStartFrame: 0,
+                videoSeekSeconds: 0,
+                frameCount: totalFrames,
+            },
+        ];
+    }
+    var consolidated = mergeSmallScenes(sceneChanges, videoDuration);
+    var seekPositions;
+    if (consolidated.length >= 2) {
+        seekPositions = consolidated.map(function (sc) { return sc.ptsTime; });
+    }
+    else {
+        var count_1 = Math.max(10, Math.ceil(videoDuration / 3));
+        seekPositions = Array.from({ length: count_1 }, function (_, i) { return (i * videoDuration) / count_1; });
+    }
+    var boundaries = __spreadArrays([0], beatFrameIndices);
+    if (boundaries[boundaries.length - 1] !== totalFrames) {
+        boundaries.push(totalFrames);
+    }
+    var unique = Array.from(new Set(boundaries)).sort(function (a, b) { return a - b; });
+    var segments = [];
+    for (var i = 0; i < unique.length - 1; i++) {
+        segments.push({
+            outputStartFrame: unique[i],
+            videoSeekSeconds: seekPositions[i % seekPositions.length],
+            frameCount: unique[i + 1] - unique[i],
+        });
+    }
+    return segments;
+};
+exports.writeConcatFile = function (segments, videoPath, videoDuration, fps) {
+    var absVideoPath = path_1.resolve(videoPath).replace(/\\/g, '/');
+    var escaped = absVideoPath.replace(/'/g, "'\\''");
+    var content = '';
+    for (var _i = 0, segments_1 = segments; _i < segments_1.length; _i++) {
+        var seg = segments_1[_i];
+        var segDuration = seg.frameCount / fps;
+        var remaining = segDuration;
+        var pos = seg.videoSeekSeconds % videoDuration;
+        while (remaining > 0.001) {
+            var available = videoDuration - pos;
+            var take = Math.min(remaining, available);
+            content += "file '" + escaped + "'\n";
+            content += "inpoint " + pos.toFixed(6) + "\n";
+            content += "outpoint " + (pos + take).toFixed(6) + "\n\n";
+            remaining -= take;
+            pos = 0;
+        }
+    }
+    var concatPath = path_1.join(os_1.tmpdir(), "av-concat-" + Date.now() + ".txt");
+    fs_1.writeFileSync(concatPath, content, 'utf-8');
+    return concatPath;
+};
+exports.spawnConcatVideoFrameReader = function (config) {
+    if (!ffmpeg_static_1.default) {
+        throw new Error('ffmpeg path not found');
+    }
+    var args = [
+        '-f', 'concat',
+        '-safe', '0',
+        '-i', config.concatFilePath,
+        '-r', "" + config.fps,
+        '-frames:v', "" + config.totalFrames,
+    ];
+    if (config.width && config.height) {
+        var filter = config.sourceWidth && config.sourceHeight
+            ? exports.buildVideoFilter(config.sourceWidth, config.sourceHeight, config.width, config.height)
+            : "scale=" + config.width + ":" + config.height;
+        args.push('-vf', filter);
+    }
+    args.push('-f', 'rawvideo', '-pix_fmt', 'bgr24', '-v', 'quiet', 'pipe:1');
+    return child_process_1.spawn(ffmpeg_static_1.default, args);
+};
+exports.cleanupConcatFile = function (filePath) {
+    try {
+        fs_1.unlinkSync(filePath);
+    }
+    catch (_a) { }
+};
 //# sourceMappingURL=video.js.map

package/dist/video.js.map

@@ -1 +1 @@
-{"version":3,"file":"video.js","sourceRoot":"","sources":["../src/video.ts"],"names":[],"mappings":";;;;;AACA,+CAAsC;AACtC,gEAAuC;AAW1B,QAAA,sBAAsB,GAAG,UAAC,MAA+B;IACpE,IAAI,CAAC,uBAAU,EAAE;QACf,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;KAC1C;IACD,IAAM,GAAG,GAAG,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC;IAC/B,IAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,QAAQ,CAAC;IACzC,IAAM,IAAI,GAAG;QACX,IAAI;QACJ,IAAI,EAAE,MAAM,CAAC,aAAa;QAC1B,MAAM,EAAE,GAAG;QACX,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS;QACtD,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,KAAG,MAAM,CAAC,GAAK,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,aAAa;QACxG,IAAI,EAAE,KAAG,MAAM,CAAC,GAAK;QACrB,IAAI,EAAE,GAAG;KACV,CAAC;IACF,IAAM,MAAM,GAAG,qBAAK,CAAC,uBAAU,EAAE,IAAI,CAAC,CAAC;IACvC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,MAAM,CAAC,QAAQ,EAAE;QACnB,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;KAC3C;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEW,QAAA,WAAW,GAAG,UAAC,UAAyC;IACnE,OAAA,UAAC,YAAoB;QACnB,IAAM,WAAW,GAAG,YAAY,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACrE,IAAI,CAAC,WAAW,EAAE;YAChB,OAAO;SACR;QACD,IAAM,YAAY,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QACrC,IAAI,KAAK,CAAC,YAAY,CAAC,EAAE;YACvB,OAAO;SACR;QACD,UAAU,CAAC,YAAY,CAAC,CAAC;IAC3B,CAAC;AAVD,CAUC,CAAC;AAES,QAAA,iBAAiB,GAAG,UAAC,WAAmB,EAAE,QAAmC;IACxF,OAAA,UAAC,YAAoB;QACnB,OAAA,QAAQ,CACN,CAAC,CAAC,YAAY,GAAG,WAAW,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAC/C;IAFD,CAEC;AAHH,CAGG,CAAC;AAEO,QAAA,SAAS,GAAG,UAAC,MAAgB;IACxC,OAAA,IAAI,OAAO,CAAO,UAAA,OAAO,IAAI,OAAA,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,EAA7B,CAA6B,CAAC;AAA3D,CAA2D,CAAC"}
+{"version":3,"file":"video.js","sourceRoot":"","sources":["../src/video.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nodejs-audio-visualizer",
-  "version": "3.0.0",
+  "version": "4.1.0",
   "description": "",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -20,7 +20,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/VladislavPetyukevich/audio-visualizer"
+    "url": "git+https://github.com/VladislavPetyukevich/audio-visualizer.git"
   },
   "homepage": "https://github.com/VladislavPetyukevich/audio-visualizer#readme",
   "keywords": [

package/src/beats.ts

@@ -0,0 +1,68 @@
+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 const createBeatDetector = (fps: number, options?: BeatDetectorOptions) => {
+  const historySize = options?.historySize ?? Math.round(fps * 1.5);
+  const thresholdMultiplier = options?.thresholdMultiplier ?? 1.4;
+  const decayRate = options?.decayRate ?? 0.85;
+  const cooldownFrames = options?.cooldownFrames ?? Math.round(fps * 0.15);
+  const bassEndIndex = options?.bassEndIndex ?? 8;
+
+  const energyHistory: number[] = [];
+  let framesSinceLastBeat = cooldownFrames;
+  let decayingIntensity = 0;
+
+  return (spectrum: number[]): BeatInfo => {
+    const bassSpectrum = spectrum.slice(0, Math.min(bassEndIndex, spectrum.length));
+    const energy = bassSpectrum.reduce((sum, val) => sum + val * val, 0) / bassSpectrum.length;
+
+    energyHistory.push(energy);
+    if (energyHistory.length > historySize) {
+      energyHistory.shift();
+    }
+
+    const avgEnergy = energyHistory.reduce((sum, e) => sum + e, 0) / energyHistory.length;
+    const variance = energyHistory.reduce((sum, e) => sum + (e - avgEnergy) ** 2, 0) / energyHistory.length;
+    const stdDev = Math.sqrt(variance);
+
+    const threshold = avgEnergy + stdDev * thresholdMultiplier;
+
+    framesSinceLastBeat++;
+
+    const hasEnoughHistory = energyHistory.length >= Math.round(historySize / 3);
+    const isAboveThreshold = energy > threshold && hasEnoughHistory;
+    const isCooldownOver = framesSinceLastBeat >= cooldownFrames;
+    const isBeat = isAboveThreshold && isCooldownOver;
+
+    if (isBeat) {
+      framesSinceLastBeat = 0;
+      decayingIntensity = Math.min(1, (energy - threshold) / (stdDev + 1e-6));
+    } else {
+      decayingIntensity *= decayRate;
+    }
+
+    return {
+      isBeat,
+      intensity: decayingIntensity,
+      energy,
+      threshold,
+    };
+  };
+};

package/src/bpmEncoder.ts

@@ -4,46 +4,42 @@ export interface EncodedBmp {
   data: Buffer;
 }
 
+const writeBmpHeader = (buffer: Buffer, width: number, height: number, rgbSize: number) => {
+  const headerInfoSize = 40;
+  const offset = 54;
+  const fileSize = rgbSize + offset;
+
+  let pos = 0;
+  buffer.write('BM', pos, 2); pos += 2;
+  buffer.writeUInt32LE(fileSize, pos); pos += 4;
+  buffer.writeUInt32LE(0, pos); pos += 4;
+  buffer.writeUInt32LE(offset, pos); pos += 4;
+
+  buffer.writeUInt32LE(headerInfoSize, pos); pos += 4;
+  buffer.writeUInt32LE(width, pos); pos += 4;
+  buffer.writeInt32LE(-height, pos); pos += 4;
+  buffer.writeUInt16LE(1, pos); pos += 2;
+  buffer.writeUInt16LE(24, pos); pos += 2;
+  buffer.writeUInt32LE(0, pos); pos += 4;
+  buffer.writeUInt32LE(rgbSize, pos); pos += 4;
+  buffer.writeUInt32LE(0, pos); pos += 4;
+  buffer.writeUInt32LE(0, pos); pos += 4;
+  buffer.writeUInt32LE(0, pos); pos += 4;
+  buffer.writeUInt32LE(0, pos); pos += 4;
+
+  return offset;
+};
+
 export const createBpmEncoder = (imgData: { width: number; height: number; }) => {
   const width = imgData.width;
   const height = imgData.height;
   const extraBytes = width % 4;
   const rgbSize = height * (3 * width + extraBytes);
-  const headerInfoSize = 40;
-
-  /******************header***********************/
-  const flag = 'BM';
-  const reserved = 0;
   const offset = 54;
-  const fileSize = rgbSize + offset;
-  const planes = 1;
-  const bitPP = 24;
-  const compress = 0;
-  const hr = 0;
-  const vr = 0;
-  const colors = 0;
-  const importantColors = 0;
 
   return (buffer: Buffer): EncodedBmp => {
     const tempBuffer = Buffer.alloc(offset + rgbSize);
-
-    let pos = 0;
-    tempBuffer.write(flag, pos, 2); pos += 2;
-    tempBuffer.writeUInt32LE(fileSize, pos); pos += 4;
-    tempBuffer.writeUInt32LE(reserved, pos); pos += 4;
-    tempBuffer.writeUInt32LE(offset, pos); pos += 4;
-
-    tempBuffer.writeUInt32LE(headerInfoSize, pos); pos += 4;
-    tempBuffer.writeUInt32LE(width, pos); pos += 4;
-    tempBuffer.writeInt32LE(-height, pos); pos += 4;
-    tempBuffer.writeUInt16LE(planes, pos); pos += 2;
-    tempBuffer.writeUInt16LE(bitPP, pos); pos += 2;
-    tempBuffer.writeUInt32LE(compress, pos); pos += 4;
-    tempBuffer.writeUInt32LE(rgbSize, pos); pos += 4;
-    tempBuffer.writeUInt32LE(hr, pos); pos += 4;
-    tempBuffer.writeUInt32LE(vr, pos); pos += 4;
-    tempBuffer.writeUInt32LE(colors, pos); pos += 4;
-    tempBuffer.writeUInt32LE(importantColors, pos); pos += 4;
+    const pos = writeBmpHeader(tempBuffer, width, height, rgbSize);
 
     let i = 0;
     const rowBytes = 3 * width + extraBytes;
@@ -69,3 +65,33 @@ export const createBpmEncoder = (imgData: { width: number; height: number; }) =>
     };
   };
 };
+
+export const createBgrFrameEncoder = (imgData: { width: number; height: number }) => {
+  const width = imgData.width;
+  const height = imgData.height;
+  const extraBytes = width % 4;
+  const rowBytes = 3 * width + extraBytes;
+  const rgbSize = height * rowBytes;
+  const offset = 54;
+
+  const tempBuffer = Buffer.alloc(offset + rgbSize);
+  const pos = writeBmpHeader(tempBuffer, width, height, rgbSize);
+
+  return (bgrBuffer: Buffer): EncodedBmp => {
+    if (extraBytes === 0) {
+      bgrBuffer.copy(tempBuffer, pos, 0, width * height * 3);
+    } else {
+      for (let y = 0; y < height; y++) {
+        const srcOffset = y * width * 3;
+        const dstOffset = pos + y * rowBytes;
+        bgrBuffer.copy(tempBuffer, dstOffset, srcOffset, srcOffset + width * 3);
+      }
+    }
+
+    return {
+      shiftPos: pos,
+      rowBytes,
+      data: tempBuffer
+    };
+  };
+};

package/src/config.ts

@@ -11,6 +11,11 @@ export const defaults = {
   spectrumRotation: 'mirror',
   spectrumBusMargin: 12,
   spectrumOpacity: '80%',
+  polarX: 'center',
+  polarY: 'middle',
+  polarInnerRadius: 100,
+  polarMaxBarLength: 160,
+  polarBarWidth: 15,
 };
 
 type RelativePositionValue = 0 | 0.5 | 1;
@@ -40,7 +45,13 @@ export const getAudioFilePath = (config: Config) =>
   path.resolve(config.audio.path);
 
 export const getBackgroundImagePath = (config: Config) =>
-  path.resolve(config.image.path);
+  config.image ? path.resolve(config.image.path) : undefined;
+
+export const getBackgroundVideoPath = (config: Config) =>
+  config.video ? path.resolve(config.video.path) : undefined;
+
+export const getAutoEditVideo = (config: Config) =>
+  config.video?.autoEdit === true;
 
 export const getOutVideoPath = (config: Config) =>
   path.resolve(config.outVideo.path);
@@ -48,6 +59,9 @@ export const getOutVideoPath = (config: Config) =>
 export const getFPS = (config: Config) =>
   config.outVideo.fps || defaults.fps;
 
+export const getOutputResolution = (config: Config) =>
+  config.outVideo.resolution;
+
 export const getSpectrumBusMargin = () => defaults.spectrumBusMargin;
 
 const getSpectrumWidth = (config: Config) =>
@@ -243,3 +257,105 @@ export const getFfmpeg_preset = (config: Config) =>
 export const getFrame_processing_delay = (config: Config) =>
   config.tweaks && config.tweaks.frame_processing_delay;
 
+// Polar visualizer config getters
+const getPolarX = (config: Config) =>
+  parseNumberIfPossible(
+    (config.outVideo.polar && config.outVideo.polar.x) ||
+    defaults.polarX
+  );
+
+const getPolarY = (config: Config) =>
+  parseNumberIfPossible(
+    (config.outVideo.polar && config.outVideo.polar.y) ||
+    defaults.polarY
+  );
+
+export const getPolarXAbsolute = (
+  config: Config,
+  backgroundImageWidth: number
+) => {
+  const polarX = getPolarX(config);
+  if (typeof polarX !== 'string') {
+    return polarX;
+  }
+  try {
+    const polarXParsed = parsePositionAlias(polarX);
+    if (polarXParsed.value === 0) {
+      const polarLength = getPolarMaxBarLength(config);
+      const polarRadius = getPolarInnerRadius(config);
+      return polarRadius + polarLength;
+    }
+    if (polarXParsed.value === 1) {
+      const polarLength = getPolarMaxBarLength(config);
+      const polarRadius = getPolarInnerRadius(config);
+      return backgroundImageWidth - polarRadius - polarLength;
+    }
+    return polarXParsed.value * backgroundImageWidth;
+  } catch {
+    throw new Error(`Invalid polar x value: ${polarX}. Valid values: ${getValidPositionAliasValues()}.`);
+  }
+};
+
+export const getPolarYAbsolute = (
+  config: Config,
+  backgroundImageHeight: number
+) => {
+  const polarY = getPolarY(config);
+  if (typeof polarY !== 'string') {
+    return polarY;
+  }
+  try {
+    const polarYParsed = parsePositionAlias(polarY);
+    if (polarYParsed.value === 0) {
+      const polarLength = getPolarMaxBarLength(config);
+      const polarRadius = getPolarInnerRadius(config);
+      return polarRadius + polarLength;
+    }
+    if (polarYParsed.value === 1) {
+      const polarLength = getPolarMaxBarLength(config);
+      const polarRadius = getPolarInnerRadius(config);
+      return backgroundImageHeight - polarRadius - polarLength;
+    }
+    return polarYParsed.value * backgroundImageHeight;
+  } catch {
+    throw new Error(`Invalid polar y value: ${polarY}. Valid values: ${getValidPositionAliasValues()}.`);
+  }
+};
+
+export const getPolarInnerRadius = (config: Config) =>
+  (config.outVideo.polar && config.outVideo.polar.innerRadius) ||
+  defaults.polarInnerRadius;
+
+export const getPolarMaxBarLength = (config: Config) =>
+  (config.outVideo.polar && config.outVideo.polar.maxBarLength) ||
+  defaults.polarMaxBarLength;
+
+export const getPolarBarWidth = (config: Config) =>
+  (config.outVideo.polar && config.outVideo.polar.barWidth) ||
+  defaults.polarBarWidth;
+
+export const getPolarEffect = (config: Config) =>
+  config.outVideo.polar?.effect;
+
+export const getPolarColor = (config: Config) =>
+  config.outVideo.polar && config.outVideo.polar.color;
+
+export const getPolarOpacity = (config: Config) =>
+  (config.outVideo.polar && config.outVideo.polar.opacity) ||
+  defaults.spectrumOpacity;
+
+export const getPolarOpacityParsed = (config: Config) => {
+  const polarOpacity = getPolarOpacity(config);
+  if (!checkIsPercentValue(polarOpacity)) {
+    throw new Error(`Invalid polar opacity value: '${polarOpacity}'. Use string percent value, for example '80%'.`);
+  }
+  const percentValue = parseInt(polarOpacity);
+  if (
+    (percentValue < 0) ||
+    (percentValue > 100)
+  ) {
+    throw new Error(`Invalid polar opacity value: '${polarOpacity}'. Percent values must be in range from '0%' to '100%'.`);
+  }
+  return percentValue / 100;
+};
+