@spark-apps/quickpeak

<img src=imgs/logo.png>

Demo videos for your web app with AI

Quick Start

npm install -g @spark-apps/quickpeak
qp localhost:3000

Requirements: ffmpeg, Groq API key (free)

Features

Feature	Description
AI Planning	Groq AI analyzes your app and generates demo steps
Voice Over	Free Edge TTS narration in 60+ languages
Karaoke Captions	Word-by-word highlighted subtitles
Background Music	Optional music with fade in/out
Smart Zoom	Per-step zoom for focused demos

Examples

Basic

qp localhost:3000

With Options

qp localhost:3000 lang=es -d "A todo app for managing daily tasks"

Option	Description
lang	Voice language (en, es, ar, zh...)
video.width/height	Resolution (default: 1080x1920)
video.quality	Quality 0-1 (default: 0.5)
music.path	Background music file
music.volume	Music volume 0-1 (default: 0.3)
intro.enabled	Enable voice intro
output.dir	Output directory (default: ./demo)

Config is auto-generated on first run. Edit quickpeak.config.json to customize.

Supported Languages

Code	Language	Code	Language
en	English	ar	Arabic
es	Spanish	fr	French
de	German	zh	Chinese
ja	Japanese	ko	Korean
pt	Portuguese	hi	Hindi
it	Italian	ru	Russian

See src/voices.ts for all 60+ supported languages.

Caption Style

Edit captions.css (auto-generated) to customize:

.caption {
  font-family: Arial, sans-serif;
  -webkit-text-stroke: 3px #000000;
}
.caption .regular {
  font-size: 56px;
  color: #FFFFFF;
}
.caption .highlight {
  font-size: 64px;
  color: #FFFF00;
}

Output

File	Description
demo/demo.mp4	Final video
demo/plan.json	Editable script (re-run to apply changes)

🌱 Support & Contributions

⭐ Star the repo & I power up like Mario 🍄
☕ Devs run on coffee - [Buy me one?][coffee-link]
💖 Sponsor Your support helps maintain and improve the tool
💰 Crypto tips welcome - Tip in crypto
🤝 Contributions are welcome - [🍴 Fork][fork-link], improve, PR!
🎥 Need help? [Setup Tutorial][vid-link] • Join Discord

MIT License - Made with ☕ by Spark Apps