Skip to content

README.md

Latest commit

 

History

History
118 lines (85 loc) · 3.55 KB

README.md

File metadata and controls

118 lines (85 loc) · 3.55 KB

UGC Video Maker

Node.js SQLite EJS License

a

UGC Video Maker is a local-first web application for generating affiliate-style UGC videos with the BytePlus ModelArk Seedance 2.0 API. It is designed for creators, affiliate teams, and product marketers who need a simple workflow: upload product references, choose a creator/background reference, write a short script, and generate a ready-to-review video.

Need API access or a Seedance 2.0 package? Open the BytePlus ModelArk console

Features

  • Product, creator, and background image references
  • Seedance 2.0 and Seedance 2.0 Fast model selection
  • UGC presets such as product demo, unboxing, testimonial, ASMR, and affiliate selling
  • Configurable language, voice tone, music, resolution, ratio, and duration
  • Editable advanced prompt with visual reference mentions
  • Queue-based batch generation workflow
  • Local video download after generation
  • Local thumbnail capture for generated videos
  • History gallery with playable video modal
  • SQLite persistence for settings, assets, queue items, and completed videos
  • Real-person reference fallback using a subtle diagonal pattern retry

Tech Stack

  • Node.js
  • Express
  • EJS
  • SQLite via better-sqlite3
  • Multer for image uploads
  • Sharp for reference-image preprocessing
  • Vanilla JavaScript and CSS

Requirements

  • Node.js 18 or newer
  • npm
  • BytePlus ModelArk API key with access to Seedance 2.0

Getting Started

Install dependencies:

npm install

Start the app:

npm start

Open the local app:

http://localhost:3000

For development with auto-reload:

npm run dev

Configuration

Open the Settings page inside the app and configure:

  • BytePlus API key
  • API base URL
  • Default model
  • Default resolution
  • Default aspect ratio

Default API base URL:

https://ark.ap-southeast.bytepluses.com/api/v3

The API key is stored in the local SQLite database. Do not commit the database file to a public repository.

Project Structure

.
├── database.js          # SQLite schema and data helpers
├── server.js            # Express app entry point
├── routes/              # Page and API routes
├── services/            # Seedance API and local media helpers
├── views/               # EJS pages and partials
├── public/              # CSS, client-side JS, and static images
├── uploads/             # User-uploaded reference images
├── downloads/           # Locally saved videos and thumbnails
└── data/                # Local SQLite database

Local Data

This project is intended to run locally. Uploaded assets, generated videos, thumbnails, and the SQLite database are stored on the same machine:

  • uploads/
  • downloads/
  • data/ugc.db

These directories may contain private user images, generated videos, and API configuration, so they are ignored by Git.

Notes

  • Keep generated media and API credentials private when sharing the project.
  • Use product images with clear lighting and minimal clutter for more consistent results.
  • Review model usage and pricing in the BytePlus console before running large batches.