nodejs-audio-visualizer 4.4.12 → 4.5.1

package/src/config.ts

@@ -1,462 +1,476 @@
-import path from 'path';
-import { Config, SpectrumSizeValue, PositionAliasName, RotationAliasName } from './index';
-import { FREQUENCY_BANDS } from './dsp';
-
-export const defaults = {
-  fps: 30,
-  spectrumWidth: '33%',
-  spectrumHeight: 160,
-  spectrumX: 'center',
-  spectrumY: 'middle',
-  spectrumRotation: 'mirror',
-  spectrumBusMargin: 12,
-  spectrumOpacity: '80%',
-  polarX: 'center',
-  polarY: 'middle',
-  polarInnerRadius: 100,
-  polarMaxBarLength: 160,
-  polarBarWidth: 15,
-};
-
-type RelativePositionValue = 0 | 0.5 | 1;
-
-export type SpectrumEffect = 'volume' | 'smooth';
-
-interface PositionAlias {
-  name: PositionAliasName;
-  value: RelativePositionValue;
-}
-
-const postitionAliases: PositionAlias[] = [
-  { name: 'left', value: 0 },
-  { name: 'center', value: 0.5 },
-  { name: 'right', value: 1 },
-  { name: 'top', value: 0 },
-  { name: 'middle', value: 0.5 },
-  { name: 'bottom', value: 1 },
-];
-
-export const rotationAliasValues = ['up', 'down', 'mirror'] as const;
-
-export const checkIsPercentValue = (value: string) =>
-  RegExp(/\d+%/).test(value)
-
-export const getAudioFilePath = (config: Config) =>
-  path.resolve(config.audio.path);
-
-export const getAudioAutoHighlight = (config: Config) =>
-  config.audio.autoHighlight === true;
-
-export const getAudioAutoHighlightCount = (config: Config): number => {
-  const raw = config.audio.autoHighlightCount;
-  if (raw === undefined) {
-    return 1;
-  }
-  if (
-    typeof raw !== 'number' ||
-    !Number.isFinite(raw) ||
-    !Number.isInteger(raw) ||
-    raw < 1
-  ) {
-    throw new Error(
-      `Invalid audio.autoHighlightCount: expected a finite integer >= 1, got '${String(raw)}'.`,
-    );
-  }
-  return raw;
-};
-
-export const getBackgroundImagePath = (config: Config) =>
-  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);
-
-export type SubtitleAlignment = 'top' | 'middle' | 'bottom';
-
-export type SubtitleRenderSpec = {
-  source: { kind: 'file'; path: string } | { kind: 'inline'; text: string };
-  alignment: SubtitleAlignment;
-};
-
-export const subtitleAlignmentToAss = (alignment: SubtitleAlignment): number => {
-  switch (alignment) {
-    case 'top':
-      return 6;
-    case 'middle':
-      return 10;
-    case 'bottom':
-      return 2;
-  }
-};
-
-const parseSubtitleAlignment = (raw: unknown): SubtitleAlignment => {
-  if (raw === undefined) {
-    return 'bottom';
-  }
-  if (raw === 'top' || raw === 'middle' || raw === 'bottom') {
-    return raw;
-  }
-  throw new Error(
-    `Invalid outVideo.subtitles.alignment: expected 'top', 'middle', or 'bottom', got '${String(raw)}'.`,
-  );
-};
-
-export const getSubtitleRenderSpec = (config: Config): SubtitleRenderSpec | undefined => {
-  const subtitles = config.outVideo.subtitles;
-  if (subtitles === undefined || subtitles === null) {
-    return undefined;
-  }
-  if (typeof subtitles === 'string') {
-    if (subtitles.trim().length === 0) {
-      throw new Error(
-        `Invalid outVideo.subtitles: expected non-empty string content, got '${String(subtitles)}'.`,
-      );
-    }
-    return {
-      source: { kind: 'inline', text: subtitles },
-      alignment: 'bottom',
-    };
-  }
-  if (typeof subtitles !== 'object' || Array.isArray(subtitles)) {
-    throw new Error(
-      `Invalid outVideo.subtitles: expected string or object, got '${String(subtitles)}'.`,
-    );
-  }
-  const obj = subtitles as {
-    path?: string;
-    rawContent?: string;
-    alignment?: unknown;
-  };
-  const alignment = parseSubtitleAlignment(obj.alignment);
-  const pathRaw = obj.path !== undefined ? String(obj.path).trim() : '';
-  const rawContent =
-    obj.rawContent !== undefined ? String(obj.rawContent).trim() : '';
-  if (pathRaw.length > 0 && rawContent.length > 0) {
-    throw new Error(
-      'Invalid outVideo.subtitles: specify only one of "path" or "rawContent", not both.',
-    );
-  }
-  if (pathRaw.length === 0 && rawContent.length === 0) {
-    return undefined;
-  }
-  if (pathRaw.length > 0) {
-    return {
-      source: { kind: 'file', path: path.resolve(pathRaw) },
-      alignment,
-    };
-  }
-  return {
-    source: { kind: 'inline', text: rawContent },
-    alignment,
-  };
-};
-
-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) =>
-  (config.outVideo.spectrum && config.outVideo.spectrum.width) ||
-  defaults.spectrumWidth;
-
-export const getSpectrumEffect = (config: Config) =>
-  config.outVideo.spectrum?.effect;
-
-const getSpectrumSizeAbsolute = (
-  spectrumSize: SpectrumSizeValue,
-  backgroundImageSize: number,
-  fieldName: string
-) => {
-  if (typeof spectrumSize === 'number') {
-    return spectrumSize;
-  }
-  const isPercentValue = checkIsPercentValue(spectrumSize);
-  if (!isPercentValue) {
-    throw new Error(getSpectrumSizeValueErrorMessage(fieldName, spectrumSize));
-  }
-  const percentValue = parseInt(spectrumSize) / 100;
-  return backgroundImageSize * percentValue;
-};
-
-const getSpectrumSizeValueErrorMessage = (
-  fieldName: string, value: SpectrumSizeValue
-) =>
-  `Invalid spectrum ${fieldName} value: '${value}'. Use number value or percent value in string, for example: '30%'.`
-
-export const getSpectrumWidthAbsolute = (
-  config: Config, backgroundImageWidth: number
-) => {
-  const spectrumWidth = getSpectrumWidth(config);
-  const spectrumWidthAbsolute = getSpectrumSizeAbsolute(spectrumWidth, backgroundImageWidth, 'width');
-  const spectrumWidthWithoutMargin =
-    Math.trunc(spectrumWidthAbsolute / FREQUENCY_BANDS.length) - defaults.spectrumBusMargin / 2;
-  if (spectrumWidthWithoutMargin <= 0) {
-    throw new Error(`Spectrum width '${spectrumWidth}' is too small.`);
-  }
-  return spectrumWidthAbsolute;
-};
-
-const getSpectrumHeight = (config: Config) =>
-  (config.outVideo.spectrum && config.outVideo.spectrum.height) ||
-  defaults.spectrumHeight;
-
-export const getSpectrumHeightAbsolute = (
-  config: Config, backgroundImageHeight: number
-) => {
-  const spectrumHeight = getSpectrumHeight(config);
-  return getSpectrumSizeAbsolute(spectrumHeight, backgroundImageHeight, 'height');
-};
-
-const getSpectrumX = (config: Config) =>
-  parseNumberIfPossible(
-    (config.outVideo.spectrum && config.outVideo.spectrum.x) ||
-    defaults.spectrumX
-  );
-
-const getSpectrumY = (config: Config) =>
-  parseNumberIfPossible(
-    (config.outVideo.spectrum && config.outVideo.spectrum.y) ||
-    defaults.spectrumY
-  );
-
-const parseNumberIfPossible = (value: string | number) => {
-  const parsed = Number(value);
-  if (isNaN(parsed)) {
-    return value;
-  }
-  return parsed;
-};
-
-const parsePositionAlias = (aliasName: string): PositionAlias => {
-  const nameNormalized = aliasName.trim().toLowerCase();
-  const alias = postitionAliases.find(
-    als => als.name === nameNormalized
-  );
-  if (!alias) {
-    throw new Error();
-  }
-  return alias;
-};
-
-const getValidPositionAliasValues = () =>
-  postitionAliases.map(aliasEl => aliasEl.name).join(', ');
-
-const getSpectrumAbsolutePosition = (
-  relativePosition: RelativePositionValue,
-  spectrumSize: number,
-  backgroundImageSize: number
-) => {
-  switch (relativePosition) {
-    case 0:
-      return 0;
-    case 0.5:
-      return relativePosition * backgroundImageSize - spectrumSize / 2;
-    case 1:
-      return relativePosition * backgroundImageSize - spectrumSize;
-    default:
-      throw new Error();
-  }
-};
-
-export const getSpectrumXAbsolute = (
-  config: Config,
-  spectrumWidth: number,
-  backgroundImageWidth: number
-) => {
-  const spectrumX = getSpectrumX(config);
-  if (typeof spectrumX !== 'string') {
-    return spectrumX;
-  }
-  try {
-    const spectrumXParsed = parsePositionAlias(spectrumX);
-    return getSpectrumAbsolutePosition(
-      spectrumXParsed.value,
-      spectrumWidth,
-      backgroundImageWidth
-    );
-  } catch {
-    throw new Error(`Invalid spectrum x value: ${spectrumX}. Valid values: ${getValidPositionAliasValues()}.`);
-  }
-};
-
-export const getSpectrumYAbsolute = (
-  config: Config,
-  spectrumHeight: number,
-  backgroundImageHeight: number
-) => {
-  const spectrumY = getSpectrumY(config);
-  if (typeof spectrumY !== 'string') {
-    return spectrumY;
-  }
-  try {
-    const spectrumXParsed = parsePositionAlias(spectrumY);
-    return getSpectrumAbsolutePosition(
-      spectrumXParsed.value,
-      spectrumHeight,
-      backgroundImageHeight
-    );
-  } catch {
-    throw new Error(`Invalid spectrum y value: ${spectrumY}. Valid values: ${getValidPositionAliasValues()}.`);
-  }
-};
-
-const getValidRotationAliasValues = () =>
-  rotationAliasValues.join(', ');
-
-export const checkIsValidRotationAlias = (aliasName: string) => {
-  return !!rotationAliasValues.find(al => al === aliasName);
-};
-
-export const getSpectrumRotation = (config: Config): RotationAliasName => {
-  const rotationValue =
-    (config.outVideo.spectrum && config.outVideo.spectrum.rotation) ||
-    defaults.spectrumRotation;
-  if (!checkIsValidRotationAlias(rotationValue)) {
-    throw new Error(`Invalid spectrum rotation value: ${rotationValue}. Valid values: ${getValidRotationAliasValues}.`);
-  }
-  return rotationValue as RotationAliasName;
-};
-
-export const getSpectrumColor = (config: Config) =>
-  config.outVideo.spectrum && config.outVideo.spectrum.color;
-
-export const getSpectrumOpacity = (config: Config) =>
-  (config.outVideo.spectrum && config.outVideo.spectrum.opacity) ||
-  defaults.spectrumOpacity;
-
-export const getSpectrumOpacityParsed = (config: Config) => {
-  const spectrumOpacity = getSpectrumOpacity(config);
-  if (!checkIsPercentValue(spectrumOpacity)) {
-    throw new Error(`Invalid spectrum opacity value: '${spectrumOpacity}'. Use string percent value, for example '80%'.`);
-  }
-  const percentValue = parseInt(spectrumOpacity);
-  if (
-    (percentValue < 0) ||
-    (percentValue > 100)
-  ) {
-    throw new Error(`Invalid spectrum opacity value: '${spectrumOpacity}'. Percent values must be in range from '0%' to '100%'.`);
-  }
-  return percentValue / 100;
-};
-
-export const getFfmpeg_cfr = (config: Config) =>
-  config.tweaks && config.tweaks.ffmpeg_cfr;
-
-export const getFfmpeg_preset = (config: Config) =>
-  config.tweaks && config.tweaks.ffmpeg_preset;
-
-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;
-};
-
+import path from 'path';
+import { Config, SpectrumSizeValue, PositionAliasName, RotationAliasName } from './index';
+import { FREQUENCY_BANDS } from './dsp';
+
+export const defaults = {
+  fps: 30,
+  spectrumWidth: '33%',
+  spectrumHeight: 160,
+  spectrumX: 'center',
+  spectrumY: 'middle',
+  spectrumRotation: 'mirror',
+  spectrumBusMargin: 12,
+  spectrumOpacity: '80%',
+  polarX: 'center',
+  polarY: 'middle',
+  polarInnerRadius: 100,
+  polarMaxBarLength: 160,
+  polarBarWidth: 15,
+  timeouts: {
+    readVideoFrame: 30 * 1000,
+    waitDrain: 120 * 1000,
+    waitForProcessExit: 480 * 1000,
+  },
+};
+
+type RelativePositionValue = 0 | 0.5 | 1;
+
+export type SpectrumEffect = 'volume' | 'smooth';
+
+interface PositionAlias {
+  name: PositionAliasName;
+  value: RelativePositionValue;
+}
+
+const postitionAliases: PositionAlias[] = [
+  { name: 'left', value: 0 },
+  { name: 'center', value: 0.5 },
+  { name: 'right', value: 1 },
+  { name: 'top', value: 0 },
+  { name: 'middle', value: 0.5 },
+  { name: 'bottom', value: 1 },
+];
+
+export const rotationAliasValues = ['up', 'down', 'mirror'] as const;
+
+export const checkIsPercentValue = (value: string) =>
+  RegExp(/\d+%/).test(value)
+
+export const getAudioFilePath = (config: Config) =>
+  path.resolve(config.audio.path);
+
+export const getAudioAutoHighlight = (config: Config) =>
+  config.audio.autoHighlight === true;
+
+export const getAudioAutoHighlightCount = (config: Config): number => {
+  const raw = config.audio.autoHighlightCount;
+  if (raw === undefined) {
+    return 1;
+  }
+  if (
+    typeof raw !== 'number' ||
+    !Number.isFinite(raw) ||
+    !Number.isInteger(raw) ||
+    raw < 1
+  ) {
+    throw new Error(
+      `Invalid audio.autoHighlightCount: expected a finite integer >= 1, got '${String(raw)}'.`,
+    );
+  }
+  return raw;
+};
+
+export const getBackgroundImagePath = (config: Config) =>
+  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);
+
+export type SubtitleAlignment = 'top' | 'middle' | 'bottom';
+
+export type SubtitleRenderSpec = {
+  source: { kind: 'file'; path: string } | { kind: 'inline'; text: string };
+  alignment: SubtitleAlignment;
+};
+
+export const subtitleAlignmentToAss = (alignment: SubtitleAlignment): number => {
+  switch (alignment) {
+    case 'top':
+      return 6;
+    case 'middle':
+      return 10;
+    case 'bottom':
+      return 2;
+  }
+};
+
+const parseSubtitleAlignment = (raw: unknown): SubtitleAlignment => {
+  if (raw === undefined) {
+    return 'bottom';
+  }
+  if (raw === 'top' || raw === 'middle' || raw === 'bottom') {
+    return raw;
+  }
+  throw new Error(
+    `Invalid outVideo.subtitles.alignment: expected 'top', 'middle', or 'bottom', got '${String(raw)}'.`,
+  );
+};
+
+export const getSubtitleRenderSpec = (config: Config): SubtitleRenderSpec | undefined => {
+  const subtitles = config.outVideo.subtitles;
+  if (subtitles === undefined || subtitles === null) {
+    return undefined;
+  }
+  if (typeof subtitles === 'string') {
+    if (subtitles.trim().length === 0) {
+      throw new Error(
+        `Invalid outVideo.subtitles: expected non-empty string content, got '${String(subtitles)}'.`,
+      );
+    }
+    return {
+      source: { kind: 'inline', text: subtitles },
+      alignment: 'bottom',
+    };
+  }
+  if (typeof subtitles !== 'object' || Array.isArray(subtitles)) {
+    throw new Error(
+      `Invalid outVideo.subtitles: expected string or object, got '${String(subtitles)}'.`,
+    );
+  }
+  const obj = subtitles as {
+    path?: string;
+    rawContent?: string;
+    alignment?: unknown;
+  };
+  const alignment = parseSubtitleAlignment(obj.alignment);
+  const pathRaw = obj.path !== undefined ? String(obj.path).trim() : '';
+  const rawContent =
+    obj.rawContent !== undefined ? String(obj.rawContent).trim() : '';
+  if (pathRaw.length > 0 && rawContent.length > 0) {
+    throw new Error(
+      'Invalid outVideo.subtitles: specify only one of "path" or "rawContent", not both.',
+    );
+  }
+  if (pathRaw.length === 0 && rawContent.length === 0) {
+    return undefined;
+  }
+  if (pathRaw.length > 0) {
+    return {
+      source: { kind: 'file', path: path.resolve(pathRaw) },
+      alignment,
+    };
+  }
+  return {
+    source: { kind: 'inline', text: rawContent },
+    alignment,
+  };
+};
+
+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) =>
+  (config.outVideo.spectrum && config.outVideo.spectrum.width) ||
+  defaults.spectrumWidth;
+
+export const getSpectrumEffect = (config: Config) =>
+  config.outVideo.spectrum?.effect;
+
+const getSpectrumSizeAbsolute = (
+  spectrumSize: SpectrumSizeValue,
+  backgroundImageSize: number,
+  fieldName: string
+) => {
+  if (typeof spectrumSize === 'number') {
+    return spectrumSize;
+  }
+  const isPercentValue = checkIsPercentValue(spectrumSize);
+  if (!isPercentValue) {
+    throw new Error(getSpectrumSizeValueErrorMessage(fieldName, spectrumSize));
+  }
+  const percentValue = parseInt(spectrumSize) / 100;
+  return backgroundImageSize * percentValue;
+};
+
+const getSpectrumSizeValueErrorMessage = (
+  fieldName: string, value: SpectrumSizeValue
+) =>
+  `Invalid spectrum ${fieldName} value: '${value}'. Use number value or percent value in string, for example: '30%'.`
+
+export const getSpectrumWidthAbsolute = (
+  config: Config, backgroundImageWidth: number
+) => {
+  const spectrumWidth = getSpectrumWidth(config);
+  const spectrumWidthAbsolute = getSpectrumSizeAbsolute(spectrumWidth, backgroundImageWidth, 'width');
+  const spectrumWidthWithoutMargin =
+    Math.trunc(spectrumWidthAbsolute / FREQUENCY_BANDS.length) - defaults.spectrumBusMargin / 2;
+  if (spectrumWidthWithoutMargin <= 0) {
+    throw new Error(`Spectrum width '${spectrumWidth}' is too small.`);
+  }
+  return spectrumWidthAbsolute;
+};
+
+const getSpectrumHeight = (config: Config) =>
+  (config.outVideo.spectrum && config.outVideo.spectrum.height) ||
+  defaults.spectrumHeight;
+
+export const getSpectrumHeightAbsolute = (
+  config: Config, backgroundImageHeight: number
+) => {
+  const spectrumHeight = getSpectrumHeight(config);
+  return getSpectrumSizeAbsolute(spectrumHeight, backgroundImageHeight, 'height');
+};
+
+const getSpectrumX = (config: Config) =>
+  parseNumberIfPossible(
+    (config.outVideo.spectrum && config.outVideo.spectrum.x) ||
+    defaults.spectrumX
+  );
+
+const getSpectrumY = (config: Config) =>
+  parseNumberIfPossible(
+    (config.outVideo.spectrum && config.outVideo.spectrum.y) ||
+    defaults.spectrumY
+  );
+
+const parseNumberIfPossible = (value: string | number) => {
+  const parsed = Number(value);
+  if (isNaN(parsed)) {
+    return value;
+  }
+  return parsed;
+};
+
+const parsePositionAlias = (aliasName: string): PositionAlias => {
+  const nameNormalized = aliasName.trim().toLowerCase();
+  const alias = postitionAliases.find(
+    als => als.name === nameNormalized
+  );
+  if (!alias) {
+    throw new Error();
+  }
+  return alias;
+};
+
+const getValidPositionAliasValues = () =>
+  postitionAliases.map(aliasEl => aliasEl.name).join(', ');
+
+const getSpectrumAbsolutePosition = (
+  relativePosition: RelativePositionValue,
+  spectrumSize: number,
+  backgroundImageSize: number
+) => {
+  switch (relativePosition) {
+    case 0:
+      return 0;
+    case 0.5:
+      return relativePosition * backgroundImageSize - spectrumSize / 2;
+    case 1:
+      return relativePosition * backgroundImageSize - spectrumSize;
+    default:
+      throw new Error();
+  }
+};
+
+export const getSpectrumXAbsolute = (
+  config: Config,
+  spectrumWidth: number,
+  backgroundImageWidth: number
+) => {
+  const spectrumX = getSpectrumX(config);
+  if (typeof spectrumX !== 'string') {
+    return spectrumX;
+  }
+  try {
+    const spectrumXParsed = parsePositionAlias(spectrumX);
+    return getSpectrumAbsolutePosition(
+      spectrumXParsed.value,
+      spectrumWidth,
+      backgroundImageWidth
+    );
+  } catch {
+    throw new Error(`Invalid spectrum x value: ${spectrumX}. Valid values: ${getValidPositionAliasValues()}.`);
+  }
+};
+
+export const getSpectrumYAbsolute = (
+  config: Config,
+  spectrumHeight: number,
+  backgroundImageHeight: number
+) => {
+  const spectrumY = getSpectrumY(config);
+  if (typeof spectrumY !== 'string') {
+    return spectrumY;
+  }
+  try {
+    const spectrumXParsed = parsePositionAlias(spectrumY);
+    return getSpectrumAbsolutePosition(
+      spectrumXParsed.value,
+      spectrumHeight,
+      backgroundImageHeight
+    );
+  } catch {
+    throw new Error(`Invalid spectrum y value: ${spectrumY}. Valid values: ${getValidPositionAliasValues()}.`);
+  }
+};
+
+const getValidRotationAliasValues = () =>
+  rotationAliasValues.join(', ');
+
+export const checkIsValidRotationAlias = (aliasName: string) => {
+  return !!rotationAliasValues.find(al => al === aliasName);
+};
+
+export const getSpectrumRotation = (config: Config): RotationAliasName => {
+  const rotationValue =
+    (config.outVideo.spectrum && config.outVideo.spectrum.rotation) ||
+    defaults.spectrumRotation;
+  if (!checkIsValidRotationAlias(rotationValue)) {
+    throw new Error(`Invalid spectrum rotation value: ${rotationValue}. Valid values: ${getValidRotationAliasValues}.`);
+  }
+  return rotationValue as RotationAliasName;
+};
+
+export const getSpectrumColor = (config: Config) =>
+  config.outVideo.spectrum && config.outVideo.spectrum.color;
+
+export const getSpectrumOpacity = (config: Config) =>
+  (config.outVideo.spectrum && config.outVideo.spectrum.opacity) ||
+  defaults.spectrumOpacity;
+
+export const getSpectrumOpacityParsed = (config: Config) => {
+  const spectrumOpacity = getSpectrumOpacity(config);
+  if (!checkIsPercentValue(spectrumOpacity)) {
+    throw new Error(`Invalid spectrum opacity value: '${spectrumOpacity}'. Use string percent value, for example '80%'.`);
+  }
+  const percentValue = parseInt(spectrumOpacity);
+  if (
+    (percentValue < 0) ||
+    (percentValue > 100)
+  ) {
+    throw new Error(`Invalid spectrum opacity value: '${spectrumOpacity}'. Percent values must be in range from '0%' to '100%'.`);
+  }
+  return percentValue / 100;
+};
+
+export const getFfmpeg_cfr = (config: Config) =>
+  config.tweaks && config.tweaks.ffmpeg_cfr;
+
+export const getFfmpeg_preset = (config: Config) =>
+  config.tweaks && config.tweaks.ffmpeg_preset;
+
+export const getFrame_processing_delay = (config: Config) =>
+  config.tweaks && config.tweaks.frame_processing_delay;
+
+export const getVideoTimeouts = (config: Config) => ({
+  readVideoFrame:
+    config.tweaks?.timeouts?.readVideoFrame ?? defaults.timeouts.readVideoFrame,
+  waitDrain:
+    config.tweaks?.timeouts?.waitDrain ?? defaults.timeouts.waitDrain,
+  waitForProcessExit:
+    config.tweaks?.timeouts?.waitForProcessExit ?? defaults.timeouts.waitForProcessExit,
+});
+
+// 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;
+};
+