@studiomeyer/mcp-video 1.0.0

package/dist/tools/engine/capture.js

@@ -0,0 +1,290 @@
+/**
+ * Frame-by-Frame Capture Engine
+ * The core of cinema-grade website video recording
+ *
+ * Pipeline: Playwright → Frame Screenshots → ffmpeg → MP4
+ * Result: Perfect 60fps video with zero frame drops
+ */
+import { chromium } from 'playwright';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { logger } from '../../lib/logger.js';
+import { VIEWPORTS } from './types.js';
+import { injectCursor, hideCursor } from './cursor.js';
+import { executeScenes, createDefaultScenes } from './scenes.js';
+import { encodeFrames, cleanupFrames } from './encoder.js';
+const OUTPUT_DIR = process.env.VIDEO_OUTPUT_DIR || './output';
+/**
+ * Record a website with cinema-quality frame-by-frame capture
+ */
+export async function recordWebsite(config) {
+    const { url, outputPath = path.join(OUTPUT_DIR, `website-video-${Date.now()}`), fps = 60, scenes: userScenes, cursor = { enabled: true }, encoding = {}, dismissOverlays = true, preloadContent = true, deviceScaleFactor = 1, darkMode = false, disableSmoothScroll = true, } = config;
+    // Resolve viewport
+    const viewport = typeof config.viewport === 'string'
+        ? VIEWPORTS[config.viewport] ?? VIEWPORTS.desktop
+        : config.viewport ?? VIEWPORTS.desktop;
+    // Create temp directory for frames
+    const framesDir = fs.mkdtempSync(path.join(os.tmpdir(), 'cinema-frames-'));
+    const framePattern = 'frame_%06d.png';
+    let browser;
+    let totalFrames = 0;
+    const startTime = Date.now();
+    try {
+        logger.info(`Starting cinema capture: ${url} (${viewport.width}x${viewport.height}, ${fps}fps)`);
+        // ─── 1. Launch Browser ────────────────────────────────────────
+        browser = await chromium.launch({
+            headless: true,
+            args: [
+                '--no-sandbox',
+                '--disable-setuid-sandbox',
+                '--disable-dev-shm-usage',
+                '--disable-gpu',
+                '--disable-web-security',
+                '--hide-scrollbars',
+            ],
+        });
+        const contextOptions = {
+            viewport: { width: viewport.width, height: viewport.height },
+            deviceScaleFactor,
+            colorScheme: darkMode ? 'dark' : 'light',
+        };
+        // Mobile user agent
+        if (config.viewport === 'mobile' || config.viewport === 'mobile-landscape') {
+            contextOptions.userAgent = config.userAgent ??
+                'Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.0 Mobile/15E148 Safari/604.1';
+            contextOptions.isMobile = true;
+            contextOptions.hasTouch = true;
+        }
+        else if (config.userAgent) {
+            contextOptions.userAgent = config.userAgent;
+        }
+        const context = await browser.newContext(contextOptions);
+        const page = await context.newPage();
+        // ─── 2. Navigate to URL ───────────────────────────────────────
+        logger.info(`Navigating to ${url}...`);
+        await page.goto(url, { waitUntil: 'networkidle', timeout: 30000 }).catch(async () => {
+            // Fallback: try with just domcontentloaded
+            await page.goto(url, { waitUntil: 'domcontentloaded', timeout: 30000 });
+        });
+        // Wait for content to render
+        await page.waitForTimeout(2000);
+        // ─── 3. Prepare Page ──────────────────────────────────────────
+        // Disable CSS smooth scroll to prevent double-easing
+        if (disableSmoothScroll) {
+            await page.addStyleTag({
+                content: `*, html { scroll-behavior: auto !important; }`,
+            });
+        }
+        // Hide scrollbar
+        await page.addStyleTag({
+            content: `::-webkit-scrollbar { display: none !important; } * { scrollbar-width: none !important; }`,
+        });
+        // Dismiss overlays and cookie banners
+        if (dismissOverlays) {
+            await dismissPageOverlays(page);
+            // Wait for animations to complete (e.g. Framer Motion exit)
+            await page.waitForTimeout(1000);
+        }
+        // ─── 4. Pre-scroll to trigger lazy loading ────────────────────
+        if (preloadContent) {
+            await preloadAllContent(page, viewport.height);
+        }
+        // ─── 5. Inject cursor overlay ─────────────────────────────────
+        if (cursor.enabled) {
+            await injectCursor(page, cursor);
+        }
+        // Scroll back to top
+        await page.evaluate(() => window.scrollTo(0, 0));
+        await page.waitForTimeout(500);
+        // ─── 6. Execute scenes & capture frames ───────────────────────
+        const scenes = userScenes && userScenes.length > 0
+            ? userScenes
+            : createDefaultScenes();
+        logger.info(`Executing ${scenes.length} scene(s)...`);
+        let frameIndex = 0;
+        totalFrames = await executeScenes(page, scenes, fps, async (_fi) => {
+            const framePath = path.join(framesDir, `frame_${String(frameIndex).padStart(6, '0')}.png`);
+            await page.screenshot({ path: framePath, type: 'png' });
+            frameIndex++;
+            // Progress logging every 60 frames (= 1 second at 60fps)
+            if (frameIndex % fps === 0) {
+                logger.info(`Captured ${frameIndex} frames (${(frameIndex / fps).toFixed(1)}s)`);
+            }
+        }, cursor.enabled);
+        // Hide cursor for final frame
+        if (cursor.enabled) {
+            await hideCursor(page);
+        }
+        // Take thumbnail from first frame position
+        await page.evaluate(() => window.scrollTo(0, 0));
+        await page.waitForTimeout(300);
+        const thumbnailBuffer = await page.screenshot({ type: 'png' });
+        const thumbnailPath = `${outputPath}-thumbnail.png`;
+        const thumbnailDir = path.dirname(thumbnailPath);
+        if (!fs.existsSync(thumbnailDir)) {
+            fs.mkdirSync(thumbnailDir, { recursive: true });
+        }
+        fs.writeFileSync(thumbnailPath, thumbnailBuffer);
+        // ─── 7. Close browser ─────────────────────────────────────────
+        await context.close();
+        await browser.close();
+        browser = undefined;
+        logger.info(`Capture complete: ${totalFrames} frames in ${((Date.now() - startTime) / 1000).toFixed(1)}s`);
+        // ─── 8. Encode video ──────────────────────────────────────────
+        logger.info('Encoding video with ffmpeg...');
+        const encodeResult = await encodeFrames(framesDir, framePattern, outputPath, totalFrames, { ...encoding, fps });
+        // ─── 9. Cleanup frames ────────────────────────────────────────
+        cleanupFrames(framesDir);
+        const captureTimeSec = ((Date.now() - startTime) / 1000).toFixed(1);
+        logger.info(`Video ready: ${encodeResult.outputPath} (${encodeResult.sizeMB} MB, ${captureTimeSec}s total)`);
+        return {
+            success: true,
+            video: {
+                path: encodeResult.outputPath,
+                format: encodeResult.format,
+                codec: encodeResult.codec,
+                fps: encodeResult.fps,
+                duration: encodeResult.duration,
+                totalFrames: encodeResult.totalFrames,
+                resolution: { width: viewport.width, height: viewport.height },
+                sizeBytes: encodeResult.sizeBytes,
+                sizeMB: encodeResult.sizeMB,
+            },
+            thumbnail: {
+                path: thumbnailPath,
+                width: viewport.width,
+                height: viewport.height,
+            },
+            scenes: scenes.length,
+            url,
+            captureTime: `${captureTimeSec}s`,
+        };
+    }
+    catch (error) {
+        // Cleanup on error
+        cleanupFrames(framesDir);
+        if (browser) {
+            try {
+                await browser.close();
+            }
+            catch { /* ignore */ }
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        logger.error(`Recording failed: ${message}`);
+        throw new Error(`Recording failed: ${message}`);
+    }
+}
+/**
+ * Dismiss cookie banners, fixed overlays, and popups
+ * Uses multiple strategies: localStorage pre-set, button clicks, CSS hiding
+ */
+async function dismissPageOverlays(page) {
+    logger.info('Dismissing overlays and cookie banners...');
+    // Strategy 1: Pre-set common cookie consent localStorage/cookie values
+    // This prevents banners from appearing in the first place
+    await page.evaluate(() => {
+        // Common cookie consent localStorage key
+        localStorage.setItem('cookie-consent', 'accepted');
+        // Common cookie consent libraries
+        localStorage.setItem('cookieConsent', 'accepted');
+        localStorage.setItem('cookie_consent', 'true');
+        localStorage.setItem('cookies-accepted', 'true');
+        localStorage.setItem('gdpr-consent', 'true');
+        localStorage.setItem('CookieConsent', 'true');
+        // CookieBot
+        localStorage.setItem('CookieConsentV2', '{"stamp":"","necessary":true,"preferences":true,"statistics":true,"marketing":true}');
+        // OneTrust
+        localStorage.setItem('OptanonAlertBoxClosed', new Date().toISOString());
+        // Set cookies too
+        document.cookie = 'cookie-consent=accepted; path=/; max-age=31536000';
+        document.cookie = 'cookieconsent_status=dismiss; path=/; max-age=31536000';
+        // Dispatch custom consent event
+        window.dispatchEvent(new Event('cookie-consent-accepted'));
+    });
+    await page.waitForTimeout(300);
+    // Strategy 2: Try clicking accept buttons (multilingual)
+    const acceptButtonSelectors = [
+        // By text content (most reliable)
+        'button:has-text("Akzeptieren")',
+        'button:has-text("Accept")',
+        'button:has-text("Aceptar")',
+        'button:has-text("Accept all")',
+        'button:has-text("Alle akzeptieren")',
+        'button:has-text("Got it")',
+        'button:has-text("OK")',
+        'button:has-text("Verstanden")',
+    ];
+    for (const selector of acceptButtonSelectors) {
+        try {
+            const btn = page.locator(selector).first();
+            if (await btn.isVisible({ timeout: 500 }).catch(() => false)) {
+                await btn.click({ timeout: 1000 });
+                logger.info(`Clicked consent button: ${selector}`);
+                break;
+            }
+        }
+        catch {
+            // Button not found, try next
+        }
+    }
+    // Strategy 3: Click by CSS selectors (fallback)
+    await page.evaluate(() => {
+        const cssSelectors = [
+            '[class*="cookie"] button',
+            '[class*="consent"] button',
+            '[id*="cookie"] button',
+            '[id*="consent"] button',
+            'button[class*="accept"]',
+            'button[class*="Accept"]',
+            '[data-testid*="cookie"] button',
+        ];
+        for (const sel of cssSelectors) {
+            const btn = document.querySelector(sel);
+            if (btn) {
+                btn.click();
+                break;
+            }
+        }
+    });
+    await page.waitForTimeout(500);
+    // Strategy 4: Force hide any remaining overlays via CSS
+    await page.addStyleTag({
+        content: `
+      [class*="cookie"], [class*="Cookie"],
+      [class*="consent"], [class*="Consent"],
+      [class*="popup"]:not([class*="menu"]),
+      [class*="Popup"]:not([class*="menu"]),
+      [id*="cookie"], [id*="consent"],
+      [role="dialog"],
+      [class*="banner"]:not(header):not(nav):not([class*="hero"]),
+      .fixed.bottom-0.left-0.right-0.z-50 {
+        display: none !important;
+        visibility: hidden !important;
+        opacity: 0 !important;
+        pointer-events: none !important;
+      }
+    `,
+    });
+    logger.info('Overlays dismissed');
+}
+/**
+ * Pre-scroll entire page to trigger all lazy-loaded content
+ */
+async function preloadAllContent(page, viewportHeight) {
+    logger.info('Pre-scrolling to trigger lazy content...');
+    const scrollHeight = await page.evaluate(() => document.documentElement.scrollHeight);
+    const steps = Math.ceil(scrollHeight / (viewportHeight * 0.7));
+    for (let i = 0; i <= steps; i++) {
+        const y = Math.min(i * viewportHeight * 0.7, scrollHeight);
+        await page.evaluate((scrollY) => window.scrollTo(0, scrollY), y);
+        await page.waitForTimeout(200);
+        // Wait for any network requests to settle
+        await page.waitForLoadState('networkidle').catch(() => { });
+    }
+    // Scroll back to top
+    await page.evaluate(() => window.scrollTo(0, 0));
+    await page.waitForTimeout(500);
+    logger.info('Lazy content preloaded');
+}
+//# sourceMappingURL=capture.js.map

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

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

package/dist/tools/engine/chroma-key.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Chroma Key Engine — Green screen removal and background replacement.
+ *
+ * Supports:
+ * - chromakey (YUV space, best for green/blue screens)
+ * - colorkey (RGB space, best for arbitrary key colors)
+ * - despill (removes green/blue color spill on edges)
+ * - Composite onto replacement background (video, image, or solid color)
+ */
+export interface ChromaKeyConfig {
+    /** Input video with green/blue screen */
+    inputPath: string;
+    outputPath: string;
+    /** Key color in hex (e.g., '00FF00' for green, '0000FF' for blue). Default: 00FF00 */
+    keyColor?: string;
+    /** How close a color must be to the key: 0.01-1.0. Higher = more removal. Default: 0.15 */
+    similarity?: number;
+    /** Edge softness: 0.0-1.0. Keep low (0.0-0.08) or entire frame becomes transparent. Default: 0.02 */
+    blend?: number;
+    /** Enable despill to remove green/blue color contamination on edges. Default: true */
+    despill?: boolean;
+    /** Background replacement — video file, image file, or hex color (e.g., '000000' for black). Required. */
+    background: string;
+    /** Use colorkey (RGB) instead of chromakey (YUV). Default: false (chromakey) */
+    useColorkey?: boolean;
+}
+export declare function applyChromaKey(config: ChromaKeyConfig): Promise<string>;

package/dist/tools/engine/chroma-key.js

@@ -0,0 +1,154 @@
+/**
+ * Chroma Key Engine — Green screen removal and background replacement.
+ *
+ * Supports:
+ * - chromakey (YUV space, best for green/blue screens)
+ * - colorkey (RGB space, best for arbitrary key colors)
+ * - despill (removes green/blue color spill on edges)
+ * - Composite onto replacement background (video, image, or solid color)
+ */
+import { execFile } from 'child_process';
+import * as fs from 'fs';
+import * as path from 'path';
+import { logger } from '../../lib/logger.js';
+// ─── Helpers ────────────────────────────────────────────────────────
+function runFfmpeg(args, timeoutMs = 300_000) {
+    return new Promise((resolve, reject) => {
+        execFile('ffmpeg', args, { maxBuffer: 100 * 1024 * 1024, timeout: timeoutMs }, (error, stdout, stderr) => {
+            if (error) {
+                logger.error(`ffmpeg failed: ${stderr}`);
+                reject(new Error(`ffmpeg failed: ${stderr || error.message}`));
+                return;
+            }
+            resolve(stdout);
+        });
+    });
+}
+function ensureDir(filePath) {
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir))
+        fs.mkdirSync(dir, { recursive: true });
+}
+function assertExists(filePath, label = 'File') {
+    if (!fs.existsSync(filePath))
+        throw new Error(`${label} not found: ${filePath}`);
+}
+function fileInfo(filePath) {
+    const stats = fs.statSync(filePath);
+    return `${(stats.size / 1024 / 1024).toFixed(2)} MB`;
+}
+function isHexColor(s) {
+    return /^[0-9a-fA-F]{6}$/.test(s);
+}
+function isImageFile(filePath) {
+    const ext = path.extname(filePath).toLowerCase();
+    return ['.png', '.jpg', '.jpeg', '.webp', '.bmp', '.tiff'].includes(ext);
+}
+// ─── Main Function ──────────────────────────────────────────────────
+export async function applyChromaKey(config) {
+    const { inputPath, outputPath, keyColor = '00FF00', similarity = 0.15, blend = 0.02, despill: enableDespill = true, background, useColorkey = false, } = config;
+    assertExists(inputPath, 'Input video');
+    ensureDir(outputPath);
+    // Validate key color
+    const cleanColor = keyColor.replace(/^#|^0x/, '');
+    if (!isHexColor(cleanColor)) {
+        throw new Error(`Invalid key color: ${keyColor}. Use 6-digit hex (e.g., 00FF00 for green)`);
+    }
+    const sim = Math.max(0.01, Math.min(1, similarity));
+    const bld = Math.max(0, Math.min(0.1, blend)); // Cap at 0.1 to prevent full-frame transparency
+    logger.info(`Chroma key: color=0x${cleanColor}, sim=${sim}, blend=${bld}, despill=${enableDespill}, mode=${useColorkey ? 'colorkey' : 'chromakey'}`);
+    // Build the keying filter
+    const keyFilter = useColorkey
+        ? `colorkey=0x${cleanColor}:${sim}:${bld}`
+        : `chromakey=0x${cleanColor}:${sim}:${bld}`;
+    // Optional despill
+    const despillFilter = enableDespill
+        ? getDespillFilter(cleanColor)
+        : '';
+    const fgFilter = despillFilter
+        ? `${keyFilter},${despillFilter}`
+        : keyFilter;
+    // Determine background type
+    const isSolidColor = isHexColor(background.replace(/^#|^0x/, ''));
+    const isImage = !isSolidColor && isImageFile(background);
+    const isVideo = !isSolidColor && !isImage;
+    if (isVideo)
+        assertExists(background, 'Background video');
+    if (isImage)
+        assertExists(background, 'Background image');
+    let args;
+    if (isSolidColor) {
+        // Solid color background — use color source
+        const bgColor = background.replace(/^#|^0x/, '');
+        const filterComplex = [
+            `color=c=0x${bgColor}:s=1920x1080:r=30[bg]`,
+            `[0:v]${fgFilter}[fg]`,
+            `[bg][fg]overlay=shortest=1[out]`,
+        ].join(';');
+        args = [
+            '-y', '-i', inputPath,
+            '-filter_complex', filterComplex,
+            '-map', '[out]', '-map', '0:a?',
+            '-c:v', 'libx264', '-crf', '18', '-preset', 'medium',
+            '-pix_fmt', 'yuv420p', '-movflags', '+faststart',
+            outputPath,
+        ];
+    }
+    else if (isImage) {
+        // Image background — use loop to make it a stream
+        const filterComplex = [
+            `[1:v]${fgFilter}[fg]`,
+            `[0:v][fg]overlay=shortest=1[out]`,
+        ].join(';');
+        args = [
+            '-y',
+            '-loop', '1', '-i', background,
+            '-i', inputPath,
+            '-filter_complex', filterComplex,
+            '-map', '[out]', '-map', '1:a?',
+            '-c:v', 'libx264', '-crf', '18', '-preset', 'medium',
+            '-pix_fmt', 'yuv420p', '-movflags', '+faststart',
+            '-shortest',
+            outputPath,
+        ];
+    }
+    else {
+        // Video background
+        const filterComplex = [
+            `[1:v]${fgFilter}[fg]`,
+            `[0:v][fg]overlay=shortest=1[out]`,
+        ].join(';');
+        args = [
+            '-y',
+            '-i', background,
+            '-i', inputPath,
+            '-filter_complex', filterComplex,
+            '-map', '[out]', '-map', '1:a?',
+            '-c:v', 'libx264', '-crf', '18', '-preset', 'medium',
+            '-pix_fmt', 'yuv420p', '-movflags', '+faststart',
+            '-shortest',
+            outputPath,
+        ];
+    }
+    await runFfmpeg(args, 600_000); // Longer timeout for compositing
+    logger.info(`Chroma key applied: ${outputPath} (${fileInfo(outputPath)})`);
+    return outputPath;
+}
+/** Get despill filter based on key color */
+function getDespillFilter(hexColor) {
+    const r = parseInt(hexColor.substring(0, 2), 16);
+    const g = parseInt(hexColor.substring(2, 4), 16);
+    const b = parseInt(hexColor.substring(4, 6), 16);
+    // Determine dominant channel for despill
+    if (g > r && g > b) {
+        // Green screen — despill green
+        return 'despill=type=0:mix=0.5:green=-1';
+    }
+    else if (b > r && b > g) {
+        // Blue screen — despill blue
+        return 'despill=type=0:mix=0.5:blue=-1';
+    }
+    // For other colors, skip despill
+    return '';
+}
+//# sourceMappingURL=chroma-key.js.map

package/dist/tools/engine/chroma-key.js.map

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

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

@@ -0,0 +1,49 @@
+/**
+ * Video concatenation engine — merge multiple clips with cinematic transitions
+ */
+export declare const TRANSITIONS: readonly ["fade", "fadeblack", "fadewhite", "dissolve", "wipeleft", "wiperight", "wipeup", "wipedown", "slideleft", "slideright", "slideup", "slidedown", "smoothleft", "smoothright", "smoothup", "smoothdown", "circlecrop", "circleopen", "circleclose", "rectcrop", "vertopen", "vertclose", "horzopen", "horzclose", "diagtl", "diagtr", "diagbl", "diagbr", "hlslice", "hrslice", "vuslice", "vdslice", "radial", "pixelize"];
+export type TransitionType = typeof TRANSITIONS[number];
+export interface ConcatClip {
+    /** Path to video file */
+    path: string;
+    /** Optional: trim start time (seconds) */
+    trimStart?: number;
+    /** Optional: trim end time (seconds) */
+    trimEnd?: number;
+}
+export interface ConcatConfig {
+    /** Video clips to concatenate (in order) */
+    clips: ConcatClip[];
+    /** Output path */
+    outputPath: string;
+    /** Transition between clips (default: fade) */
+    transition?: TransitionType;
+    /** Transition duration in seconds (default: 1) */
+    transitionDuration?: number;
+    /** Normalize all clips to this resolution (default: 1920x1080) */
+    targetWidth?: number;
+    targetHeight?: number;
+    /** Target FPS (default: 60) */
+    targetFps?: number;
+}
+export declare function concatenateVideos(config: ConcatConfig): Promise<string>;
+export interface IntroConfig {
+    /** Text to display */
+    text: string;
+    /** Subtitle (optional) */
+    subtitle?: string;
+    /** Duration in seconds (default: 3) */
+    duration?: number;
+    /** Background color (default: #0a0a0a) */
+    backgroundColor?: string;
+    /** Text color (default: white) */
+    textColor?: string;
+    /** Resolution */
+    width?: number;
+    height?: number;
+    /** FPS (default: 60) */
+    fps?: number;
+    /** Output path */
+    outputPath: string;
+}
+export declare function generateIntro(config: IntroConfig): Promise<string>;