@spark-apps/quickpeek

QuickPeek Core

Core library for QuickPeek - AI-powered demo video generation

Installation

npm install @spark-apps/quickpeek

Overview

This is the core library used by @spark-apps/quickpeek-cli. It provides:

• API Client - Communication with QuickPeek backend for AI planning
• TTS Engine - Text-to-speech via Edge TTS (60+ languages)
• FFmpeg Wrapper - Video composition, watermarks, effects
• Prompt Builder - System and user prompts for AI planning
• Web Crawler - Page analysis for demo planning
• Utilities - Caption styling, ASS subtitle generation, config management

Usage

import {
  callAI,
  generateVoiceover,
  composeVideo,
  crawlPage,
  buildSystemPrompt,
  buildUserPrompt,
  DEFAULT_CONFIG,
  VERSION,
} from '@spark-apps/quickpeek';

// Crawl a page for interactive elements
const { title, elements } = await crawlPage('https://example.com');

// Generate AI demo plan
const systemPrompt = buildSystemPrompt(8);
const userPrompt = buildUserPrompt(url, title, elements, 'English', 'A todo app', 8);
const result = await callAI(systemPrompt, userPrompt, '[e-mail]');

// Generate voiceover
const { voiceoverPath, stepAudio } = await generateVoiceover(
  steps,
  config,
  workDir,
  outputDir,
  logError,
  task,
  info
);

// Compose final video
await composeVideo({
  videoPath,
  assPath,
  outputPath,
  voiceoverPath,
  musicPath,
  // ... options
});

Exports

Module	Description
api-client	Backend API communication
tts	Text-to-speech generation
ffmpeg	Video composition
prompts	AI prompt templates
crawl	Web page analysis
config	Default configuration
utils	ASS subtitles, color conversion
voices	Voice mappings for 60+ languages
styles	Caption styling
cursor	Custom cursor CSS/JS
watermark	Watermark generation

Related Packages

• @spark-apps/quickpeek-cli - CLI tool

MIT License - Made with ☕ by Spark Apps