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.
3.0 KiB
3.0 KiB
n8n-nodes-songs2vid
Official community node for Songs2VID — turn audio + cover art into YouTube-ready videos from n8n.
Primary source hub: git.atakanozban.com/Songs2VID
Documentation: https://docs.songs2vid.com/docs/n8n · in-repo docs/n8n.md
Web UI (secondary mirror): songs2vid.com
Self-hosted OSS: set Base URL to your instance. API keys work without a paid plan (YouTube must be connected).
Install
From n8n (recommended)
- Open n8n → Settings → Community nodes
- Install a community node
- Enter:
n8n-nodes-songs2vid
- Confirm and restart n8n if prompted
- Search the canvas for Songs2VID
Self-hosted n8n needs community packages enabled (N8N_COMMUNITY_PACKAGES_ENABLED=true).
From npm (manual)
cd ~/.n8n
npm install n8n-nodes-songs2vid
Restart n8n.
Credentials
- Create an API key under Dashboard → Settings (
s2yt_live_…) - Cloud requires Developer & Automation (€15) or Enterprise, plus YouTube connected
- In n8n: create a Songs2VID API credential
- API Key: your token
- Base URL:
https://songs2vid.com(or your self-hosted origin, no trailing slash)
Requests use Authorization: Bearer … only.
Quick start
- File → Upload — cover (
type=image) → savepath - File → Upload — audio (
type=audio) → savepath/filename - Render → Create Render — paths + privacy + resolution
Optional: Additional Fields → Webhook URL for async completion - Handle
job.completed/job.item.completedon an n8n Webhook node, or poll Get Render Status
Operations
| Resource | Operation | API |
|---|---|---|
| Discovery | Get API Catalog | GET /api/v1 |
| File | Upload | POST /api/v1/upload |
| Render | Create Render | POST /api/v1/render |
| Render | Create Job (alias) | POST /api/v1/jobs |
| Render | Create Batch | POST /api/v1/jobs/batch |
| Render | Get Render Status | GET /api/v1/jobs/:id |
| Render | List Renders | GET /api/v1/jobs |
| Playlist | List / Create | /api/v1/playlists |
| API Key | List / Create / Delete | /api/v1/user/api-keys |
Layout, watermark, playlist, and multi-track options are under Additional Fields on Create Render.
There is no Delete Render endpoint — finished videos live on YouTube.
Links
- Primary source hub: https://git.atakanozban.com/Songs2VID
- Guide: https://docs.songs2vid.com/docs/n8n
- REST endpoints: https://docs.songs2vid.com/docs/api/endpoints
- Workflow template:
workflows/workflow-template.json - npm: https://www.npmjs.com/package/n8n-nodes-songs2vid
- Web UI: https://songs2vid.com
Development
npm install
npm run build
prepublishOnly runs the build before npm publish.
License
MIT