@lee-jisoo/n8n-nodes-mediafx 1.6.1 → 1.6.3

package/CHANGELOG.md

@@ -0,0 +1,65 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.6.0] - 2025-01-25
+
+### Added
+- **Speed operation**: Adjust video playback speed (slow motion or fast forward)
+  - Support speed range from 0.25x to 4x
+  - Option to adjust audio speed along with video
+  - Option to maintain original audio pitch when changing speed
+  - Output format selection (MP4, MOV, AVI, MKV)
+
+### Fixed
+- **addSubtitle operation**: Fixed subtitle display issue with slideshow/image-sequence videos
+  - Changed from `drawtext` filter chain to `subtitles` filter
+  - The `drawtext` filter's `enable='between(t,X,Y)'` condition was unreliable with image-sequence videos
+  - Now uses FFmpeg's native SRT parsing which handles timing correctly
+  - Added ASS/SSA style support for better subtitle formatting
+
+## [1.5.0] - 2025-01-20
+
+### Added
+- **Overlay Video operation**: Overlay a video on top of another video as a layer
+
+## [1.4.0] - 2025-01-13
+
+### Added
+- **Customizable output field names**: Users can now specify custom binary output field names for all media operations
+  - Added "Output Field Name" option to Video, Audio, Image, and Text/Subtitle resources
+  - Default field name remains "data" for backward compatibility
+  - Allows better organization when chaining multiple MediaFX nodes in workflows
+
+### Fixed
+- **Merge node compatibility**: Improved binary data handling when using n8n's Merge node
+  - Automatically detects binary properties in merged items (data1, data2, etc.)
+  - Searches both current item and first item for binary data
+  - Enhanced error messages with available properties list
+- **Video transition resolution handling**: Fixed concat filter errors with different video resolutions
+  - Automatically scales all videos to common resolution before transitions
+  - Maintains aspect ratio with padding when needed
+  - Ensures compatibility with FFmpeg 4.4 and earlier versions
+
+### Changed
+- Updated MediaFX.node.ts to use dynamic output field names based on user configuration
+- Improved Binary Property field descriptions in UI with Merge node usage guidance
+- Enhanced error messages for better debugging of binary data issues
+
+## [1.3.2] - Previous Release
+
+### Fixed
+- Resolved parameter issues in Video operations
+
+## [1.3.1] - Previous Release
+
+### Fixed
+- Restored missing mixAudio operation for Audio resource
+
+## [1.3.0] - Previous Release
+
+### Added
+- Improved resource and action naming for better UX

package/dist/nodes/MediaFX/operations/addSubtitle.js

@@ -31,68 +31,79 @@ const ffmpeg = require("fluent-ffmpeg");
 const utils_1 = require("../utils");
 /**
  * Escape special characters in file path for FFmpeg subtitles filter.
- * FFmpeg subtitles filter requires escaping: \ : [ ] '
  */
 function escapeSubtitlePath(filePath) {
     return filePath
-        .replace(/\\/g, '\\\\\\\\') // Backslash (Windows paths)
-        .replace(/:/g, '\\:') // Colon
-        .replace(/\[/g, '\\[') // Square brackets
+        .replace(/\\/g, '\\\\\\\\')
+        .replace(/:/g, '\\:')
+        .replace(/\[/g, '\\[')
         .replace(/\]/g, '\\]')
-        .replace(/'/g, "\\'"); // Single quote
+        .replace(/'/g, "\\'");
 }
 /**
- * Build ASS/SSA style string for subtitles filter force_style option.
- * This converts our style options to FFmpeg's force_style format.
+ * Convert color to ASS format (&HAABBGGRR)
  */
-function buildForceStyle(fontName, fontSize, fontColor, horizontalAlign, verticalAlign, marginV) {
-    // Convert color from CSS format to ASS format (AABBGGRR)
-    // Default white = &H00FFFFFF
-    let assColor = '&H00FFFFFF';
-    if (fontColor && fontColor.startsWith('#') && fontColor.length === 7) {
-        // Convert #RRGGBB to &H00BBGGRR (ASS uses BGR order with alpha prefix)
-        const r = fontColor.substring(1, 3);
-        const g = fontColor.substring(3, 5);
-        const b = fontColor.substring(5, 7);
-        assColor = `&H00${b}${g}${r}`.toUpperCase();
-    }
-    else if (fontColor === 'white') {
-        assColor = '&H00FFFFFF';
-    }
-    else if (fontColor === 'black') {
-        assColor = '&H00000000';
-    }
-    else if (fontColor === 'yellow') {
-        assColor = '&H0000FFFF';
-    }
-    else if (fontColor === 'red') {
-        assColor = '&H000000FF';
-    }
-    // Alignment mapping for ASS (numpad style)
-    // 1=bottom-left, 2=bottom-center, 3=bottom-right
-    // 4=middle-left, 5=middle-center, 6=middle-right
-    // 7=top-left, 8=top-center, 9=top-right
-    let alignment = 2; // default: bottom-center
-    if (verticalAlign === 'top') {
-        alignment = horizontalAlign === 'left' ? 7 : horizontalAlign === 'right' ? 9 : 8;
-    }
-    else if (verticalAlign === 'middle') {
-        alignment = horizontalAlign === 'left' ? 4 : horizontalAlign === 'right' ? 6 : 5;
+function colorToASS(color, opacity = 1) {
+    let r = 'FF', g = 'FF', b = 'FF';
+    if (color && color.startsWith('#') && color.length === 7) {
+        r = color.substring(1, 3);
+        g = color.substring(3, 5);
+        b = color.substring(5, 7);
     }
     else {
-        // bottom (default)
-        alignment = horizontalAlign === 'left' ? 1 : horizontalAlign === 'right' ? 3 : 2;
+        const namedColors = {
+            white: 'FFFFFF',
+            black: '000000',
+            red: 'FF0000',
+            green: '00FF00',
+            blue: '0000FF',
+            yellow: 'FFFF00',
+            cyan: '00FFFF',
+            magenta: 'FF00FF',
+            orange: 'FFA500',
+        };
+        const hex = namedColors[(color || 'white').toLowerCase()] || 'FFFFFF';
+        r = hex.substring(0, 2);
+        g = hex.substring(2, 4);
+        b = hex.substring(4, 6);
     }
+    const alpha = Math.round((1 - opacity) * 255).toString(16).padStart(2, '0').toUpperCase();
+    return `&H${alpha}${b}${g}${r}`.toUpperCase();
+}
+/**
+ * Get ASS alignment number (numpad style)
+ */
+function getASSAlignment(horizontalAlign, verticalAlign) {
+    var _a, _b;
+    const alignMap = {
+        top: { left: 7, center: 8, right: 9 },
+        middle: { left: 4, center: 5, right: 6 },
+        bottom: { left: 1, center: 2, right: 3 },
+    };
+    return (_b = (_a = alignMap[verticalAlign]) === null || _a === void 0 ? void 0 : _a[horizontalAlign]) !== null && _b !== void 0 ? _b : 2;
+}
+/**
+ * Check if file is ASS/SSA format
+ */
+function isASSFile(filePath) {
+    const ext = path.extname(filePath).toLowerCase();
+    return ext === '.ass' || ext === '.ssa';
+}
+/**
+ * Build force_style string for subtitles filter
+ */
+function buildForceStyle(fontName, fontSize, primaryColor, outlineColor, outlineWidth, backColor, enableBackground, alignment, marginV) {
+    const borderStyle = enableBackground ? 4 : 1;
     const styleParams = [
         `FontName=${fontName}`,
         `FontSize=${fontSize}`,
-        `PrimaryColour=${assColor}`,
-        `OutlineColour=&H00000000`,
-        `BackColour=&H80000000`,
+        `PrimaryColour=${primaryColor}`,
+        `OutlineColour=${outlineColor}`,
+        `BackColour=${backColor}`,
         `Bold=0`,
         `Italic=0`,
-        `BorderStyle=4`,
-        `Outline=1`,
+        `BorderStyle=${borderStyle}`,
+        `Outline=${outlineWidth}`,
         `Shadow=0`,
         `Alignment=${alignment}`,
         `MarginV=${marginV}`,
@@ -100,9 +111,9 @@ function buildForceStyle(fontName, fontSize, fontColor, horizontalAlign, vertica
     return styleParams.join(',');
 }
 async function executeAddSubtitle(video, subtitleFile, style, itemIndex) {
-    var _a, _b;
+    var _a, _b, _c, _d;
     const outputPath = (0, utils_1.getTempFile)(path.extname(video));
-    // 1. Get Font from fontKey
+    // 1. Get Font
     const allFonts = (0, utils_1.getAvailableFonts)();
     const fontKey = style.fontKey || 'noto-sans-kr';
     const font = allFonts[fontKey];
@@ -112,7 +123,12 @@ async function executeAddSubtitle(video, subtitleFile, style, itemIndex) {
     const fontName = font.name || 'Sans';
     const fontSize = style.size || 48;
     const fontColor = style.color || 'white';
-    // 2. Handle position based on position type
+    const outlineWidth = (_a = style.outlineWidth) !== null && _a !== void 0 ? _a : 1;
+    const outlineColor = style.outlineColor || 'black';
+    const enableBackground = (_b = style.enableBackground) !== null && _b !== void 0 ? _b : false;
+    const backgroundColor = style.backgroundColor || 'black';
+    const backgroundOpacity = (_c = style.backgroundOpacity) !== null && _c !== void 0 ? _c : 0.5;
+    // 2. Get alignment
     const positionType = style.positionType || 'alignment';
     let horizontalAlign = 'center';
     let verticalAlign = 'bottom';
@@ -120,15 +136,25 @@ async function executeAddSubtitle(video, subtitleFile, style, itemIndex) {
     if (positionType === 'alignment') {
         horizontalAlign = style.horizontalAlign || 'center';
         verticalAlign = style.verticalAlign || 'bottom';
-        marginV = (_b = (_a = style.paddingY) !== null && _a !== void 0 ? _a : style.padding) !== null && _b !== void 0 ? _b : 20;
+        marginV = (_d = style.paddingY) !== null && _d !== void 0 ? _d : 20;
+    }
+    const alignment = getASSAlignment(horizontalAlign, verticalAlign);
+    // 3. Convert colors to ASS format
+    const primaryColorASS = colorToASS(fontColor, 1);
+    const outlineColorASS = colorToASS(outlineColor, 1);
+    const backColorASS = colorToASS(backgroundColor, backgroundOpacity);
+    // 4. Build FFmpeg command
+    const escapedPath = escapeSubtitlePath(subtitleFile);
+    let subtitlesFilter;
+    if (isASSFile(subtitleFile)) {
+        // ASS/SSA file: use directly without force_style
+        subtitlesFilter = `subtitles='${escapedPath}'`;
+    }
+    else {
+        // SRT file: apply force_style
+        const forceStyle = buildForceStyle(fontName, fontSize, primaryColorASS, outlineColorASS, outlineWidth, backColorASS, enableBackground, alignment, marginV);
+        subtitlesFilter = `subtitles='${escapedPath}':force_style='${forceStyle}'`;
     }
-    // 3. Build force_style for subtitles filter
-    const forceStyle = buildForceStyle(fontName, fontSize, fontColor, horizontalAlign, verticalAlign, marginV);
-    // 4. Escape subtitle file path for FFmpeg
-    const escapedSubtitlePath = escapeSubtitlePath(subtitleFile);
-    // 5. Build subtitles filter (much more reliable than drawtext chain)
-    // Using subtitles filter processes the entire SRT file at once
-    const subtitlesFilter = `subtitles='${escapedSubtitlePath}':force_style='${forceStyle}'`;
     const command = ffmpeg(video)
         .videoFilters([subtitlesFilter])
         .audioCodec('copy')
@@ -138,7 +164,6 @@ async function executeAddSubtitle(video, subtitleFile, style, itemIndex) {
         return outputPath;
     }
     catch (error) {
-        // Clean up output file if creation failed
         await fs.remove(outputPath).catch(() => { });
         throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Error adding subtitles to video. FFmpeg error: ${error.message}`, { itemIndex });
     }

package/dist/nodes/MediaFX/properties/subtitle.properties.js

@@ -178,6 +178,61 @@ exports.subtitleProperties = [
         },
         description: 'Width of the text border/outline',
     },
+    {
+        displayName: 'Outline Color',
+        name: 'outlineColor',
+        type: 'string',
+        default: 'black',
+        displayOptions: {
+            show: {
+                resource: ['subtitle'],
+            },
+        },
+        description: 'Color of the text outline (e.g., black, #000000)',
+    },
+    {
+        displayName: 'Enable Background Box',
+        name: 'enableBackground',
+        type: 'boolean',
+        default: false,
+        displayOptions: {
+            show: {
+                resource: ['subtitle'],
+            },
+        },
+        description: 'Whether to show a background box behind the text',
+    },
+    {
+        displayName: 'Background Color',
+        name: 'backgroundColor',
+        type: 'string',
+        default: 'black',
+        displayOptions: {
+            show: {
+                resource: ['subtitle'],
+                enableBackground: [true],
+            },
+        },
+        description: 'Color of the background box (e.g., black, #000000)',
+    },
+    {
+        displayName: 'Background Opacity',
+        name: 'backgroundOpacity',
+        type: 'number',
+        typeOptions: {
+            minValue: 0,
+            maxValue: 1,
+            numberStepSize: 0.1,
+        },
+        default: 0.5,
+        displayOptions: {
+            show: {
+                resource: ['subtitle'],
+                enableBackground: [true],
+            },
+        },
+        description: 'Opacity of the background box (0 = transparent, 1 = solid)',
+    },
     // ===================
     // POSITION OPTIONS
     // ===================

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lee-jisoo/n8n-nodes-mediafx",
-  "version": "1.6.1",
+  "version": "1.6.3",
   "description": "N8N custom nodes for video editing and media processing (Enhanced fork with Speed control and Subtitle fixes)",
   "license": "MIT",
   "author": {