@studiomeyer/mcp-video 1.0.0

package/dist/tools/engine/text-overlay.js

@@ -0,0 +1,84 @@
+/**
+ * Text overlay engine — animated titles, subtitles, watermarks
+ */
+import { execFile } from 'child_process';
+import * as fs from 'fs';
+import { logger } from '../../lib/logger.js';
+// ─── Position Resolver ──────────────────────────────────────────────
+function resolvePosition(pos) {
+    switch (pos) {
+        case 'top': return { x: '(w-text_w)/2', y: 'h*0.08' };
+        case 'bottom': return { x: '(w-text_w)/2', y: 'h*0.88' };
+        case 'top-left': return { x: 'w*0.05', y: 'h*0.05' };
+        case 'top-right': return { x: 'w-text_w-w*0.05', y: 'h*0.05' };
+        case 'bottom-left': return { x: 'w*0.05', y: 'h-text_h-h*0.05' };
+        case 'bottom-right': return { x: 'w-text_w-w*0.05', y: 'h-text_h-h*0.05' };
+        default: return { x: '(w-text_w)/2', y: '(h-text_h)/2' };
+    }
+}
+// ─── Filter Builder ─────────────────────────────────────────────────
+function buildDrawtextFilter(overlay, fontPath) {
+    const { text, position = 'center', fontSize = 48, fontColor = 'white', startTime, endTime, fadeIn = 0.5, fadeOut = 0.5, showBackground = false, backgroundColor = 'black@0.6', } = overlay;
+    const { x, y } = resolvePosition(position);
+    const fadeInEnd = startTime + fadeIn;
+    const fadeOutStart = endTime - fadeOut;
+    // Escape for ffmpeg
+    const escaped = text.replace(/'/g, "\\\\'").replace(/:/g, '\\:');
+    // Alpha expression: fade in → hold → fade out
+    const alpha = `if(lt(t\\,${startTime})\\,0\\,if(lt(t\\,${fadeInEnd})\\,(t-${startTime})/${fadeIn}\\,if(lt(t\\,${fadeOutStart})\\,1\\,if(lt(t\\,${endTime})\\,(${endTime}-t)/${fadeOut}\\,0))))`;
+    let filter = `drawtext=text='${escaped}':fontfile='${fontPath}':fontsize=${fontSize}:fontcolor=${fontColor}:x=${x}:y=${y}:alpha='${alpha}':enable='between(t,${startTime},${endTime})'`;
+    if (showBackground) {
+        filter += `:box=1:boxcolor=${backgroundColor}:boxborderw=12`;
+    }
+    return filter;
+}
+// ─── Main Function ──────────────────────────────────────────────────
+export async function addTextOverlays(inputPath, outputPath, overlays) {
+    if (!fs.existsSync(inputPath))
+        throw new Error(`Input not found: ${inputPath}`);
+    if (overlays.length === 0)
+        throw new Error('No overlays provided');
+    const fontPath = findFont();
+    const filters = overlays.map((o) => buildDrawtextFilter(o, fontPath)).join(',');
+    logger.info(`Adding ${overlays.length} text overlay(s)`);
+    const args = [
+        '-y',
+        '-i', inputPath,
+        '-vf', filters,
+        '-c:a', 'copy',
+        '-c:v', 'libx264',
+        '-crf', '18',
+        '-pix_fmt', 'yuv420p',
+        '-movflags', '+faststart',
+        outputPath,
+    ];
+    await runFfmpeg(args);
+    logger.info(`Text overlays added: ${outputPath}`);
+    return outputPath;
+}
+// ─── Helpers ────────────────────────────────────────────────────────
+function findFont() {
+    const candidates = [
+        '/usr/share/fonts/truetype/dejavu/DejaVuSans-Bold.ttf',
+        '/usr/share/fonts/truetype/liberation/LiberationSans-Bold.ttf',
+        '/usr/share/fonts/truetype/ubuntu/Ubuntu-Bold.ttf',
+    ];
+    for (const f of candidates) {
+        if (fs.existsSync(f))
+            return f;
+    }
+    return '/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf';
+}
+function runFfmpeg(args) {
+    return new Promise((resolve, reject) => {
+        execFile('ffmpeg', args, { maxBuffer: 50 * 1024 * 1024 }, (error, stdout, stderr) => {
+            if (error) {
+                logger.error(`ffmpeg failed: ${stderr}`);
+                reject(new Error(`ffmpeg failed: ${stderr || error.message}`));
+                return;
+            }
+            resolve(stdout);
+        });
+    });
+}
+//# sourceMappingURL=text-overlay.js.map

package/dist/tools/engine/text-overlay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-overlay.js","sourceRoot":"","sources":["../../../src/tools/engine/text-overlay.ts"],"names":[],"mappings":"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"}

package/dist/tools/engine/tts.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Text-to-Speech Engine
+ * Primary: ElevenLabs (best quality, multilingual)
+ * Fallback: OpenAI TTS (reliable, already integrated)
+ *
+ * No extra npm dependencies — ElevenLabs uses native fetch,
+ * OpenAI uses the already-installed openai package
+ */
+export type TTSProvider = 'elevenlabs' | 'openai';
+export type ElevenLabsModel = 'eleven_multilingual_v2' | 'eleven_turbo_v2_5' | 'eleven_flash_v2_5';
+export type ElevenLabsVoice = 'rachel' | 'sarah' | 'emily' | 'charlotte' | 'alice' | 'matilda' | 'lily' | 'brian' | 'adam' | 'daniel' | 'josh' | 'james' | 'liam' | 'chris' | 'george';
+export type OpenAIVoice = 'alloy' | 'ash' | 'coral' | 'echo' | 'fable' | 'nova' | 'onyx' | 'sage' | 'shimmer';
+export type OpenAIModel = 'tts-1' | 'tts-1-hd';
+export interface TTSConfig {
+    /** Text to speak */
+    text: string;
+    /** Output path for the audio file */
+    outputPath: string;
+    /** TTS provider (default: elevenlabs) */
+    provider?: TTSProvider;
+    /** Language code (default: en) */
+    language?: string;
+    /** Speaking speed (default: 1.0) */
+    speed?: number;
+    /** ElevenLabs voice name (default: adam) */
+    elevenLabsVoice?: ElevenLabsVoice | string;
+    /** ElevenLabs model (default: eleven_multilingual_v2) */
+    elevenLabsModel?: ElevenLabsModel;
+    /** Voice stability 0-1 (default: 0.5) */
+    stability?: number;
+    /** Voice similarity 0-1 (default: 0.75) */
+    similarityBoost?: number;
+    /** OpenAI voice (default: onyx) */
+    openaiVoice?: OpenAIVoice;
+    /** OpenAI model (default: tts-1-hd) */
+    openaiModel?: OpenAIModel;
+}
+export interface TTSResult {
+    success: boolean;
+    audioPath: string;
+    provider: TTSProvider;
+    duration: number;
+    sizeBytes: number;
+    sizeMB: string;
+    text: string;
+    language: string;
+}
+export declare function generateSpeech(config: TTSConfig): Promise<TTSResult>;
+export declare function listElevenLabsVoices(): Promise<Array<{
+    voice_id: string;
+    name: string;
+    category: string;
+    language: string;
+}>>;

package/dist/tools/engine/tts.js

@@ -0,0 +1,186 @@
+/**
+ * Text-to-Speech Engine
+ * Primary: ElevenLabs (best quality, multilingual)
+ * Fallback: OpenAI TTS (reliable, already integrated)
+ *
+ * No extra npm dependencies — ElevenLabs uses native fetch,
+ * OpenAI uses the already-installed openai package
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { logger } from '../../lib/logger.js';
+import { getMediaDuration } from './audio.js';
+// ─── ElevenLabs Voice IDs ───────────────────────────────────────────
+const ELEVENLABS_VOICE_IDS = {
+    rachel: '21m00Tcm4TlvDq8ikWAM',
+    sarah: 'EXAVITQu4vr4xnSDxMaL',
+    emily: 'LcfcDJNUP1GQjkzn1xUU',
+    charlotte: 'XB0fDUnXU5powFXDhCwa',
+    alice: 'Xb7hH8MSUJpSbSDYk0k2',
+    matilda: 'XrExE9yKIg1WjnnlVkGX',
+    lily: 'pFZP5JQG7iQjIQuC4Bku',
+    brian: 'nPczCjzI2devNBz1zQrb',
+    adam: 'pNInz6obpgDQGcFmaJgB',
+    daniel: 'onwK4e9ZLuTAKqWW03F9',
+    josh: 'TxGEqnHWrfWFTfGW9XjX',
+    james: 'ZQe5CZNOzWyzPSCn5a3c',
+    liam: 'TX3LPaxmHKxFdv7VOQHJ',
+    chris: 'iP95p4xoKVk53GoZ742B',
+    george: 'JBFqnCBsd6RMkjVDRZzb',
+};
+// ─── Main TTS Function ─────────────────────────────────────────────
+export async function generateSpeech(config) {
+    const { text, outputPath, provider = getDefaultProvider(), language = 'en', } = config;
+    // Ensure output dir exists
+    const outDir = path.dirname(outputPath);
+    if (!fs.existsSync(outDir))
+        fs.mkdirSync(outDir, { recursive: true });
+    // Ensure .mp3 extension
+    const finalPath = outputPath.endsWith('.mp3') ? outputPath : `${outputPath}.mp3`;
+    logger.info(`Generating speech (${provider}, ${language}, ${text.length} chars)`);
+    let audioPath;
+    try {
+        if (provider === 'elevenlabs') {
+            audioPath = await elevenLabsTTS(config, finalPath);
+        }
+        else {
+            audioPath = await openaiTTS(config, finalPath);
+        }
+    }
+    catch (error) {
+        // Fallback: try the other provider
+        const fallback = provider === 'elevenlabs' ? 'openai' : 'elevenlabs';
+        const msg = error instanceof Error ? error.message : String(error);
+        logger.warn(`${provider} TTS failed (${msg}), falling back to ${fallback}`);
+        try {
+            if (fallback === 'elevenlabs') {
+                audioPath = await elevenLabsTTS(config, finalPath);
+            }
+            else {
+                audioPath = await openaiTTS(config, finalPath);
+            }
+        }
+        catch (fallbackError) {
+            const fbMsg = fallbackError instanceof Error ? fallbackError.message : String(fallbackError);
+            throw new Error(`Both TTS providers failed. ${provider}: ${msg}, ${fallback}: ${fbMsg}`);
+        }
+    }
+    // Get audio stats
+    const stats = fs.statSync(audioPath);
+    let duration = 0;
+    try {
+        duration = await getMediaDuration(audioPath);
+    }
+    catch {
+        // ffprobe might not parse the file
+    }
+    logger.info(`Speech generated: ${audioPath} (${duration.toFixed(1)}s, ${(stats.size / 1024).toFixed(0)} KB)`);
+    return {
+        success: true,
+        audioPath,
+        provider,
+        duration,
+        sizeBytes: stats.size,
+        sizeMB: (stats.size / 1024 / 1024).toFixed(2),
+        text,
+        language,
+    };
+}
+// ─── ElevenLabs Implementation ──────────────────────────────────────
+async function elevenLabsTTS(config, outputPath) {
+    const apiKey = process.env.ELEVENLABS_API_KEY;
+    if (!apiKey)
+        throw new Error('ELEVENLABS_API_KEY environment variable not set');
+    const voiceName = config.elevenLabsVoice ?? 'adam';
+    const voiceId = ELEVENLABS_VOICE_IDS[voiceName] ?? voiceName; // Allow raw voice IDs
+    const model = config.elevenLabsModel ?? 'eleven_multilingual_v2';
+    const language = config.language ?? 'en';
+    const url = `https://api.elevenlabs.io/v1/text-to-speech/${voiceId}?output_format=mp3_44100_128`;
+    const body = {
+        text: config.text,
+        model_id: model,
+        language_code: language,
+        voice_settings: {
+            stability: config.stability ?? 0.5,
+            similarity_boost: config.similarityBoost ?? 0.75,
+            style: 0.0,
+            speed: config.speed ?? 1.0,
+            use_speaker_boost: true,
+        },
+    };
+    logger.info(`ElevenLabs TTS: voice=${voiceName}, model=${model}, lang=${language}`);
+    const response = await fetch(url, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            'xi-api-key': apiKey,
+        },
+        body: JSON.stringify(body),
+    });
+    if (!response.ok) {
+        const errorText = await response.text();
+        throw new Error(`ElevenLabs API ${response.status}: ${errorText}`);
+    }
+    const arrayBuffer = await response.arrayBuffer();
+    fs.writeFileSync(outputPath, Buffer.from(arrayBuffer));
+    return outputPath;
+}
+// ─── OpenAI Implementation ──────────────────────────────────────────
+async function openaiTTS(config, outputPath) {
+    const apiKey = process.env.OPENAI_API_KEY;
+    if (!apiKey)
+        throw new Error('OPENAI_API_KEY environment variable not set');
+    const voice = config.openaiVoice ?? 'onyx';
+    const model = config.openaiModel ?? 'tts-1-hd';
+    const speed = config.speed ?? 1.0;
+    logger.info(`OpenAI TTS: voice=${voice}, model=${model}, speed=${speed}`);
+    // Use fetch directly (avoid OpenAI package version issues)
+    const response = await fetch('https://api.openai.com/v1/audio/speech', {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            'Authorization': `Bearer ${apiKey}`,
+        },
+        body: JSON.stringify({
+            model,
+            voice,
+            input: config.text,
+            response_format: 'mp3',
+            speed,
+        }),
+    });
+    if (!response.ok) {
+        const errorText = await response.text();
+        throw new Error(`OpenAI TTS API ${response.status}: ${errorText}`);
+    }
+    const arrayBuffer = await response.arrayBuffer();
+    fs.writeFileSync(outputPath, Buffer.from(arrayBuffer));
+    return outputPath;
+}
+// ─── List ElevenLabs Voices ─────────────────────────────────────────
+export async function listElevenLabsVoices() {
+    const apiKey = process.env.ELEVENLABS_API_KEY;
+    if (!apiKey)
+        throw new Error('ELEVENLABS_API_KEY environment variable not set');
+    const response = await fetch('https://api.elevenlabs.io/v1/voices', {
+        headers: { 'xi-api-key': apiKey },
+    });
+    if (!response.ok)
+        throw new Error(`ElevenLabs API ${response.status}`);
+    const data = await response.json();
+    return data.voices.map((v) => ({
+        voice_id: v.voice_id,
+        name: v.name,
+        category: v.category,
+        language: v.labels?.language ?? 'unknown',
+    }));
+}
+// ─── Helper ─────────────────────────────────────────────────────────
+function getDefaultProvider() {
+    if (process.env.ELEVENLABS_API_KEY)
+        return 'elevenlabs';
+    if (process.env.OPENAI_API_KEY)
+        return 'openai';
+    throw new Error('No TTS API key found. Set ELEVENLABS_API_KEY or OPENAI_API_KEY.');
+}
+//# sourceMappingURL=tts.js.map

package/dist/tools/engine/tts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tts.js","sourceRoot":"","sources":["../../../src/tools/engine/tts.ts"],"names":[],"mappings":"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"}

package/dist/tools/engine/types.d.ts

@@ -0,0 +1,166 @@
+/**
+ * Type definitions for the Cinema Video Engine
+ */
+export declare const VIEWPORTS: {
+    readonly desktop: {
+        readonly width: 1920;
+        readonly height: 1080;
+    };
+    readonly 'desktop-4k': {
+        readonly width: 3840;
+        readonly height: 2160;
+    };
+    readonly tablet: {
+        readonly width: 768;
+        readonly height: 1024;
+    };
+    readonly 'tablet-landscape': {
+        readonly width: 1024;
+        readonly height: 768;
+    };
+    readonly mobile: {
+        readonly width: 393;
+        readonly height: 852;
+    };
+    readonly 'mobile-landscape': {
+        readonly width: 852;
+        readonly height: 393;
+    };
+};
+export type ViewportPreset = keyof typeof VIEWPORTS;
+export interface ViewportConfig {
+    width: number;
+    height: number;
+}
+export type EasingName = 'linear' | 'easeInQuad' | 'easeOutQuad' | 'easeInOutQuad' | 'easeInCubic' | 'easeOutCubic' | 'easeInOutCubic' | 'easeInQuart' | 'easeOutQuart' | 'easeInOutQuart' | 'easeInQuint' | 'easeOutQuint' | 'easeInOutQuint' | 'easeInOutSine' | 'cinematic' | 'showcase';
+export interface SceneBase {
+    type: string;
+}
+export interface ScrollScene extends SceneBase {
+    type: 'scroll';
+    /** Target: 'bottom', 'top', pixel number, or CSS selector */
+    to: 'bottom' | 'top' | number | string;
+    /** Duration of the scroll in seconds */
+    duration: number;
+    /** Easing curve name (default: easeInOutCubic) */
+    easing?: EasingName;
+}
+export interface PauseScene extends SceneBase {
+    type: 'pause';
+    /** Duration in seconds */
+    duration: number;
+}
+export interface HoverScene extends SceneBase {
+    type: 'hover';
+    /** CSS selector of element to hover */
+    selector: string;
+    /** How long to hold the hover (seconds) */
+    duration: number;
+    /** Move cursor smoothly to element (default: true) */
+    animateCursor?: boolean;
+}
+export interface ClickScene extends SceneBase {
+    type: 'click';
+    /** CSS selector of element to click */
+    selector: string;
+    /** Wait strategy after click */
+    waitFor?: 'networkidle' | 'load' | number;
+    /** Pause after navigation (seconds, default: 1) */
+    pauseAfter?: number;
+}
+export interface TypeScene extends SceneBase {
+    type: 'type';
+    /** CSS selector of input field */
+    selector: string;
+    /** Text to type */
+    text: string;
+    /** Delay between keystrokes in ms (default: 80) */
+    delay?: number;
+}
+export interface WaitScene extends SceneBase {
+    type: 'wait';
+    /** CSS selector to wait for */
+    selector: string;
+    /** Max wait time in ms (default: 5000) */
+    timeout?: number;
+}
+export type Scene = ScrollScene | PauseScene | HoverScene | ClickScene | TypeScene | WaitScene;
+export interface CursorConfig {
+    /** Show a visible cursor in the video (default: true) */
+    enabled: boolean;
+    /** Cursor style */
+    style?: 'dot' | 'arrow' | 'pointer' | 'custom';
+    /** Cursor color (CSS color string) */
+    color?: string;
+    /** Cursor size in px (default: 20) */
+    size?: number;
+    /** Show click animation (default: true) */
+    clickAnimation?: boolean;
+}
+export type VideoCodec = 'h264' | 'h265' | 'vp9';
+export type VideoFormat = 'mp4' | 'webm';
+export interface EncodingConfig {
+    /** Video codec (default: h264) */
+    codec?: VideoCodec;
+    /** Output format (default: mp4) */
+    format?: VideoFormat;
+    /** Constant Rate Factor — quality (0=lossless, 51=worst). Default: 18 */
+    crf?: number;
+    /** Encoding preset (default: slow for best quality) */
+    preset?: 'ultrafast' | 'fast' | 'medium' | 'slow' | 'veryslow';
+    /** Frames per second (default: 60) */
+    fps?: number;
+}
+export interface RecordingConfig {
+    /** URL to record */
+    url: string;
+    /** Output file path (without extension — auto-determined) */
+    outputPath: string;
+    /** Viewport preset or custom dimensions */
+    viewport?: ViewportPreset | ViewportConfig;
+    /** Frames per second (default: 60) */
+    fps?: number;
+    /** Scene definitions — if empty, does a default full-page scroll */
+    scenes?: Scene[];
+    /** Cursor configuration */
+    cursor?: CursorConfig;
+    /** Video encoding settings */
+    encoding?: EncodingConfig;
+    /** Dismiss cookie banners and overlays (default: true) */
+    dismissOverlays?: boolean;
+    /** Pre-scroll to trigger lazy loading (default: true) */
+    preloadContent?: boolean;
+    /** Device scale factor for retina (default: 1) */
+    deviceScaleFactor?: number;
+    /** Dark mode (default: false) */
+    darkMode?: boolean;
+    /** Custom user agent */
+    userAgent?: string;
+    /** Disable smooth scroll CSS to prevent double-easing (default: true) */
+    disableSmoothScroll?: boolean;
+}
+export interface RecordingResult {
+    success: boolean;
+    video: {
+        path: string;
+        format: string;
+        codec: string;
+        fps: number;
+        duration: number;
+        totalFrames: number;
+        resolution: {
+            width: number;
+            height: number;
+        };
+        sizeBytes: number;
+        sizeMB: string;
+    };
+    thumbnail?: {
+        path: string;
+        width: number;
+        height: number;
+    };
+    scenes: number;
+    url: string;
+    captureTime: string;
+}

package/dist/tools/engine/types.js

@@ -0,0 +1,13 @@
+/**
+ * Type definitions for the Cinema Video Engine
+ */
+// ─── Viewport Presets ───────────────────────────────────────────────
+export const VIEWPORTS = {
+    desktop: { width: 1920, height: 1080 },
+    'desktop-4k': { width: 3840, height: 2160 },
+    tablet: { width: 768, height: 1024 },
+    'tablet-landscape': { width: 1024, height: 768 },
+    mobile: { width: 393, height: 852 },
+    'mobile-landscape': { width: 852, height: 393 },
+};
+//# sourceMappingURL=types.js.map

package/dist/tools/engine/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tools/engine/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,uEAAuE;AACvE,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;IACtC,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;IAC3C,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;IACpC,kBAAkB,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;IAChD,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE;IACnC,kBAAkB,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE;CACvC,CAAC"}

package/dist/tools/engine/voice-effects.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Voice Effects Engine — 9 audio effects via FFmpeg filter chains.
+ *
+ * Effects: echo, reverb, deep, chipmunk, robot, whisper, radio, megaphone, underwater.
+ * Works on both audio files and video files (preserves video stream).
+ */
+export type VoiceEffect = 'echo' | 'reverb' | 'deep' | 'chipmunk' | 'robot' | 'whisper' | 'radio' | 'megaphone' | 'underwater';
+export interface VoiceEffectConfig {
+    inputPath: string;
+    outputPath: string;
+    /** Voice effect to apply */
+    effect: VoiceEffect;
+    /** Intensity 0.0-1.0 (default: 0.5). Controls how strong the effect is. */
+    intensity?: number;
+}
+export declare const ALL_VOICE_EFFECTS: VoiceEffect[];
+export declare const VOICE_EFFECT_DESCRIPTIONS: Record<VoiceEffect, string>;
+export declare function applyVoiceEffect(config: VoiceEffectConfig): Promise<string>;