pastorsimon1798/mcp-video

Накладывает несколько аудиодорожек друг на друга с регулировкой громкости. Микширует несколько WAV-файлов с индивидуальным контролем громкости. Аргументы: tracks: Список конфигураций дорожек: - file: Абсолютный путь к WAV-файлу - volume: Множитель громкости 0-1 - start: Смещение по времени начала в секундах - loop: Зациклить ли дорожку (по умолчанию false) duration: Общая длительность выходного сигнала в секундах. output_path: Абсолютный путь для выходного WAV-файла. Результат: Словарь со статусом успеха и output_path.

Применить цепочку аудиоэффектов к WAV-файлу. Обработать аудио через цепочку эффектов: реверберация, фильтрация, нормализация. Аргументы: input_path: Абсолютный путь к входному WAV-файлу. output_path: Абсолютный путь для выходного WAV-файла. effects: Список конфигураций эффектов с: - type: "lowpass", "reverb", "normalize", "fade" - Дополнительные параметры для каждого типа эффекта Возвращает: Словарь с статусом успеха и output_path.

Generate preset sound design elements. Pre-configured sound effects for common use cases. No external audio files needed. Available presets: - UI: ui-blip, ui-click, ui-tap, ui-whoosh-up, ui-whoosh-down - Ambient: drone-low, drone-mid, drone-tech - Notifications: chime-success, chime-error, chime-notification - Data: typing, scan, processing, data-flow Args: preset: Preset name from the list above. output_path: Absolute path for the output WAV file. pitch: Pitch variation (low, mid, high). Default mid. duration: Override default duration (seconds). intensity: Effect intensity 0-1. Default 0.5. Returns: Dict with success status and output_path.

Compose multiple audio events into a timed sequence. Creates a layered audio track from multiple timed sound events. Args: sequence: List of audio events, each with: - type: "tone", "preset", or "whoosh" - at: Start time in seconds - duration: Event duration in seconds - freq/frequency: For tones (Hz) - name: For presets (preset name) - volume: 0-1 amplitude - waveform: For tones (sine, square, etc.) output_path: Absolute path for the output WAV file. Returns: Dict with success status and output_path.

Generate audio procedurally using synthesis. Creates WAV files from scratch using mathematical waveforms. No external audio files needed. Supports envelopes, reverb, filtering, and fade effects. Args: output_path: Absolute path for the output WAV file. waveform: Waveform type (sine, square, sawtooth, triangle, noise). Default sine. frequency: Base frequency in Hz. Default 440 (A4 note). duration: Duration in seconds. Default 1.0. volume: Amplitude 0-1. Default 0.5. effects: Optional effects dict with keys: - envelope: {"attack", "decay", "sustain", "release"} in seconds - fade_in: Fade in duration in seconds - fade_out: Fade out duration in seconds - reverb: {"room_size", "damping", "wet_level"} - lowpass: Cutoff frequency in Hz Returns: Dict with success status and output_path.

Применение хроматической аберрации - разделение RGB-каналов. Создает модный RGB-эффект расщепления, популярный в техно/глитч-эстетике. Аргументы: input_path: абсолютный путь к входному видео. output_path: абсолютный путь для выходного видео. intensity: величина смещения в пикселях. По умолчанию 2.0. angle: направление разделения в градусах. По умолчанию 0 (горизонтально). Возвращает: Словарь с статусом выполнения и output_path.

Применить bloom/glow эффект для ярких участков. Создает мягкое свечение вокруг ярких областей видео. Аргументы: input_path: абсолютный путь к входному видео. output_path: абсолютный путь для выходного видео. intensity: интенсивность свечения 0-1. По умолчанию 0.5. radius: радиус размытия в пикселях. По умолчанию 10. threshold: порог яркости 0-1. По умолчанию 0.7. Возвращает: Словарь со статусом успеха и output_path.

Применяет зернистость плёнки или цифровой шум. Добавляет текстурный шум к видео для винтажной или lo-fi эстетики. Args: input_path: Абсолютный путь к входному видео. output_path: Абсолютный путь для выходного видео. intensity: Степень шума от 0 до 1. По умолчанию 0.05. mode: Тип шума (film, digital, color). По умолчанию film. animated: Меняется ли шум от кадра к кадру. По умолчанию true. Returns: Словарь с статусом успеха и output_path.

Накладывает оверлей в стиле CRT-сканирования. Имитирует эффект растровых линий старого CRT-монитора с возможностью мерцания. Аргументы: input_path: Абсолютный путь к входному видео. output_path: Абсолютный путь для выходного видео. line_height: Пикселей на строку развёртки. По умолчанию 2. opacity: Непрозрачность линий от 0 до 1. По умолчанию 0.3. flicker: Изменение яркости от 0 до 1. По умолчанию 0.1. Возвращает: Словарь с признаком успеха и output_path.

Применяет эффект виньетки - затемняет края. Создаёт затемнённую окантовку, которая привлекает внимание к центру кадра. Аргументы: input_path: Абсолютный путь к входному видео. output_path: Абсолютный путь для выходного видео. intensity: Степень затемнения, от 0 до 1. По умолчанию 0.5. radius: Радиус виньетки, от 0 до 1 (1 - край кадра). По умолчанию 0.8. smoothness: Мягкость края, от 0 до 1. По умолчанию 0.5. Возвращает: Словарь со статусом выполнения и output_path.

Применяет эффект CMYK-глитча с разделением. Сдвигает RGB-каналы с интервалом 90 градусов, имитируя ошибки совмещения четырёхпластинчатой офсетной печати. Аргументы: input_path: Абсолютный путь к входному видео. output_path: Абсолютный путь для выходного видео. amount: Расстояние сдвига в пикселях. По умолчанию 8. angle: Базовый угол в градусах. По умолчанию 0. noise: Амплитуда шума на кадр (от 0 до 1). По умолчанию 0. Возвращает: Словарь со статусом выполнения и output_path.

Применяет эффект datamoshing-глитча. Имитирует повреждение P-кадров, при котором смещение накапливается между кадрами, а затем периодически сбрасывается, воспроизводя настоящие артефакты datamosh. Аргументы: input_path: Абсолютный путь к входному видео. output_path: Абсолютный путь для выходного видео. drift: Максимальная величина смещения в пикселях. По умолчанию 20. iframe_interval: Интервал кадров для сброса смещения. По умолчанию 30. Возвращает: Словарь с флагом успеха и output_path.

Применяет эффект точечного сплэттинга на основе глубины (требуется Node.js + GPU). Извлекает псевдоглубину из яркости и отображает изображение в виде рассеянных точек, создавая трёхмерный вид, похожий на частицы. Аргументы: input_path: Абсолютный путь к входному видео. output_path: Абсолютный путь для выходного видео. depth_scale: Интенсивность извлечения глубины. По умолчанию 1.0. spread: Расстояние разброса точек в пикселях. По умолчанию 10.0. point_size: Размер каждой сплэттированной точки. По умолчанию 3.0. threshold: Порог отсечения глубины (0-1). По умолчанию 0.5. Возвращает: Dict с статусом успеха и output_path.

Применяет эффект глюка с цифровой обратной связью (требуется Node.js + GPU). Покадровая обратная связь с трансформацией масштаба/поворота. Каждый кадр смешивается с масштабированной и повёрнутой версией предыдущего выхода, создавая призрачные шлейфы и рекурсивные визуальные паттерны. Аргументы: input_path: Абсолютный путь к входному видео. output_path: Абсолютный путь для выходного видео. feedback_mix: Смешивание текущего кадра и обратной связи (0-1). По умолчанию 0.5. scale: Масштаб UV для предыдущего кадра. По умолчанию 1.0. rotation: Поворот в градусах. По умолчанию 0.0. decay: Прозрачность призрачного шлейфа (0-1). По умолчанию 0.9. Возвращает: Словарь со статусом успеха и output_path.

Применить эффект макроблокинга (глитч). Имитирует артефакты кодека: уменьшает и увеличивает разрешение, создавая блочную пикселизацию в сочетании с постеризацией цвета. Args: input_path: Абсолютный путь к входному видео. output_path: Абсолютный путь для выходного видео. block_size: Размер блока в пикселях. По умолчанию 16. intensity: Наложение с оригиналом (0-1). По умолчанию 0.7. color_reduction: Снижение цветового уровня (0-1). По умолчанию 0.3. Returns: Dict с состоянием успеха и output_path.

Примени эффект рендеринга облака точек (требуется Node.js + GPU). Сэмплирует изображение как разбросанные точки, расположенные в 3D-повёрнутой сетке, со смещением по глубине, создающим объёмный вид. Аргументы: input_path: Абсолютный путь к входному видео. output_path: Абсолютный путь к выходному видео. density: Плотность сэмплирования точек (0-1). По умолчанию 0.5. point_size: Размер каждой точки. По умолчанию 2.0. rotation: Угол 3D-поворота в градусах. По умолчанию 0.0. depth: Интенсивность смещения по глубине. По умолчанию 1.0. Возвращает: Словарь с успешным статусом и output_path.

Применяет эффект глитча со смещением каналов RGB. Сдвигает красный и синий каналы в противоположные стороны для эффекта хроматического расщепления. Опционально добавляет покадровый шум для дрожащего эффекта. Аргументы: input_path: Абсолютный путь к входному видео. output_path: Абсолютный путь для выходного видео. amount: Расстояние сдвига в пикселях. По умолчанию 10.0. angle: Направление сдвига в градусах. По умолчанию 0 (горизонтальное). noise: Амплитуда покадрового шума (0-1). По умолчанию 0. Возвращает: Словарь со статусом успеха и путем output_path.

Применяет эффект глитча с дрожанием строк развёртки. Смещает случайные горизонтальные строки пикселей, имитируя неисправность ЭЛТ. Аргументы: input_path: Абсолютный путь к входному видео. output_path: Абсолютный путь для выходного видео. jitter_amount: Максимальное горизонтальное смещение в пикселях. По умолчанию 15. frequency: Доля строк, к которым применяется эффект (0-1). По умолчанию 0.3. speed: Множитель скорости анимации. По умолчанию 5. row_height: Высота каждой полосы дрожания в пикселях. По умолчанию 4. Возвращает: Словарь с флагом успеха и output_path.

Применяет эффект разрыва экрана (screen tearing). Создаёт горизонтальные полосы разрыва на разных позициях Y, которые смещаются влево/вправо с течением времени. Аргументы: input_path: абсолютный путь к входному видео. output_path: абсолютный путь к выходному видео. tear_count: количество полос разрыва. По умолчанию 5. offset_range: максимальное горизонтальное смещение в пикселях. По умолчанию 80. speed: скорость анимации. По умолчанию 3. Возвращает: Словарь со статусом успеха и output_path.

Применить эффект временного смещения slit-scan (требуется Node.js + GPU). Каждая строка/столбец выходного изображения берется из разных прошлых кадров, создавая эффект размытия во времени, напоминающий slit-scan фотографию. Args: input_path: Абсолютный путь к входному видео. output_path: Абсолютный путь для выходного видео. depth: Количество используемых прошлых кадров (1-120). По умолчанию 30. direction: 0=сверху вниз, 1=снизу вверх, 2=слева направо, 3=справа налево. По умолчанию 0. Returns: Словарь со статусом успеха и output_path.

Применяет эффект турбулентного смещения (глитч). Использует многослойные выражения sin/cos на разных частотах, чтобы аппроксимировать фрактальный шум броуновского движения для органичного смещения. Аргументы: input_path: Абсолютный путь к входному видео. output_path: Абсолютный путь для выходного видео. amount: Величина смещения в пикселях. По умолчанию 20. scale: Базовая частота шума. По умолчанию 0.01. speed: Скорость анимации. По умолчанию 1. octaves: Количество октав шума (1-5). По умолчанию 3. Возвращает: Словарь со статусом успеха и output_path.

Применяет эффект глюка из-за ошибки трекинга VHS. Имитирует проблемы трекинга VHS-ленты: цветовой размыв, полосы прокрутки и аналоговый шум. Аргументы: input_path: Абсолютный путь к входному видео. output_path: Абсолютный путь для выходного видео. tracking: Интенсивность ошибки трекинга (0-1). По умолчанию 0.5. noise_amount: Интенсивность VHS-шума (0-1). По умолчанию 0.03. color_bleed: Сдвиг красного канала в пикселях. По умолчанию 3. roll_speed: Скорость вертикальной прокрутки. По умолчанию 2. Возвращает: Словарь с статусом успеха и output_path.

Install a block from the Hyperframes catalog. Args: project_path: Absolute path to the Hyperframes project directory. block_name: Registry item name (e.g. claude-code-window, shader-wipe).

Протестируйте скорость рендеринга и размер файла Hyperframes.

Capture a website as editable Hyperframes components.

Browse Hyperframes catalog blocks/components.

List compositions in a Hyperframes project. Args: project_path: Absolute path to the Hyperframes project directory.

Запустить диагностику окружения Hyperframes.

Print Hyperframes project metadata.

Scaffold a new Hyperframes project. Args: name: Project name. output_dir: Directory to create the project in. Defaults to current directory. template: Project template (blank, warm-grain, swiss-grid). Default blank. video: Optional source video for project bootstrap. audio: Optional source audio for project bootstrap. skip_transcribe: Skip Whisper transcription during media bootstrap. model: Whisper model for transcription. language: Language code for transcription. tailwind: Add Tailwind CSS browser-runtime support. resolution: Hyperframes canvas resolution preset.

Inspect rendered composition layout for overflow and visual issues.

Launch Hyperframes preview studio for live preview. Args: project_path: Absolute path to the Hyperframes project directory. port: Port for the preview server (default 3002).

Удалите фон видео/изображения с помощью локального ИИ Hyperframes.

Render a Hyperframes composition to video. Args: project_path: Absolute path to the Hyperframes project directory. output_path: Where to save the video. Auto-generated if omitted. fps: Frame rate (24, 30, 60). width: Output width in pixels. height: Output height in pixels. quality: Render quality (draft, standard, high). Default standard. format: Output format (mp4, webm, mov, png-sequence). Default mp4. resolution: Hyperframes resolution preset (landscape, portrait, landscape-4k, portrait-4k, 1080p, 4k, uhd). composition: Specific composition file to render instead of index.html. workers: Parallel render workers (number or 'auto'). Default auto. crf: Override encoder CRF (lower = better quality). variables: Inline JSON object/string with runtime data for the composition. variables_file: Path to a JSON file with runtime data for the composition.

Capture key frames as PNG screenshots for visual verification.

Render a single frame as image from a Hyperframes composition. Args: project_path: Absolute path to the Hyperframes project directory. output_path: Where to save the image. Auto-generated if omitted. frame: Frame number to render (default 0). variables: Inline JSON object/string with runtime data for the composition. variables_file: Path to a JSON file with runtime data for the composition.

Render a Hyperframes composition and post-process with mcp-video in one step. Args: project_path: Absolute path to the Hyperframes project directory. post_process: List of post-processing operations, each with 'op' and 'params' keys. Example: [{"op": "resize", "params": {"aspect_ratio": "9:16"}}] output_path: Where to save the final output. Auto-generated if omitted.

Транскрибируйте аудио/видео с таймкодами на уровне слов или импортируйте стенограммы.

Generate speech audio or list available Hyperframes local TTS voices.

Validate a Hyperframes project for rendering readiness. Args: project_path: Absolute path to the Hyperframes project directory.

Анализирует изображение продукта или кадр видео - извлекает цвета и опционально генерирует AI-описание. Извлекает доминирующие цвета из изображения. Опционально использует Claude Vision для генерации описания продукта на естественном языке. Параметры: image_path: Абсолютный путь к файлу изображения или видео. Если видео, извлекается репрезентативный кадр. use_ai: Если True, использует Claude Vision для генерации описания (требуется ANTHROPIC_API_KEY). n_colors: Количество доминирующих цветов для извлечения (по умолчанию 5).

Извлекает доминирующие цвета из изображения или кадра видео. Использует K-means кластеризацию для поиска самых заметных цветов. Возвращает hex-коды, значения RGB, названия цветов CSS и процент покрытия. Аргументы: image_path: Абсолютный путь к файлу изображения или видео. Если видео, извлекает репрезентативный кадр. n_colors: Количество доминирующих цветов для извлечения (1-20, по умолчанию 5).

Создаёт палитру цветовой гармонии из изображения или кадра видео. Извлекает доминантный цвет и генерирует гармоничные цвета на основе теории цвета (complementary, analogous, triadic, split_complementary). Args: image_path: Абсолютный путь к файлу изображения или видео. Если указано видео, извлекает репрезентативный кадр. harmony: Тип гармонии (complementary, analogous, triadic, split_complementary). n_colors: Количество доминантных цветов для построения палитры (по умолчанию 5).

Ищет зарегистрированные MCP-инструменты по ключевому слову. Используйте этот инструмент, когда нужно найти подходящий инструмент для задачи, не читая описания каждого зарегистрированного инструмента. Возвращает подходящие инструменты с их названиями, описаниями и обязательными параметрами. Аргументы: query: Поисковый запрос, например, "blur", "resize", "subtitle", "audio", "trim".

Разворачивает один кадр раскадровки в строки prompt и negative_prompt. Аргументы: project_path: Абсолютный путь к каталогу проекта, содержащему style.md и storyboard.md. shot: Идентификатор кадра или номер строки (начиная с 1) из storyboard.md.

Читает таблицу раскадровки PUSHING CREATION из файла storyboard.md или из директории проекта. Аргументы: path: Абсолютный путь к storyboard.md или к директории проекта, содержащей storyboard.md.

Читает блоки `STYLE_` и `NEG_` из файла `style.md` или директории проекта. Аргументы: `path`: Абсолютный путь к `style.md` или к директории проекта, содержащей `style.md`.

Применить глитч-переход между двумя видеофрагментами. Аргументы: clip1_path: Абсолютный путь к первому видеофрагменту. clip2_path: Абсолютный путь ко второму видеофрагменту. output_path: Абсолютный путь для выходного видео. duration: Длительность перехода в секундах (по умолчанию 0.5). intensity: Интенсивность глитча от 0 до 1 (по умолчанию 0.3).

Примени морфинг-переход между двумя видеоклипами.

Применить пиксельный переход между двумя видеоклипами.

Оценивает вердикт по точному соответствию спецификации и доказательства дефектов, не утверждая ничего.

Add or mix video audio

Add, replace, or mix an audio file into an existing video and render a new output file. The source video and audio are read only; output_path is created or overwritten. Controls volume, fade-in, fade-out, mix/replace mode, and optional start time.

Добавляет процедурно сгенерированный звук к видео. Однократная вспомогательная функция для генерации и добавления звука к видео. Аргументы: input_path: Абсолютный путь к входному видео. audio_config: Словарь конфигурации звука: - drone: {"frequency", "volume"} - фоновый тон - events: список звуковых событий с временными метками output_path: Абсолютный путь для выходного видео. Возвращает: Словарь со статусом успеха и output_path.

Overlay text on a video (titles, captions, watermarks). Args: input_path: Absolute path to the input video. text: Text to overlay. position: Position on screen. Named (top-left, top-center, etc.), pixel" " {"x": 100, "y": 50}, or percentage {"x_pct": 0.5, "y_pct": 0.5}. font: Path to font file. Uses system default if omitted. size: Font size in pixels. color: Text color (CSS color name or hex). shadow: Add text shadow for readability. start_time: When the text appears (seconds). Null = always visible. duration: How long text is visible (seconds). Requires start_time. output_path: Where to save the output. Auto-generated if omitted. crf: Override CRF value (0-51, lower = better quality). Default 23. preset: Override FFmpeg encoding preset (ultrafast, fast, medium, slow, veryslow).

Overlay multiple text elements on a video in a single FFmpeg pass. Automatically detects overlapping text and distributes vertically stacked texts when they share the same named position. Args: input_path: Absolute path to the input video. texts: List of text overlay dicts. Each dict may contain: - text (str, required) - position (str|dict, default "center") - font (str, optional) - size (int, default 48) - color (str, default "white") - shadow (bool, default True) - start_time (float, optional) - duration (float, optional) output_path: Where to save the output. Auto-generated if omitted. crf: Override CRF value (0-51, lower = better quality). Default 23. preset: Override FFmpeg encoding preset (ultrafast, fast, medium, slow, veryslow). auto_layout: Automatically distribute vertically stacked texts at the same named position. Default True.

Apply a color grade to a video — by LUT file, style preset, or reference video. Args: input_path: Video file to grade. output_path: Where to write the graded video. reference_path: Optional reference video — when given, the video's color balance is adjusted to match the reference (overrides style). style: Style preset. One of: auto (gentle contrast lift), warm, cool, vintage, cinematic, dramatic, noir (high contrast, desaturated). lut_path: Optional .cube/.3dl LUT file applied with FFmpeg lut3d — overrides both reference and style for professional grading looks.

Удалить участки тишины из видео.

Detect scene changes in video.

Separate audio into stems using Demucs.

Транскрибирует речь в текст с помощью Whisper.

Upscale video using AI super-resolution.

Comprehensive video analysis — transcript, metadata, scenes, audio, quality, chapters, colors. Accepts a local file path or an HTTP/HTTPS URL. Direct video URLs (e.g. https://example.com/clip.mp4) are downloaded automatically. Streaming-platform URLs (YouTube, Vimeo, TikTok, Twitter/X, Instagram, Twitch, …) require yt-dlp (pip install yt-dlp). Each sub-analysis is independent so one failure will not abort the others. Args: input_path: Local path or HTTP/HTTPS URL to the video. whisper_model: Whisper model size (tiny, base, small, medium, large, turbo). language: Language code for transcription (auto-detect if None). scene_threshold: Scene change sensitivity 0.0-1.0. include_transcript: Run speech-to-text via Whisper (requires openai-whisper). include_scenes: Detect scene changes and boundaries. include_audio: Analyse audio waveform, peaks, and silence regions. include_quality: Run visual quality check. include_chapters: Auto-generate chapter markers from scene changes. include_colors: Extract dominant colors and extended metadata. output_srt: Optional path to write SRT subtitle file. output_txt: Optional path to write plain-text transcript. output_md: Optional path to write Markdown transcript with timestamps. output_json: Optional path to write full JSON transcript data.

Применяет маску изображения к видео с размытием краёв. Аргументы: input_path: Абсолютный путь к входному видео. mask_path: Абсолютный путь к изображению маски (белый = видимая область, чёрный = прозрачная). feather: Степень размытия краёв маски в пикселях (по умолчанию 5). output_path: Путь для сохранения результата. Если не указан, создаётся автоматически.

Примените 3D-позиционирование пространственного звука.

Извлекает данные формы волны аудио (пики и участки тишины). Аргументы: input_path: Абсолютный путь к входному видео/аудио файлу. bins: Количество временных сегментов для анализа (по умолчанию 50).

Auto-detect scene changes and create chapters. Analyzes video for scene cuts and returns chapter timestamps. Args: input_path: Absolute path to input video. threshold: Scene detection threshold 0-1. Default 0.3. Returns: List of (timestamp, description) chapter tuples.

Применить одну и ту же операцию к нескольким видеофайлам. Аргументы: inputs: Список абсолютных путей к входным видеофайлам. operation: Операция (trim, resize, convert, filter, blur, color_grade, watermark, speed, fade, normalize_audio). params: Параметры для операции. output_dir: Директория для выходных файлов. Автоматически генерируется, если опущено.

Заменяет видео, сохраняя утверждённый аудио, с явной политикой длительности.

Remove a solid color background (green screen / chroma key). Args: input_path: Absolute path to the input video. color: Color to make transparent in hex format (default green: 0x00FF00). similarity: How similar colors need to be to be keyed out (0.0-1.0, default 0.01). blend: How much to blend the keyed color (default 0.0). output_path: Where to save the output. Auto-generated if omitted.

Удаляет промежуточные видеофайлы после рабочего процесса. Полезно для многоэтапных пайплайнов, которые оставляют временные результаты. Файлы из ``keep`` сохраняются, даже если они указаны в ``files``. Args: files: Список абсолютных путей для удаления. keep: Список абсолютных путей для сохранения (опционально).

Compare video quality between original and processed versions. Args: original_path: Absolute path to the original/reference video. distorted_path: Absolute path to the processed/distorted video. metrics: Metrics to compute (default: ['psnr', 'ssim']).

Собирает упорядоченные слои изображений/видео из JSON-спецификации. Поддерживаются обычное альфа-смешивание, непрозрачность, позиционирование по X/Y, преобразование (масштаб/ширина/высота), временные окна, опциональные альфа-источники маски/матовости, слои видео/изображения/сплошные и детерминированный чек плана слоёв. Ненормальные режимы смешивания, поворот и маршрутизация эффектов по слоям намеренно отложены — пока они не смогут поддерживать предварительную проверку. Аргументы: spec_path: Путь к JSON-спецификации композитных слоёв. output_path: Опциональный путь для результирующего медиафайла. save_layer_plan: Опциональный JSON-путь для сохранения разрешённого плана слоёв. dry_run: Проверить и вывести план слоёв без рендеринга медиа.

Создавайте манифесты, выборки, композиции, предпросмотры и проверки на основе исходного кода.

Convert video format

Перекодирует существующее видео в другой контейнер или кодек, например mp4, webm, gif или mov. Используйте это для преобразования формата; используйте video_export для финальных пресетов доставки. Входное видео доступно только для чтения, и создаётся новый выходной файл.

Create a video from a sequence of images. Args: images: List of absolute paths to image files (in order). output_path: Where to save the output video. Auto-generated if omitted. fps: Frames per second for the output video (default 30.0).

Координируйте проверенные локальные планировщики или верните структурированное воздержание.

Crop video frame

Crop an existing video to a rectangular region or centered percentage crop and render a new output file. The source video is read only; x/y default to a centered crop when omitted.

Run comprehensive design quality analysis on a video. Checks layout, typography, color, motion, and composition quality. Can automatically fix issues where possible. Args: input_path: Absolute path to video file auto_fix: If True, automatically apply fixes strict: If True, treat warnings as errors

Detect scene changes in a video. Args: input_path: Absolute path to the input video. threshold: Scene detection sensitivity (0.0-1.0, lower = more sensitive, default 0.3). min_scene_duration: Minimum scene duration in seconds (default 1.0).

Накладывает фоновую музыку на голос в видео с автоматическим приглушением. Собственный звук видео (голос/диалог) управляет боковым компрессором FFmpeg: музыка затихает, пока звучит речь, и возвращается в паузах — стандартный приём для шортсов, рилсов и фрагментов подкастов. Аргументы: input_path: Видео, чей звук управляет приглушением. music_path: Фоновая музыка или эмбиент, который накладывается снизу. output_path: Куда сохранить результат. Создаётся автоматически, если не указан. music_volume: Базовый уровень музыки до приглушения (0–2, по умолчанию 0.6). threshold: Уровень бокового канала, при котором включается приглушение (0–1). ratio: Коэффициент сжатия, пока звучит голос (1–20). attack: Как быстро музыка затихает, в миллисекундах (1–2000). release: Как быстро музыка восстанавливается, в миллисекундах (1–9000).

Execute a full timeline-based edit from a JSON specification. The timeline JSON describes video clips, audio tracks, text overlays, image overlays, transitions, and export settings in a single operation. Image overlays are applied in a single filtergraph pass (no multiple re-encodes). Args: timeline: JSON object with keys: width, height, tracks (video/audio/text/image), export. Can also be a JSON string or a path to a .json file. Image overlays in tracks: {"type": "image", "images": [{"source": "logo.png", "position": "top-right", "width": 200, "opacity": 0.8}]} output_path: Where to save the final video. Auto-generated if omitted.

Export video for delivery

Re-encode an existing video for final delivery using a quality preset and output format. Use this for publishing-ready renders; use video_convert when the main goal is container/codec conversion. The source video is read only and a new output file is produced.

Export frames from a video as individual images. Args: input_path: Absolute path to the input video. output_dir: Directory for extracted frames. Auto-generated if omitted. fps: Frames per second to extract (1.0 = 1 frame per second, default 1.0). format: Output image format (jpg or png, default jpg).

Extract the audio track from a video file. Args: input_path: Absolute path to the input video. output_path: Where to save the audio file. Auto-generated if omitted. format: Audio format (mp3, aac, wav, ogg, flac).

Извлекает один кадр из видео для визуальной проверки. Аргументы: input_path: Абсолютный путь к видео. timestamp: Время в секундах, на котором извлечь кадр. output_path: Куда сохранить кадр. Автоматически генерируется, если не указан.

Add video fade

Render fade-in and/or fade-out effects onto an existing video without modifying the source file. Use fade_in for a fade from black at the start and fade_out for a fade to black at the end; output_path is created or overwritten.

Apply a visual filter to a video. Common presets: - blur: params={"radius": 5, "strength": 1} - color_preset: params={"preset": "warm"} (warm, cool, vintage, cinematic, noir) Args: input_path: Absolute path to the input video. filter_type: Filter type (blur, sharpen, brightness, contrast, saturation," " grayscale, sepia, invert, vignette, color_preset, denoise," " deinterlace, ken_burns, reverb, compressor, pitch_shift," " noise_reduction). params: Optional filter parameters (e.g. radius for blur, preset for color_preset). output_path: Where to save the output. Auto-generated if omitted. crf: Override CRF value (0-51, lower = better quality). Default 23. preset: Override FFmpeg encoding preset (ultrafast, fast, medium, slow, veryslow).

Auto-fix design issues in a video. Applies automatic fixes for brightness, contrast, saturation, and audio level issues. Args: input_path: Absolute path to input video output_path: Absolute path for output (auto-generated if omitted)

Generate SRT subtitles from text entries and optionally burn into video. Args: entries: List of subtitle entries with keys: start (float), end (float), text (str). input_path: Absolute path to the input video. burn: If True, burn subtitles into the video (default False).

Segment a video into HLS (HTTP Live Streaming) format. Args: input_path: Absolute path to the input video. output_dir: Directory to save segments. Auto-generated if omitted. segment_duration: Target segment duration in seconds (default 4). playlist_name: Name of the master playlist file. qualities: List of quality levels (e.g. ["low", "medium", "high"]).

Get metadata about a video file: duration, resolution, codec, fps, size. Args: input_path: Absolute path to the video file.

Get extended video metadata. Returns detailed video information including scene change detection and dominant colors. Args: input_path: Absolute path to input video. Returns: Dict with duration, fps, resolution, bitrate, has_audio, scene_changes.

Загружает неизменяемые байты исходного кода в существующий или новый приватный проект.

Создает и сохраняет полный детерминированный временной пакет доказательств.

Создаёт сеточную раскладку для нескольких видео. Размещает несколько видео в виде сетки (2x2, 3x1 и т.д.). Аргументы: clips: Список абсолютных путей к видеофайлам. layout: Раскладка сетки (2x2, 3x1, 1x3, 2x3). output_path: Абсолютный путь для выходного видео. gap: Пиксели между клипами. По умолчанию 10. padding: Отступ вокруг сетки. По умолчанию 20. background: Цвет фона в hex. По умолчанию #141414. Возвращает: Словарь со статусом успеха и output_path.

Picture-in-picture overlay. Overlay a smaller video on top of a main video. Args: main_path: Absolute path to main video. pip_path: Absolute path to picture-in-picture video. output_path: Absolute path for output video. position: Position (top-left, top-right, bottom-left, bottom-right). Default bottom-right. size: PIP size as fraction of main. Default 0.25. margin: Margin from edges in pixels. Default 20. border: Add border around PIP. Default true. border_color: Border color hex. Default #CCFF00. border_width: Border width in pixels. Default 2. rounded_corners: Apply rounded corners to PIP. Default true. Returns: Dict with success status and output_path.

Mask out dark regions based on luminance (brightness). Args: input_path: Absolute path to the input video. threshold: Luminance threshold (0.0-1.0). Pixels darker than this become transparent. output_path: Where to save the output. Auto-generated if omitted.

Merge video clips

Concatenate two or more existing video clips into one rendered output file. The input clips are read only and kept unchanged; the tool creates an auto-named output or writes to output_path, using FFmpeg and reporting transition or media-mismatch validation errors.

Generate animated number counter video. Creates a standalone video of an animated counting number. Args: start: Starting number. end: Ending number. duration: Animation duration in seconds. output_path: Absolute path for output video. style: Optional style dict with font, size, color, glow. fps: Frame rate. Default 30. Returns: Dict with success status and output_path.

Generate progress bar / loading animation. Creates a standalone progress animation video. Args: duration: Animation duration in seconds. output_path: Absolute path for output video. style: Progress style (bar, circle, dots). Default bar. color: Progress color hex. Default #CCFF00. track_color: Background track color hex. Default #333333. fps: Frame rate. Default 30. Returns: Dict with success status and output_path.

Normalize audio loudness to a target LUFS level. Common presets: -16 (YouTube), -23 (EBU R128/broadcast), -14 (Apple/Spotify). Args: input_path: Absolute path to the input video. target_lufs: Target integrated loudness in LUFS (default -16 for YouTube). output_path: Where to save the output. Auto-generated if omitted.

Picture-in-picture: overlay a video on top of another. Args: background_path: Absolute path to the background video. overlay_path: Absolute path to the overlay video. position: Position on screen. Named (top-left, etc.), pixel" " {"x": 100, "y": 50}, or percentage {"x_pct": 0.5, "y_pct": 0.5}. width: Width to scale the overlay to (pixels). height: Height to scale the overlay to (pixels). opacity: Overlay opacity (0.0 to 1.0). start_time: When the overlay appears (seconds). duration: How long the overlay is visible (seconds). output_path: Where to save the output. Auto-generated if omitted. crf: Override CRF value (0-51, lower = better quality). Default 23. preset: Override FFmpeg encoding preset (ultrafast, fast, medium, slow, veryslow).

Запускает унифицированную техническую, громкостную, цветовую и декодирующую предварительную проверку.

Генерирует быстрое низкоразрешенное превью для быстрого просмотра. Аргументы: input_path: Абсолютный путь к входному видео. output_path: Путь для сохранения превью. Генерируется автоматически, если не указан. scale_factor: Коэффициент уменьшения (4 = 1/4 разрешения).

Создай каркас кинематографического видеопроекта с папками style, storyboard и refs. Аргументы: slug: Слаг проекта из строчных букв, цифр, дефисов или подчёркиваний. output_dir: Базовая директория для папки projects/. По умолчанию — текущая рабочая директория.

Run visual quality checks on a video. Analyzes brightness, contrast, saturation, audio levels, and color balance. Returns quality scores and recommendations. Args: input_path: Absolute path to video file fail_on_warning: If True, treat warnings as failures

Read metadata tags from a video/audio file. Args: input_path: Absolute path to the video or audio file.

Create preview artifacts only after the video passes quality gates. Use this before publishing or chaining more polish effects. It runs a hard quality gate, then writes a thumbnail and storyboard for human inspection.

Спланируйте явный удаленный исходящий трафик и фиктивные квитанции адаптера без сетевого ввода-вывода.

Собери локальный пакет для перепрофилирования контента с манифестом и артефактами проверки.

Создайте манифест локального пробного перепрофилирования для активов, готовых к платформе.

Inspect a rescue plan or receipt and re-check artifact integrity.

Analyze one local video and return a policy-classified rescue plan. Planning never changes the source or renders final media. It records findings, safe repair ids, recommendations, unavailable and blocked work, local capability evidence, previews, and an execution estimate.

Render approved safe repairs from a reviewed rescue plan. Approval ids must name safe repairs in this exact immutable plan. The renderer fails closed on stale inputs, capabilities, policy, resume state, cancellation, or verification failure and never promotes failed output.

Resize a video or change its aspect ratio. Args: input_path: Absolute path to the input video. width: Target width in pixels. Use with height. height: Target height in pixels. Use with width. aspect_ratio: Preset aspect ratio (16:9, 9:16, 1:1, 4:3, 4:5, 21:9). Overrides width/height. quality: Quality preset (low, medium, high, ultra). output_path: Where to save the output. Auto-generated if omitted.

Планировать или оценивать доказательно-ограниченную локальную восстановительную работу.

Reverse video and audio playback so it plays backwards. Args: input_path: Absolute path to the input video. output_path: Where to save the output. Auto-generated if omitted.

Rotate or flip video

Rotate and/or flip an existing video and render a new output file. Supports right-angle rotations plus horizontal and vertical flips; the input video is not modified.

Создаёт один привязанный к линии производный элемент (salvage derivative) и новый слот для рецензирования.

Query source-backed semantic spans locally without inventing descriptions.

Build a local, source-time semantic timeline from supplied analyzer evidence.

Apply a geometric shape mask to a video. Args: input_path: Absolute path to the input video. shape: Shape to use — "circle", "rounded_rect", or "oval". output_path: Where to save the output. Auto-generated if omitted. feather: Feather radius in pixels (0 = sharp edges).

Change video speed

Создаёт новое видео с изменённой скоростью воспроизведения, оставляя исходное видео без изменений. Значения ниже 1.0 создают замедленное движение, а значения выше 1.0 — ускоренное; коэффициент проверяется на соответствие настроенным ограничениям скорости.

Place two videos side by side or top/bottom. Args: left_path: Absolute path to the first video. right_path: Absolute path to the second video. layout: Layout type (side-by-side or top-bottom). output_path: Where to save the output. Auto-generated if omitted.

Stabilize a shaky video using motion vector analysis. Args: input_path: Absolute path to the input video. smoothing: Smoothing strength (default 15, higher = more stable). zooming: Zoom percentage to avoid black borders (default 0). output_path: Where to save the output. Auto-generated if omitted.

Извлекает ключевые кадры и создаёт сетку раскадровки для проверки человеком. Аргументы: input_path: Абсолютный путь к входному видео. output_dir: Директория для сохранения кадров. Создаётся автоматически, если опущен. frame_count: Количество ключевых кадров для извлечения.

Вживляет субтитры (SRT/VTT/authored ASS) в видео. Аргументы: input_path: Абсолютный путь к входному видео. subtitle_path: Абсолютный путь к файлу субтитров (.srt, .vtt или .ass). output_path: Куда сохранить результат. Автоматически генерируется, если опущен. style: Опциональный параметр force_style, применяемый к любому формату субтитров, включая authored ASS (например, "FontSize=24,PrimaryColour=&H00FFFFFF"). Опустите, чтобы сохранить собственный стиль и позиционирование файла authored ASS.

Burn subtitles from SRT/VTT with custom styling. Embeds subtitle file into video with customizable appearance. Args: input_path: Absolute path to input video. subtitles_path: Absolute path to SRT or VTT file. output_path: Absolute path for output video. style: Optional style dict with font, size, color, outline, etc. Returns: Dict with success status and output_path.

Preview what a video template would do before rendering. Analyzes the template and returns a list of operations, estimated output duration, resolution, and file size — without actually processing any video. Args: template: Template name (tiktok, youtube-shorts, instagram-reel, youtube, instagram-post). input_path: Absolute path to the input video (optional; used for duration probing). duration: Override the estimated duration in seconds. caption: Caption text for TikTok / Instagram Reel / Instagram Post templates. title: Title text for YouTube Shorts / YouTube video templates. music_path: Absolute path to background music file. outro_path: Absolute path to outro video file (YouTube template only).

Add animated text to video. Overlay text with animation effects (fade, slide, etc.). Args: input_path: Absolute path to input video. text: Text to display. output_path: Absolute path for output video. animation: Animation type (fade, slide-up, typewriter). Default fade. font: Font family. Default Arial. size: Font size. Default 48. color: Text color. Default white. position: Text position. Default center. start: Start time in seconds. Default 0. duration: Display duration. Default 3.0. Returns: Dict with success status and output_path.

Извлекает один кадр (миниатюру / захват кадра) из видео. Аргументы: input_path: Абсолютный путь к входному видео. timestamp: Время в секундах, на котором извлечь кадр. По умолчанию — 10% длительности видео. output_path: Куда сохранить изображение кадра. Автоматически генерируется, если не указан.

Plan explicit or ordinary-person timeline edits as a reviewable EDL and diff.

Trim a video clip by start time and duration. Args: input_path: Absolute path to the input video. start: Start timestamp (e.g. '00:02:15' or seconds as string like '10.5'). duration: Duration to keep (e.g. '00:00:30' or '30'). Exclusive with end. end: End timestamp. Exclusive with duration. output_path: Where to save the trimmed video. Auto-generated if omitted. accurate: Frame-accurate seeking (slower). Default False uses fast input seeking which may land on the nearest keyframe.

Проверяет набор текстовых наложений на визуальные дефекты перед рендерингом. Проверяет: перекрытие текста, низкую контрастность, небезопасное позиционирование, чрезмерное количество последовательных наложений и отсутствие теней. Аргументы: overlays: Список спецификаций наложений с ключами: text, position, size, color, shadow (optional), start_time (optional), duration (optional). video_width: Ширина видео в пикселях. video_height: Высота видео в пикселях. background_color: Шестнадцатеричный цвет фона для проверки контрастности. Возвращает: dict со списком warnings и булевым значением clean.

Сохраняет точный анализ активов; утверждения требуют активного человеческого подтверждения.

Plan subject/camera analysis, reframing, or stabilization with crop budgets.

Add video watermark

Overlay an image watermark onto an existing video and render a new output file. The video and watermark image are read only; output_path is created or overwritten. Supports named, pixel, and percentage positions plus opacity, margin, CRF, and preset controls.

Summarize any receipt this project emits, with a read-only integrity check. Reads a workflow render receipt, a dry-run ``workflow_plan`` artifact, or a ``layer_plan`` receipt (v1 legacy with NO ``receipt_kind`` field, or v2) at ``receipt_path`` and returns a NORMALIZED inspection: the kind (inferred from the ``tool`` field when ``receipt_kind`` is absent, per legacy tolerance), schema_version, tool, versions, a status summary (per-step statuses, failed step + error if any), a hash presence/integrity report (which recorded source/output hashes still match the bytes on disk NOW — a read-only re-check), outputs, warnings, cleanup state, plus human-review pointers and known limitations. Nothing is rendered or modified. A malformed/unreadable receipt fails closed with ``invalid_workflow_receipt``. Args: receipt_path: Absolute path to the receipt JSON file to inspect.

Produce a no-render plan for an agent workflow job-spec. Validates the spec first (fail-closed) and then builds a dry-run plan artifact WITHOUT rendering any media: the ordered operation graph, per-source ffprobe results (duration/resolution/codec) and sha256 content hashes where the source file exists, declared output intents, a variant-expansion summary, tool + FFmpeg versions, and warnings for runtime concerns that are not structural errors (e.g. a source file that does not exist yet). The only file written is the optional plan JSON at ``save_plan``; paths inside the artifact are workspace-relative. Pass ``variant`` to plan a single named batch variant: the plan reflects that variant's EFFECTIVE (post-override) steps and auto-named output paths and records ``workflow.variant``. An unknown variant or malformed override fails closed (``invalid_workflow_variant``). Returns the plan artifact on success. On a structurally invalid spec it fails closed with a specific error ``code`` (same codes as ``video_workflow_validate``). Args: spec_path: Absolute path to the workflow job-spec JSON file. save_plan: Optional path to write the plan artifact as JSON. variant: Optional declared variant id to plan its effective steps.

Execute an agent workflow job-spec and return a provenance receipt. Validates the spec first (fail-closed), then runs each allowlisted op (probe|trim|resize|convert|merge|add_text|composite_layers) SEQUENTIALLY in spec order via the backing engine functions. Intermediates are written to a per-run ``@work`` directory unique to this invocation and cleaned on success (kept on failure); final media lands at the declared ``@outputs`` paths. Batch variants: pass ``variant=<id>`` to render one declared variant (its overrides patch the shared steps/outputs, and the single ``@outputs`` path is auto-named with the variant id so N variants emit N distinct outputs); the receipt records ``workflow.variant``. Pass ``all_variants=True`` to render EVERY declared variant in turn and return a ``workflow_batch`` summary (one receipt per variant, each into its own ``@work`` dir); use ``save_receipt_dir`` to also write each variant's receipt to ``<dir>/<variant>.json``. ``variant`` and ``all_variants`` are mutually exclusive. Pass ``keep_intermediates=True`` to retain ``@work`` intermediates even on success (recorded as the ``keep-intermediates`` cleanup policy). Pass ``resume_receipt`` (a prior render receipt from a job that failed with its intermediates kept) to RESUME: the current spec_hash must equal the receipt's (else fail-closed ``resume_spec_mismatch``) AND, for a variant, the receipt's variant must match (else ``resume_variant_mismatch``); each step whose recorded status is ``completed`` AND whose recorded input hashes still match AND whose recorded output file still exists and re-hashes to the recorded hash is SKIPPED, and the first step failing any check plus everything after it re-runs. Returns a workflow receipt (``receipt_kind: "workflow"``) capturing tool + FFmpeg versions, the spec hash, per-source probes/hashes, per-step status with real sha256 hashes of every consumed input and produced output, the cleanup manifest, and the determinism-scope caveat. On the first failing step it fails closed: the failure is recorded on the receipt (still written to ``save_receipt`` when given) and surfaced as a structured error. Args: spec_path: Absolute path to the workflow job-spec JSON file. resume_receipt: Optional path to a prior render receipt to resume from. save_receipt: Optional path to write the workflow receipt as JSON. keep_intermediates: Retain @work intermediates even on success. variant: Optional declared variant id to render a single variant. all_variants: Render every declared variant and return a batch summary. save_receipt_dir: With all_variants, directory for per-variant receipts.

Проверяет спецификацию задания агентского workflow без рендеринга медиа. Запускает структурный валидатор с принципом fail-closed для JSON-спецификации задания по пути ``spec_path``: оп-белый список (probe|trim|resize|convert|merge|add_text|composite_layers), разрешение символических ссылок ``@ref`` (@sources.<id>, @work/<name>, @outputs.<id>), упорядочивание только по обратным ссылкам (шаг может ссылаться на outputs из строго более ранних шагов @work), интроспекция параметров каждой операции и безопасность путей в пределах рабочей области (абсолютные пути и выходы через ../ / симлинки завершаются закрытием с ошибкой). В случае успеха возвращает структурированный вердикт (``{"valid": true, ...}``). При любом структурном нарушении завершается с ошибкой (fail closed) с конкретным кодом ошибки ``code`` (``invalid_workflow_spec``, ``unknown_workflow_ref``, ``unsupported_workflow_op``, ``unsafe_workflow_source``, ``invalid_workflow_params``). Args: spec_path: Абсолютный путь к JSON-файлу спецификации задания workflow.

Write metadata tags to a video/audio file. Args: input_path: Absolute path to the input file. metadata: Dict of tag key-value pairs (e.g. {'title': 'My Video', 'artist': 'Me'}). output_path: Where to save the output. Auto-generated if omitted.