Node.js Developer Needed for Media Processing Pipeline (FFmpeg+API Integration)

Project Overview

I have a Node.js–based media automation app that combines:

* dynamic text
* voice synthesis (TTS)
* visual media
* optional background audio into short rendered videos.

The core backend and structure are already in place, along with a basic Lovable/Next.js frontend and a Google Sheets webhook for logging. I now need a developer to:

* finish key backend pieces,
* wire the APIs cleanly,
* add robust batch support, and
* handle background audio integration.

All source files, examples, and documentation are included in a single handoff ZIP.

---

Scope of Work

1. **Media Merge Engine**

* Finalize the Node/FFmpeg pipeline (`merge.mjs`) that combines:

* primary video
* TTS audio
* optional secondary background audio
* text overlay
* Output: 2 aspect ratios (portrait + landscape).

2. **Batch Processing**

* Validate and improve `run-batch.mjs` for CSV-driven jobs.
* Add proper logging, error handling, and concurrency control.

3. **Text & Voice**

* Ensure the system accepts a user-supplied `text` field that:

* can be used for overlay, and
* can be sent to a TTS API for narration.
* Integrate one TTS provider via API key (already stubbed in the code).

4. **Background Audio (Music)**

* Support an optional secondary audio track in three ways:

1. **User-supplied file:** `music` path in request/CSV.
2. **Internal audio assets:** `musicTrackId` mapped to files under `/music`.
3. **External generator:** optional call to an audio generation API when `generateMusic = true` (e.g., using `musicStyle` or similar fields).
* Mix background audio under the main voice with:

* lower volume
* gentle fade-in/fade-out
* simple ducking if necessary.

5. **Frontend (Lovable / Next.js)**

* Connect existing frontend placeholders to backend endpoints:

* `/composer` – single job
* `/batch` – CSV upload
* `/results` – list/download output
* Ensure clean API integration and basic status/feedback in the UI.

6. **Google Sheets Logging**

* Deploy the provided Google Apps Script as a Web App.
* Confirm the backend can POST metadata to this endpoint for each job.

7. **Testing & Deployment**

* Run local tests:

* single preview job
* batch run with sample CSV
* Help prepare for deployment (Vercel/Render/Lovable or similar).

---

Tech Stack

* Node.js (ES modules)
* FFmpeg (via ffmpeg-static / fluent-ffmpeg)
* Next.js / Lovable (frontend)
* External APIs (TTS, media generation, optional audio generator)
* Google Apps Script webhook for logging

---
Budget & Timeline

* Budget:

* Eastern Europe: **$80–$150**
* Bangladesh / India: **$50–$120**
* Timeline: **2–3 days** for a focused developer

---

Requirements

* Strong experience with Node.js & FFmpeg
* Comfortable integrating 2–3 external APIs
* Able to work with CSV-driven batch pipelines
* Familiar with Next.js or similar frameworks
* Respectful of confidentiality and existing architecture

---

To Apply

Please share:

1. Examples of Node.js + FFmpeg or media automation work you’ve done.
2. Confirmation that you can complete within 2–3 days.
3. Your fixed price quote (USD).