@ferchy/n8n-nodes-aimc-toolkit 0.1.39 → 0.1.41
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/README.md +15 -74
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -48,80 +48,6 @@ n8n is powerful, but real workflows often need basic utilities (validation, pars
|
|
|
48
48
|
npm install @ferchy/n8n-nodes-aimc-toolkit
|
|
49
49
|
```
|
|
50
50
|
|
|
51
|
-
---
|
|
52
|
-
|
|
53
|
-
## Important: FFmpeg for Docker/Self-Hosted Users
|
|
54
|
-
|
|
55
|
-
**If you're using AIMC Media node and see "FFmpeg not found" errors, read this!**
|
|
56
|
-
|
|
57
|
-
### Why Do I Need to Install FFmpeg Separately?
|
|
58
|
-
|
|
59
|
-
When you install a community node in n8n, **only the JavaScript code is installed** - not system binaries like FFmpeg. Here's why:
|
|
60
|
-
|
|
61
|
-
1. **npm packages can only include JavaScript** - FFmpeg is a compiled binary program, not JavaScript code
|
|
62
|
-
2. **We include ffmpeg-static** which tries to download a pre-compiled FFmpeg, but it often fails in Docker because:
|
|
63
|
-
- The binary is compiled for a different architecture (ARM vs x86)
|
|
64
|
-
- Docker containers may block the download
|
|
65
|
-
- The binary may not have execute permissions
|
|
66
|
-
3. **n8n runs inside a container** - even if FFmpeg is on your host machine, the container can't access it
|
|
67
|
-
|
|
68
|
-
### The Solution
|
|
69
|
-
|
|
70
|
-
**Install FFmpeg directly in your n8n container.** This takes 30 seconds:
|
|
71
|
-
|
|
72
|
-
```bash
|
|
73
|
-
# For Docker (run this command)
|
|
74
|
-
docker exec -it your-n8n-container apk add --no-cache ffmpeg
|
|
75
|
-
|
|
76
|
-
# Or add to your Dockerfile for permanent installation
|
|
77
|
-
FROM n8nio/n8n:latest
|
|
78
|
-
USER root
|
|
79
|
-
RUN apk add --no-cache ffmpeg
|
|
80
|
-
USER node
|
|
81
|
-
```
|
|
82
|
-
|
|
83
|
-
Once installed, AIMC Media will **automatically detect** FFmpeg at /usr/bin/ffmpeg - no environment variables needed!
|
|
84
|
-
|
|
85
|
-
### Quick Test
|
|
86
|
-
|
|
87
|
-
After installing FFmpeg, try this URL in AIMC Media:
|
|
88
|
-
```
|
|
89
|
-
http://commondatastorage.googleapis.com/gtv-videos-bucket/sample/ForBiggerEscapes.mp4
|
|
90
|
-
```
|
|
91
|
-
|
|
92
|
-
---
|
|
93
|
-
|
|
94
|
-
## FFmpeg Setup
|
|
95
|
-
|
|
96
|
-
AIMC Media runs inside your n8n host/container, so FFmpeg must be available there.
|
|
97
|
-
It will use the first available option:
|
|
98
|
-
|
|
99
|
-
1. FFMPEG_PATH / FFPROBE_PATH environment variables
|
|
100
|
-
2. System FFmpeg (e.g., /usr/bin/ffmpeg)
|
|
101
|
-
3. Bundled ffmpeg-static / ffprobe-static
|
|
102
|
-
|
|
103
|
-
### Docker (n8n official image)
|
|
104
|
-
```bash
|
|
105
|
-
docker exec container apk add --no-cache ffmpeg
|
|
106
|
-
```
|
|
107
|
-
|
|
108
|
-
### Custom Dockerfile (any host)
|
|
109
|
-
Works for Coolify, Docker Compose, Kubernetes, or any Docker host.
|
|
110
|
-
```dockerfile
|
|
111
|
-
FROM n8nio/n8n:latest
|
|
112
|
-
RUN apk add --no-cache ffmpeg
|
|
113
|
-
```
|
|
114
|
-
|
|
115
|
-
### Debian/Ubuntu
|
|
116
|
-
```bash
|
|
117
|
-
apt-get update && apt-get install -y ffmpeg
|
|
118
|
-
```
|
|
119
|
-
|
|
120
|
-
### macOS
|
|
121
|
-
```bash
|
|
122
|
-
brew install ffmpeg
|
|
123
|
-
```
|
|
124
|
-
|
|
125
51
|
## Nodes
|
|
126
52
|
|
|
127
53
|
### AIMC Code
|
|
@@ -197,6 +123,21 @@ Input URL: https://example.com/video.mp4
|
|
|
197
123
|
Output Format: webm
|
|
198
124
|
```
|
|
199
125
|
|
|
126
|
+
## FFmpeg Setup (AIMC Media)
|
|
127
|
+
|
|
128
|
+
FFmpeg must be installed on the same host/container where n8n runs. AIMC Media uses, in order:
|
|
129
|
+
1. `FFMPEG_PATH` / `FFPROBE_PATH` environment variables
|
|
130
|
+
2. System FFmpeg on `PATH`
|
|
131
|
+
3. Bundled `ffmpeg-static` / `ffprobe-static` (if available)
|
|
132
|
+
|
|
133
|
+
**Install examples**
|
|
134
|
+
- Docker (inside container): `docker exec -it <container> apk add --no-cache ffmpeg`
|
|
135
|
+
- Dockerfile (any host): `FROM n8nio/n8n:latest` then `RUN apk add --no-cache ffmpeg`
|
|
136
|
+
- Debian/Ubuntu: `apt-get update && apt-get install -y ffmpeg`
|
|
137
|
+
- macOS (local dev): `brew install ffmpeg`
|
|
138
|
+
|
|
139
|
+
**Quick test**: use `http://commondatastorage.googleapis.com/gtv-videos-bucket/sample/ForBiggerEscapes.mp4` as Input URL.
|
|
140
|
+
|
|
200
141
|
### AIMC Social Scraper
|
|
201
142
|
|
|
202
143
|
**Coming Soon!**
|