@lee-jisoo/n8n-nodes-mediafx 1.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +65 -0
- package/README.ko-KR.md +307 -0
- package/README.md +175 -0
- package/fonts/DejaVuSans.ttf +0 -0
- package/fonts/Inter-Regular.ttf +0 -0
- package/fonts/NanumGothic-Regular.ttf +0 -0
- package/fonts/NotoSansKR-Regular.ttf +0 -0
- package/fonts/Pretendard-Regular.otf +0 -0
- package/fonts/Roboto-Regular.ttf +0 -0
- package/package.json +88 -0
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
All notable changes to this project will be documented in this file.
|
|
4
|
+
|
|
5
|
+
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
|
|
6
|
+
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
7
|
+
|
|
8
|
+
## [1.6.0] - 2025-01-25
|
|
9
|
+
|
|
10
|
+
### Added
|
|
11
|
+
- **Speed operation**: Adjust video playback speed (slow motion or fast forward)
|
|
12
|
+
- Support speed range from 0.25x to 4x
|
|
13
|
+
- Option to adjust audio speed along with video
|
|
14
|
+
- Option to maintain original audio pitch when changing speed
|
|
15
|
+
- Output format selection (MP4, MOV, AVI, MKV)
|
|
16
|
+
|
|
17
|
+
### Fixed
|
|
18
|
+
- **addSubtitle operation**: Fixed subtitle display issue with slideshow/image-sequence videos
|
|
19
|
+
- Changed from `drawtext` filter chain to `subtitles` filter
|
|
20
|
+
- The `drawtext` filter's `enable='between(t,X,Y)'` condition was unreliable with image-sequence videos
|
|
21
|
+
- Now uses FFmpeg's native SRT parsing which handles timing correctly
|
|
22
|
+
- Added ASS/SSA style support for better subtitle formatting
|
|
23
|
+
|
|
24
|
+
## [1.5.0] - 2025-01-20
|
|
25
|
+
|
|
26
|
+
### Added
|
|
27
|
+
- **Overlay Video operation**: Overlay a video on top of another video as a layer
|
|
28
|
+
|
|
29
|
+
## [1.4.0] - 2025-01-13
|
|
30
|
+
|
|
31
|
+
### Added
|
|
32
|
+
- **Customizable output field names**: Users can now specify custom binary output field names for all media operations
|
|
33
|
+
- Added "Output Field Name" option to Video, Audio, Image, and Text/Subtitle resources
|
|
34
|
+
- Default field name remains "data" for backward compatibility
|
|
35
|
+
- Allows better organization when chaining multiple MediaFX nodes in workflows
|
|
36
|
+
|
|
37
|
+
### Fixed
|
|
38
|
+
- **Merge node compatibility**: Improved binary data handling when using n8n's Merge node
|
|
39
|
+
- Automatically detects binary properties in merged items (data1, data2, etc.)
|
|
40
|
+
- Searches both current item and first item for binary data
|
|
41
|
+
- Enhanced error messages with available properties list
|
|
42
|
+
- **Video transition resolution handling**: Fixed concat filter errors with different video resolutions
|
|
43
|
+
- Automatically scales all videos to common resolution before transitions
|
|
44
|
+
- Maintains aspect ratio with padding when needed
|
|
45
|
+
- Ensures compatibility with FFmpeg 4.4 and earlier versions
|
|
46
|
+
|
|
47
|
+
### Changed
|
|
48
|
+
- Updated MediaFX.node.ts to use dynamic output field names based on user configuration
|
|
49
|
+
- Improved Binary Property field descriptions in UI with Merge node usage guidance
|
|
50
|
+
- Enhanced error messages for better debugging of binary data issues
|
|
51
|
+
|
|
52
|
+
## [1.3.2] - Previous Release
|
|
53
|
+
|
|
54
|
+
### Fixed
|
|
55
|
+
- Resolved parameter issues in Video operations
|
|
56
|
+
|
|
57
|
+
## [1.3.1] - Previous Release
|
|
58
|
+
|
|
59
|
+
### Fixed
|
|
60
|
+
- Restored missing mixAudio operation for Audio resource
|
|
61
|
+
|
|
62
|
+
## [1.3.0] - Previous Release
|
|
63
|
+
|
|
64
|
+
### Added
|
|
65
|
+
- Improved resource and action naming for better UX
|
package/README.ko-KR.md
ADDED
|
@@ -0,0 +1,307 @@
|
|
|
1
|
+
# n8n-nodes-mediafx (한국어)
|
|
2
|
+
|
|
3
|
+
[](https://www.npmjs.com/package/n8n-nodes-mediafx)
|
|
4
|
+
[](https://opensource.org/licenses/MIT)
|
|
5
|
+
[](https://n8n.io)
|
|
6
|
+
|
|
7
|
+
이 저장소는 FFmpeg의 강력한 기능을 사용하여 포괄적인 로컬 미디어 처리를 위한 커스텀 n8n 노드를 포함하고 있습니다. 외부 API나 서비스 없이 n8n 워크플로우 내에서 직접 다양한 비디오, 오디오, 이미지, 텍스트 작업을 수행할 수 있습니다.
|
|
8
|
+
|
|
9
|
+
<!-- Optional: Add a GIF of the node in action here -->
|
|
10
|
+
<!-- <p align="center"><img src="link/to/your/demo.gif" alt="MediaFX Node Demo"></p> -->
|
|
11
|
+
|
|
12
|
+
## v1.4.2의 새로운 기능
|
|
13
|
+
|
|
14
|
+
- **버그 수정**: 비디오 소스가 올바르게 설정되지 않은 경우 오디오 분리 작업에서 "did not produce an output" 오류 수정
|
|
15
|
+
- 소스가 누락된 경우 명확한 오류 메시지와 함께 적절한 유효성 검사 추가
|
|
16
|
+
|
|
17
|
+
### v1.4.1
|
|
18
|
+
|
|
19
|
+
- **오디오 분리**: 비디오를 무음 비디오와 추출된 오디오 트랙으로 분리하는 새로운 Video 작업
|
|
20
|
+
- 사용자 정의 가능한 필드명으로 두 출력을 단일 아이템으로 반환
|
|
21
|
+
- 다양한 비디오 포맷(MP4, MOV, AVI, MKV) 및 오디오 포맷(MP3, AAC, WAV, FLAC) 지원
|
|
22
|
+
- 가장 빠른 처리를 위한 copy(재인코딩 없음) 포함 오디오 코덱 옵션
|
|
23
|
+
|
|
24
|
+
### v1.4.0
|
|
25
|
+
- **사용자 정의 출력 필드명**: 워크플로우 구성 개선을 위한 바이너리 출력 필드명 설정 가능
|
|
26
|
+
- **향상된 Merge 노드 지원**: 다중 입력 작업을 위한 n8n Merge 노드와의 원활한 연동
|
|
27
|
+
- **자동 해상도 처리**: 전환 효과에서 서로 다른 해상도의 비디오 스마트 스케일링
|
|
28
|
+
- **개선된 오류 메시지**: 상세한 바이너리 프로퍼티 정보로 더 나은 디버깅 지원
|
|
29
|
+
|
|
30
|
+
## MediaFX를 사용해야 하는 이유
|
|
31
|
+
|
|
32
|
+
- **프라이버시 중심**: 모든 처리가 n8n 인스턴스에서 로컬로 이루어집니다. 미디어 파일은 절대 서버 외부로 나가지 않습니다.
|
|
33
|
+
- **외부 API 불필요**: API 키, 구독, 제3자 서비스 비용이 필요 없습니다.
|
|
34
|
+
- **강력한 성능**: 고품질 미디어 조작을 위해 FFmpeg의 모든 기능을 활용합니다.
|
|
35
|
+
- **자체 포함**: `@ffmpeg-installer/ffmpeg`를 통해 FFmpeg가 자동으로 다운로드되고 포함되어, 대부분의 경우 시스템 종속성을 수동으로 설치할 필요가 없습니다.
|
|
36
|
+
- **유연성**: 간단한 자르기부터 복잡한 오디오 믹싱, 텍스트 오버레이까지 다양한 작업을 처리합니다.
|
|
37
|
+
|
|
38
|
+
## 주요 기능
|
|
39
|
+
|
|
40
|
+
- **비디오 처리**: 여러 클립 병합, 특정 구간 자르기, 자동 FFmpeg 호환성 감지로 비디오 간 전환 효과 적용, 단일 비디오에 페이드 인/아웃 효과 추가.
|
|
41
|
+
- **고급 오디오 조작**:
|
|
42
|
+
- 비디오에서 다양한 형식(MP3, WAV, AAC, FLAC)으로 오디오 추출
|
|
43
|
+
- 각 소스별 정밀한 볼륨 조절로 오디오 트랙 믹싱
|
|
44
|
+
- **부분 오디오 믹싱**: 시작 시간과 지속 시간을 조절하여 특정 시간 범위에 오디오 삽입
|
|
45
|
+
- **오디오 반복**: 짧은 오디오를 원하는 길이에 맞게 자동 반복
|
|
46
|
+
- **독립적인 페이드 효과**: 전체 믹싱과 부분 믹싱 모두에서 사용자 지정 길이로 페이드 인/아웃 효과 적용
|
|
47
|
+
- **고급 이미지 작업**:
|
|
48
|
+
- 사용자 지정 크기 및 길이로 이미지에서 비디오 클립 생성
|
|
49
|
+
- **스마트 워터마크**: 위치, 크기, 회전, 투명도 조절
|
|
50
|
+
- **시간 제어**: 특정 구간에만 워터마크 표시 또는 전체 영상에 표시
|
|
51
|
+
- **향상된 텍스트 및 자막**:
|
|
52
|
+
- 광범위한 스타일링(글꼴, 크기, 색상, 윤곽선, 배경 상자)으로 텍스트 오버레이 추가
|
|
53
|
+
- **스마트 위치 지정**: 정렬 프리셋(좌/중앙/우, 상/중간/하) 또는 사용자 지정 좌표 사용
|
|
54
|
+
- **패딩 조절**: 가장자리에서 가로 및 세로 패딩 개별 조절
|
|
55
|
+
- 동일한 텍스트 스타일링 옵션으로 외부 자막 파일(`.srt`) 추가 및 스타일링
|
|
56
|
+
- **글꼴 관리**: 텍스트 작업에 사용할 사용자 지정 글꼴(TTF, OTF) 업로드, 목록 조회, 미리보기, 검증 및 삭제.
|
|
57
|
+
|
|
58
|
+
## n8n에 설치하기
|
|
59
|
+
|
|
60
|
+
1. **설정 > 커뮤니티 노드**로 이동합니다.
|
|
61
|
+
2. **설치**를 클릭합니다.
|
|
62
|
+
3. **npm 패키지 이름 입력** 필드에 `n8n-nodes-mediafx`를 입력합니다.
|
|
63
|
+
4. **설치**를 다시 클릭합니다.
|
|
64
|
+
|
|
65
|
+
노드가 설치되고 n8n이 다시 시작됩니다. 그러면 노드 패널에서 "MediaFX" 노드를 찾을 수 있습니다.
|
|
66
|
+
|
|
67
|
+
구버전 n8n 또는 수동 설치의 경우:
|
|
68
|
+
|
|
69
|
+
1. n8n 사용자 데이터 폴더(기본값: `~/.n8n/`)로 이동합니다.
|
|
70
|
+
2. `nodes` 디렉토리로 들어갑니다: `cd ~/.n8n/nodes`.
|
|
71
|
+
3. 패키지를 설치합니다: `npm install n8n-nodes-mediafx`.
|
|
72
|
+
4. n8n 인스턴스를 다시 시작합니다.
|
|
73
|
+
|
|
74
|
+
## 노드: MediaFX
|
|
75
|
+
|
|
76
|
+
모든 미디어 처리 작업을 위한 메인 노드입니다. `리소스` 유형을 선택한 다음 해당 리소스에 대해 수행할 `작업`을 선택합니다.
|
|
77
|
+
|
|
78
|
+
### 리소스 및 작업
|
|
79
|
+
|
|
80
|
+
#### **비디오** 리소스
|
|
81
|
+
- `병합`: 여러 비디오 파일을 하나로 결합합니다.
|
|
82
|
+
- `자르기`: 비디오를 특정 시작 및 종료 시간으로 자릅니다.
|
|
83
|
+
- `전환`: 자동 FFmpeg 버전 감지 및 대체 지원으로 여러 비디오 간 전환 효과를 적용합니다.
|
|
84
|
+
- `페이드`: 하나의 비디오에 페이드 인/아웃 효과를 적용합니다.
|
|
85
|
+
- `오디오 분리`: 비디오를 무음 비디오 파일과 추출된 오디오 파일로 분리하여 동시에 반환합니다.
|
|
86
|
+
|
|
87
|
+
#### **오디오** 리소스
|
|
88
|
+
- `추출`: 비디오 파일에서 오디오 트랙을 지정된 형식(MP3, WAV, AAC, FLAC)으로 추출합니다.
|
|
89
|
+
- `믹싱`: 기본 비디오의 오디오를 보조 오디오 소스와 고급 기능으로 믹싱합니다:
|
|
90
|
+
- **볼륨 조절**: 기본 및 보조 소스 각각에 대한 독립적인 볼륨 조정
|
|
91
|
+
- **전체 믹스 모드**: 전체 길이에 걸쳐 오디오 믹싱 (최단/최장/첫 번째 소스)
|
|
92
|
+
- **부분 믹스 모드**: 정확한 시작 시간과 지속 시간으로 특정 시간 범위에 오디오 삽입
|
|
93
|
+
- **오디오 반복**: 짧은 오디오를 지정된 길이에 맞게 자동 반복
|
|
94
|
+
- **독립적인 페이드 효과**: 전체 믹싱과 부분 믹싱 모두에서 사용자 지정 길이로 페이드 인 및 페이드 아웃 효과 적용
|
|
95
|
+
|
|
96
|
+
#### **이미지** 리소스
|
|
97
|
+
- `이미지를 비디오로`: 소스 이미지에서 비디오를 생성하고, 길이 및 출력 크기를 지정합니다.
|
|
98
|
+
- `이미지 스탬프`: 고급 워터마크 기능으로 비디오에 이미지를 오버레이합니다:
|
|
99
|
+
- **위치 및 크기 조절**: 정확한 픽셀 위치와 크기 설정
|
|
100
|
+
- **회전 및 투명도**: 각도 조절과 투명도 제어
|
|
101
|
+
- **시간 제어**: 특정 시간 구간에만 표시하거나 전체 영상에 표시
|
|
102
|
+
|
|
103
|
+
#### **텍스트** 리소스
|
|
104
|
+
- `문자열 추가`: 비디오에 텍스트 오버레이를 추가합니다.
|
|
105
|
+
- `자막 추가`: `.srt` 파일에서 자막을 추가합니다.
|
|
106
|
+
|
|
107
|
+
#### **글꼴** 리소스
|
|
108
|
+
- `목록`: 사용 가능한 모든 시스템 및 사용자 업로드 글꼴 목록을 가져옵니다.
|
|
109
|
+
- `업로드`: 텍스트 작업에 사용할 사용자 지정 글꼴 파일(`.ttf`, `.otf`)을 업로드합니다.
|
|
110
|
+
- `삭제`: 이전에 업로드한 사용자 글꼴을 제거합니다.
|
|
111
|
+
|
|
112
|
+
## 사용 예제
|
|
113
|
+
|
|
114
|
+
### Merge 노드와 함께 사용하기 (v1.4.0 신규)
|
|
115
|
+
n8n의 Merge 노드를 사용하여 여러 비디오 입력을 결합할 때:
|
|
116
|
+
|
|
117
|
+
1. 여러 비디오 소스를 Merge 노드에 연결
|
|
118
|
+
2. Merge 노드를 "Combine All" 모드로 설정
|
|
119
|
+
3. MediaFX 노드에서 Binary Property 이름을 `data1`, `data2` 등으로 설정 (Merge 노드 출력과 일치)
|
|
120
|
+
4. MediaFX가 모든 병합된 입력을 자동으로 감지하고 처리
|
|
121
|
+
|
|
122
|
+
### 이미지를 비디오로 변환
|
|
123
|
+
단일 이미지에서 1920x1080 해상도의 10초짜리 비디오를 만듭니다.
|
|
124
|
+
|
|
125
|
+
```json
|
|
126
|
+
{
|
|
127
|
+
"resource": "image",
|
|
128
|
+
"operation": "imageToVideo",
|
|
129
|
+
"sourceImage": {
|
|
130
|
+
"source": { "sourceType": "binary", "binaryProperty": "data" }
|
|
131
|
+
},
|
|
132
|
+
"duration": 10,
|
|
133
|
+
"videoSize": {
|
|
134
|
+
"width": 1920,
|
|
135
|
+
"height": 1080
|
|
136
|
+
},
|
|
137
|
+
"outputFormat": "mp4"
|
|
138
|
+
}
|
|
139
|
+
```
|
|
140
|
+
|
|
141
|
+
### 페이드 효과가 있는 고급 오디오 믹싱
|
|
142
|
+
`main_video.mp4`의 15초 지점부터 30초 동안 `new_audio.mp3`를 믹싱하고, 반복 재생과 페이드 효과를 적용합니다.
|
|
143
|
+
|
|
144
|
+
```json
|
|
145
|
+
{
|
|
146
|
+
"resource": "audio",
|
|
147
|
+
"operation": "mixAudio",
|
|
148
|
+
"mixVideoSourceType": "url",
|
|
149
|
+
"mixVideoSourceUrl": "/path/to/main_video.mp4",
|
|
150
|
+
"mixAudioSourceType": "url",
|
|
151
|
+
"mixAudioSourceUrl": "/path/to/new_audio.mp3",
|
|
152
|
+
"videoVolume": 1.0,
|
|
153
|
+
"audioVolume": 0.5,
|
|
154
|
+
"enablePartialMix": true,
|
|
155
|
+
"startTime": 15,
|
|
156
|
+
"duration": 30,
|
|
157
|
+
"loop": true,
|
|
158
|
+
"enableFadeIn": true,
|
|
159
|
+
"fadeInDuration": 2,
|
|
160
|
+
"enableFadeOut": true,
|
|
161
|
+
"fadeOutDuration": 3
|
|
162
|
+
}
|
|
163
|
+
```
|
|
164
|
+
|
|
165
|
+
### 스마트 위치 지정으로 텍스트 오버레이 추가
|
|
166
|
+
정렬 프리셋과 사용자 지정 스타일링을 사용하여 비디오에 텍스트를 추가합니다.
|
|
167
|
+
|
|
168
|
+
```json
|
|
169
|
+
{
|
|
170
|
+
"resource": "subtitle",
|
|
171
|
+
"operation": "addText",
|
|
172
|
+
"source": { "source": { "sourceType": "binary", "binaryProperty": "data" } },
|
|
173
|
+
"textOptions": {
|
|
174
|
+
"text": "안녕하세요, 커스텀 폰트!",
|
|
175
|
+
"fontKey": "my-custom-font",
|
|
176
|
+
"size": 48,
|
|
177
|
+
"color": "yellow",
|
|
178
|
+
"positionType": "alignment",
|
|
179
|
+
"horizontalAlign": "center",
|
|
180
|
+
"verticalAlign": "bottom",
|
|
181
|
+
"paddingX": 20,
|
|
182
|
+
"paddingY": 50,
|
|
183
|
+
"startTime": 0,
|
|
184
|
+
"endTime": 10
|
|
185
|
+
}
|
|
186
|
+
}
|
|
187
|
+
```
|
|
188
|
+
|
|
189
|
+
### 고급 워터마크 스탬프 적용
|
|
190
|
+
특정 시간 구간에 워터마크를 적용합니다.
|
|
191
|
+
|
|
192
|
+
```json
|
|
193
|
+
{
|
|
194
|
+
"resource": "image",
|
|
195
|
+
"operation": "stampImage",
|
|
196
|
+
"sourceVideo": {
|
|
197
|
+
"source": { "sourceType": "binary", "binaryProperty": "data" }
|
|
198
|
+
},
|
|
199
|
+
"stampImage": {
|
|
200
|
+
"source": { "sourceType": "binary", "binaryProperty": "watermark" }
|
|
201
|
+
},
|
|
202
|
+
"width": 200,
|
|
203
|
+
"height": -1,
|
|
204
|
+
"x": "(main_w-overlay_w)-20",
|
|
205
|
+
"y": "20",
|
|
206
|
+
"rotation": 15,
|
|
207
|
+
"opacity": 0.8,
|
|
208
|
+
"enableTimeControl": true,
|
|
209
|
+
"startTime": 5,
|
|
210
|
+
"endTime": 25
|
|
211
|
+
}
|
|
212
|
+
```
|
|
213
|
+
|
|
214
|
+
### 비디오에서 오디오 분리 (v1.4.1 신규)
|
|
215
|
+
비디오를 무음 비디오와 추출된 오디오 트랙으로 분리합니다.
|
|
216
|
+
|
|
217
|
+
```json
|
|
218
|
+
{
|
|
219
|
+
"resource": "video",
|
|
220
|
+
"operation": "separateAudio",
|
|
221
|
+
"separateSource": {
|
|
222
|
+
"source": { "sourceType": "binary", "binaryProperty": "data" }
|
|
223
|
+
},
|
|
224
|
+
"separateVideoFormat": "mp4",
|
|
225
|
+
"separateAudioFormat": "mp3",
|
|
226
|
+
"separateAudioCodec": "copy",
|
|
227
|
+
"separateAudioBitrate": "192k",
|
|
228
|
+
"separateVideoFieldName": "video",
|
|
229
|
+
"separateAudioFieldName": "audio"
|
|
230
|
+
}
|
|
231
|
+
```
|
|
232
|
+
|
|
233
|
+
**출력**: 두 개의 바이너리 속성을 가진 단일 아이템을 반환합니다:
|
|
234
|
+
- `video`: 무음 비디오 파일 (오디오 트랙 없음)
|
|
235
|
+
- `audio`: 추출된 오디오 파일
|
|
236
|
+
|
|
237
|
+
## 요구 사항
|
|
238
|
+
|
|
239
|
+
- n8n: 버전 1.0 이상 권장.
|
|
240
|
+
- Node.js: 버전 16 이상.
|
|
241
|
+
- FFmpeg: `@ffmpeg-installer/ffmpeg`를 통해 자동으로 다운로드되고 포함되며, `ffmpeg-static`이 대체 수단으로 제공됩니다. 일부 시스템에서는 수동 설치가 필요할 수 있습니다.
|
|
242
|
+
|
|
243
|
+
### FFmpeg 설치
|
|
244
|
+
|
|
245
|
+
노드는 `@ffmpeg-installer/ffmpeg` 패키지를 통해 FFmpeg를 자동으로 다운로드합니다(`ffmpeg-static`이 대체 수단). 서버에서 FFmpeg 관련 오류가 발생하는 경우 수동으로 FFmpeg를 설치해야 할 수 있습니다:
|
|
246
|
+
|
|
247
|
+
**Ubuntu/Debian:**
|
|
248
|
+
```bash
|
|
249
|
+
sudo apt update && sudo apt install ffmpeg
|
|
250
|
+
```
|
|
251
|
+
|
|
252
|
+
**CentOS/RHEL/Rocky Linux:**
|
|
253
|
+
```bash
|
|
254
|
+
sudo yum install epel-release && sudo yum install ffmpeg
|
|
255
|
+
# 또는 최신 버전의 경우:
|
|
256
|
+
sudo dnf install ffmpeg
|
|
257
|
+
```
|
|
258
|
+
|
|
259
|
+
**Alpine Linux (Docker):**
|
|
260
|
+
```bash
|
|
261
|
+
apk add ffmpeg
|
|
262
|
+
```
|
|
263
|
+
|
|
264
|
+
**macOS:**
|
|
265
|
+
```bash
|
|
266
|
+
brew install ffmpeg
|
|
267
|
+
```
|
|
268
|
+
|
|
269
|
+
## 개발
|
|
270
|
+
|
|
271
|
+
이 노드에 기여하고 싶다면:
|
|
272
|
+
|
|
273
|
+
1. 이 저장소를 복제(Clone)합니다.
|
|
274
|
+
2. `npm install`로 종속성을 설치합니다.
|
|
275
|
+
3. `npm run build`로 노드를 빌드합니다.
|
|
276
|
+
4. 개발 중에는 `npm run dev`를 사용하여 변경 사항을 감시하고 자동으로 다시 빌드합니다.
|
|
277
|
+
5. [로컬 저장소를 n8n 노드 디렉토리에 연결합니다.](https://docs.n8n.io/integrations/creating-nodes/test-node/#linking-the-node)
|
|
278
|
+
|
|
279
|
+
## 저장소
|
|
280
|
+
|
|
281
|
+
**GitHub**: [https://github.com/dandacompany/n8n-nodes-mediafx](https://github.com/dandacompany/n8n-nodes-mediafx)
|
|
282
|
+
|
|
283
|
+
## 개발자
|
|
284
|
+
|
|
285
|
+
**개발자**: Dante
|
|
286
|
+
**이메일**: datapod.k@gmail.com
|
|
287
|
+
**유튜브 채널**: [단테랩스](https://www.youtube.com/@단테랩스)
|
|
288
|
+
|
|
289
|
+
## 기여하기
|
|
290
|
+
|
|
291
|
+
기여를 환영합니다! [GitHub 저장소](https://github.com/dandacompany/n8n-nodes-mediafx)에서 이슈, 기능 요청 또는 풀 리퀘스트를 자유롭게 제출해 주세요.
|
|
292
|
+
|
|
293
|
+
## 지원
|
|
294
|
+
|
|
295
|
+
- **이슈**: [GitHub Issues](https://github.com/dandacompany/n8n-nodes-mediafx/issues)
|
|
296
|
+
- **토론**: [GitHub Discussions](https://github.com/dandacompany/n8n-nodes-mediafx/discussions)
|
|
297
|
+
- **유튜브**: [단테랩스](https://www.youtube.com/@단테랩스)에서 튜토리얼과 데모를 확인하세요
|
|
298
|
+
|
|
299
|
+
## 프로젝트 후원
|
|
300
|
+
|
|
301
|
+
이 노드가 유용하셨다면, 커피 한 잔 후원을 고려해 주세요!
|
|
302
|
+
|
|
303
|
+
[](https://buymeacoffee.com/dante.labs)
|
|
304
|
+
|
|
305
|
+
## 라이선스
|
|
306
|
+
|
|
307
|
+
MIT
|
package/README.md
ADDED
|
@@ -0,0 +1,175 @@
|
|
|
1
|
+
# @lee-jisoo/n8n-nodes-mediafx
|
|
2
|
+
|
|
3
|
+
[](https://www.npmjs.com/package/@lee-jisoo/n8n-nodes-mediafx)
|
|
4
|
+
[](https://opensource.org/licenses/MIT)
|
|
5
|
+
[](https://n8n.io)
|
|
6
|
+
|
|
7
|
+
> **Enhanced fork of [n8n-nodes-mediafx](https://github.com/dandacompany/n8n-nodes-mediafx)** with additional features and bug fixes.
|
|
8
|
+
|
|
9
|
+
This is a custom n8n node for comprehensive, local media processing using FFmpeg. It allows you to perform a wide range of video, audio, image, and text operations directly within your n8n workflows without needing any external API or service.
|
|
10
|
+
|
|
11
|
+
## 🆕 What's New in This Fork
|
|
12
|
+
|
|
13
|
+
### v1.6.0
|
|
14
|
+
- **🎬 Speed Operation**: Adjust video playback speed (slow motion or fast forward)
|
|
15
|
+
- Speed range: 0.25x to 4x
|
|
16
|
+
- Option to adjust audio speed along with video
|
|
17
|
+
- Option to maintain original audio pitch
|
|
18
|
+
- Output format selection (MP4, MOV, AVI, MKV)
|
|
19
|
+
|
|
20
|
+
- **🐛 Subtitle Bug Fix**: Fixed subtitle display issue with slideshow/image-sequence videos
|
|
21
|
+
- Changed from `drawtext` filter chain to `subtitles` filter
|
|
22
|
+
- The original `drawtext` filter's `enable='between(t,X,Y)'` was unreliable with image-sequence videos
|
|
23
|
+
- Now uses FFmpeg's native SRT parsing for correct timing
|
|
24
|
+
|
|
25
|
+
## Why use this fork?
|
|
26
|
+
|
|
27
|
+
- **Speed Control**: Easily create slow-motion or fast-forward videos
|
|
28
|
+
- **Reliable Subtitles**: Fixed critical bug where subtitles were dropped on slideshow videos
|
|
29
|
+
- All original features from [n8n-nodes-mediafx](https://github.com/dandacompany/n8n-nodes-mediafx) included
|
|
30
|
+
|
|
31
|
+
## Installation
|
|
32
|
+
|
|
33
|
+
### Via n8n Community Nodes (Recommended)
|
|
34
|
+
1. Go to **Settings > Community Nodes**
|
|
35
|
+
2. Click **Install**
|
|
36
|
+
3. Enter `@lee-jisoo/n8n-nodes-mediafx`
|
|
37
|
+
4. Click **Install**
|
|
38
|
+
|
|
39
|
+
### Manual Installation
|
|
40
|
+
```bash
|
|
41
|
+
cd ~/.n8n/nodes
|
|
42
|
+
npm install @lee-jisoo/n8n-nodes-mediafx
|
|
43
|
+
# Restart n8n
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
### Docker Installation
|
|
47
|
+
```dockerfile
|
|
48
|
+
# In your Dockerfile
|
|
49
|
+
RUN cd /home/node/.n8n/nodes && npm install @lee-jisoo/n8n-nodes-mediafx
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
## Features
|
|
53
|
+
|
|
54
|
+
### Video Operations
|
|
55
|
+
| Operation | Description |
|
|
56
|
+
|-----------|-------------|
|
|
57
|
+
| **Merge** | Combine multiple videos into one |
|
|
58
|
+
| **Trim** | Cut video to specific start/end time |
|
|
59
|
+
| **Speed** | Adjust playback speed (0.25x - 4x) ⭐ NEW |
|
|
60
|
+
| **Transition** | Apply transition effects between videos |
|
|
61
|
+
| **Fade** | Apply fade in/out effects |
|
|
62
|
+
| **Separate Audio** | Split into muted video + audio track |
|
|
63
|
+
| **Overlay Video** | Overlay video on top of another |
|
|
64
|
+
|
|
65
|
+
### Audio Operations
|
|
66
|
+
| Operation | Description |
|
|
67
|
+
|-----------|-------------|
|
|
68
|
+
| **Extract** | Extract audio from video (MP3, WAV, AAC, FLAC) |
|
|
69
|
+
| **Mix** | Mix audio tracks with volume control, partial mixing, looping, fade effects |
|
|
70
|
+
|
|
71
|
+
### Image Operations
|
|
72
|
+
| Operation | Description |
|
|
73
|
+
|-----------|-------------|
|
|
74
|
+
| **Image to Video** | Create video from image with custom duration |
|
|
75
|
+
| **Stamp Image** | Add watermark with position, size, rotation, opacity, time control |
|
|
76
|
+
|
|
77
|
+
### Text/Subtitle Operations
|
|
78
|
+
| Operation | Description |
|
|
79
|
+
|-----------|-------------|
|
|
80
|
+
| **Add String** | Burn text overlay with styling |
|
|
81
|
+
| **Add Subtitle** | Add subtitles from SRT file ⭐ FIXED |
|
|
82
|
+
|
|
83
|
+
### Font Operations
|
|
84
|
+
| Operation | Description |
|
|
85
|
+
|-----------|-------------|
|
|
86
|
+
| **List** | Get available fonts |
|
|
87
|
+
| **Upload** | Upload custom fonts (TTF, OTF) |
|
|
88
|
+
| **Delete** | Remove uploaded fonts |
|
|
89
|
+
|
|
90
|
+
## Usage Examples
|
|
91
|
+
|
|
92
|
+
### Speed Adjustment (New!)
|
|
93
|
+
Create a 2x speed video:
|
|
94
|
+
```json
|
|
95
|
+
{
|
|
96
|
+
"resource": "video",
|
|
97
|
+
"operation": "speed",
|
|
98
|
+
"speedSource": {
|
|
99
|
+
"source": { "sourceType": "binary", "binaryProperty": "data" }
|
|
100
|
+
},
|
|
101
|
+
"speed": 2,
|
|
102
|
+
"adjustAudio": true,
|
|
103
|
+
"maintainPitch": false,
|
|
104
|
+
"speedOutputFormat": "mp4"
|
|
105
|
+
}
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
Create slow-motion (0.5x):
|
|
109
|
+
```json
|
|
110
|
+
{
|
|
111
|
+
"resource": "video",
|
|
112
|
+
"operation": "speed",
|
|
113
|
+
"speed": 0.5,
|
|
114
|
+
"adjustAudio": true
|
|
115
|
+
}
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
### Add Subtitles (Fixed!)
|
|
119
|
+
Works correctly with slideshow/image-sequence videos:
|
|
120
|
+
```json
|
|
121
|
+
{
|
|
122
|
+
"resource": "subtitle",
|
|
123
|
+
"operation": "addSubtitle",
|
|
124
|
+
"source": {
|
|
125
|
+
"source": { "sourceType": "binary", "binaryProperty": "video" }
|
|
126
|
+
},
|
|
127
|
+
"subtitleFileSource": {
|
|
128
|
+
"source": { "sourceType": "binary", "binaryProperty": "srt" }
|
|
129
|
+
},
|
|
130
|
+
"fontKey": "noto-sans-kr",
|
|
131
|
+
"size": 48,
|
|
132
|
+
"color": "white",
|
|
133
|
+
"horizontalAlign": "center",
|
|
134
|
+
"verticalAlign": "bottom"
|
|
135
|
+
}
|
|
136
|
+
```
|
|
137
|
+
|
|
138
|
+
## Requirements
|
|
139
|
+
|
|
140
|
+
- **n8n**: Version 1.0+
|
|
141
|
+
- **Node.js**: Version 16+
|
|
142
|
+
- **FFmpeg**: Auto-installed via `@ffmpeg-installer/ffmpeg`
|
|
143
|
+
|
|
144
|
+
### Manual FFmpeg Installation (if needed)
|
|
145
|
+
|
|
146
|
+
**Ubuntu/Debian:**
|
|
147
|
+
```bash
|
|
148
|
+
sudo apt update && sudo apt install ffmpeg
|
|
149
|
+
```
|
|
150
|
+
|
|
151
|
+
**Alpine (Docker):**
|
|
152
|
+
```bash
|
|
153
|
+
apk add ffmpeg
|
|
154
|
+
```
|
|
155
|
+
|
|
156
|
+
**macOS:**
|
|
157
|
+
```bash
|
|
158
|
+
brew install ffmpeg
|
|
159
|
+
```
|
|
160
|
+
|
|
161
|
+
## Credits
|
|
162
|
+
|
|
163
|
+
This is an enhanced fork of [n8n-nodes-mediafx](https://github.com/dandacompany/n8n-nodes-mediafx) by [Dante](https://github.com/dandacompany).
|
|
164
|
+
|
|
165
|
+
**Original Author**: Dante (datapod.k@gmail.com)
|
|
166
|
+
**Fork Maintainer**: Lee-Jisoo (mihisasi@naver.com)
|
|
167
|
+
|
|
168
|
+
## Repository
|
|
169
|
+
|
|
170
|
+
- **This Fork**: [https://github.com/lee-jisoo/n8n-nodes-mediafx](https://github.com/lee-jisoo/n8n-nodes-mediafx)
|
|
171
|
+
- **Original**: [https://github.com/dandacompany/n8n-nodes-mediafx](https://github.com/dandacompany/n8n-nodes-mediafx)
|
|
172
|
+
|
|
173
|
+
## License
|
|
174
|
+
|
|
175
|
+
MIT
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
package/package.json
ADDED
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@lee-jisoo/n8n-nodes-mediafx",
|
|
3
|
+
"version": "1.6.0",
|
|
4
|
+
"description": "N8N custom nodes for video editing and media processing (Enhanced fork with Speed control and Subtitle fixes)",
|
|
5
|
+
"license": "MIT",
|
|
6
|
+
"author": {
|
|
7
|
+
"name": "Lee-Jisoo",
|
|
8
|
+
"email": "mihisasi@naver.com"
|
|
9
|
+
},
|
|
10
|
+
"repository": {
|
|
11
|
+
"type": "git",
|
|
12
|
+
"url": "https://github.com/lee-jisoo/n8n-nodes-mediafx.git"
|
|
13
|
+
},
|
|
14
|
+
"homepage": "https://github.com/lee-jisoo/n8n-nodes-mediafx#readme",
|
|
15
|
+
"bugs": {
|
|
16
|
+
"url": "https://github.com/lee-jisoo/n8n-nodes-mediafx/issues"
|
|
17
|
+
},
|
|
18
|
+
"main": "dist/nodes/MediaFX/MediaFX.node.js",
|
|
19
|
+
"scripts": {
|
|
20
|
+
"build": "npm run clean && tsc && gulp build",
|
|
21
|
+
"clean": "rimraf dist",
|
|
22
|
+
"dev": "tsc --watch",
|
|
23
|
+
"lint": "eslint nodes --ext .js,.ts",
|
|
24
|
+
"lint:fix": "eslint nodes --ext .js,.ts --fix",
|
|
25
|
+
"test": "jest",
|
|
26
|
+
"prepublishOnly": "npm run build"
|
|
27
|
+
},
|
|
28
|
+
"files": [
|
|
29
|
+
"dist",
|
|
30
|
+
"fonts"
|
|
31
|
+
],
|
|
32
|
+
"n8n": {
|
|
33
|
+
"n8nNodesApiVersion": 1,
|
|
34
|
+
"nodes": [
|
|
35
|
+
"dist/nodes/MediaFX/MediaFX.node.js"
|
|
36
|
+
]
|
|
37
|
+
},
|
|
38
|
+
"keywords": [
|
|
39
|
+
"n8n",
|
|
40
|
+
"n8n-community-node-package",
|
|
41
|
+
"video",
|
|
42
|
+
"audio",
|
|
43
|
+
"ffmpeg",
|
|
44
|
+
"media",
|
|
45
|
+
"editing",
|
|
46
|
+
"subtitle",
|
|
47
|
+
"transition"
|
|
48
|
+
],
|
|
49
|
+
"dependencies": {
|
|
50
|
+
"@ffmpeg-installer/ffmpeg": "^1.1.0",
|
|
51
|
+
"@ffprobe-installer/ffprobe": "^2.1.2",
|
|
52
|
+
"@types/fs-extra": "^11.0.4",
|
|
53
|
+
"axios": "^1.10.0",
|
|
54
|
+
"ffmpeg-static": "^5.2.0",
|
|
55
|
+
"fluent-ffmpeg": "^2.1.3",
|
|
56
|
+
"fs-extra": "^11.3.0",
|
|
57
|
+
"srt-parser-2": "^1.2.3",
|
|
58
|
+
"uuid": "^11.1.0"
|
|
59
|
+
},
|
|
60
|
+
"devDependencies": {
|
|
61
|
+
"@types/fluent-ffmpeg": "^2.1.27",
|
|
62
|
+
"@types/jest": "^29.5.12",
|
|
63
|
+
"@types/node": "^20.12.7",
|
|
64
|
+
"@types/uuid": "^10.0.0",
|
|
65
|
+
"@typescript-eslint/eslint-plugin": "^7.7.0",
|
|
66
|
+
"@typescript-eslint/parser": "^7.7.0",
|
|
67
|
+
"eslint": "^8.57.0",
|
|
68
|
+
"eslint-plugin-n8n-nodes-base": "^1.16.3",
|
|
69
|
+
"gulp": "^4.0.2",
|
|
70
|
+
"gulp-rename": "^2.0.0",
|
|
71
|
+
"jest": "^29.7.0",
|
|
72
|
+
"n8n-core": "1.0.0",
|
|
73
|
+
"n8n-workflow": "1.0.0",
|
|
74
|
+
"prettier": "^3.2.5",
|
|
75
|
+
"rimraf": "^5.0.5",
|
|
76
|
+
"ts-jest": "^29.1.2",
|
|
77
|
+
"ts-node": "^10.9.2",
|
|
78
|
+
"typescript": "~4.8.4"
|
|
79
|
+
},
|
|
80
|
+
"jest": {
|
|
81
|
+
"preset": "ts-jest",
|
|
82
|
+
"testEnvironment": "node",
|
|
83
|
+
"testPathIgnorePatterns": [
|
|
84
|
+
"/node_modules/",
|
|
85
|
+
"/dist/"
|
|
86
|
+
]
|
|
87
|
+
}
|
|
88
|
+
}
|