Atakan Doğan Özban
0f363c5620
Cap FFmpeg output with probed audio duration (FFmpeg 5.x -shortest bug), point SUPPORT_EMAIL to support@songs2vid.com, and align Hub/README/n8n docs with the Gitea + npm package links.
38 lines
1.1 KiB
Markdown
38 lines
1.1 KiB
Markdown
# n8n integration (OSS)
|
|
|
|
Automate self-hosted Songs2VID with the community package **[`n8n-nodes-songs2vid`](https://www.npmjs.com/package/n8n-nodes-songs2vid)**.
|
|
|
|
**Primary source hub:** [git.atakanozban.com/Songs2VID](https://git.atakanozban.com/Songs2VID)
|
|
Full hosted guide: [https://docs.songs2vid.com/docs/n8n](https://docs.songs2vid.com/docs/n8n) · Web UI: [songs2vid.com](https://songs2vid.com)
|
|
|
|
## Install
|
|
|
|
In n8n → **Settings → Community nodes** → install:
|
|
|
|
```text
|
|
n8n-nodes-songs2vid
|
|
```
|
|
|
|
Or from this repo for local development:
|
|
|
|
```bash
|
|
cd integrations/n8n
|
|
npm install
|
|
npm run build
|
|
```
|
|
|
|
## Auth
|
|
|
|
1. Dashboard → **Settings → API key** → create `s2yt_live_…`
|
|
2. n8n credential **Songs2VID API**: paste key, Base URL = your instance (e.g. `http://localhost:3000`)
|
|
|
|
OSS has **no plan gate** — API keys work whenever YouTube is connected.
|
|
|
|
## Flow
|
|
|
|
1. **Upload** cover (`type=image`) and audio (`type=audio`)
|
|
2. **Create Render** (`POST /api/v1/render`) with paths + optional `webhookUrl`
|
|
3. Handle completion via n8n **Webhook** or poll `GET /api/v1/jobs/:id`
|
|
|
|
Package source: [`integrations/n8n`](../integrations/n8n/).
|