Kinocut

Layer multiple audio tracks with volume mixing. Mix multiple WAV files together with individual volume control. Args: tracks: List of track configs with: - file: Absolute path to WAV file - volume: Volume multiplier 0-1 - start: Start time offset in seconds - loop: Whether to loop the track (default false) duration: Total output duration in seconds. output_path: Absolute path for the output WAV file. Returns: Dict with success status and output_path.

Apply audio effects chain to a WAV file. Process audio through a chain of effects like reverb, filtering, normalization. Args: input_path: Absolute path to input WAV file. output_path: Absolute path for output WAV file. effects: List of effect configs with: - type: "lowpass", "reverb", "normalize", "fade" - Additional params per effect type Returns: Dict with success status and 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.

Apply chromatic aberration - RGB channel separation. Creates a trendy RGB split effect popular in tech/glitch aesthetics. Args: input_path: Absolute path to input video. output_path: Absolute path for output video. intensity: Pixel offset amount. Default 2.0. angle: Separation direction in degrees. Default 0 (horizontal). Returns: Dict with success status and output_path.

Apply bloom/glow effect for highlights. Creates a soft glow around bright areas of the video. Args: input_path: Absolute path to input video. output_path: Absolute path for output video. intensity: Glow strength 0-1. Default 0.5. radius: Blur radius in pixels. Default 10. threshold: Brightness threshold 0-1. Default 0.7. Returns: Dict with success status and output_path.

Apply film grain or digital noise. Adds texture noise to video for vintage or lo-fi aesthetics. Args: input_path: Absolute path to input video. output_path: Absolute path for output video. intensity: Noise amount 0-1. Default 0.05. mode: Noise type (film, digital, color). Default film. animated: Whether noise changes per frame. Default true. Returns: Dict with success status and output_path.

Apply CRT-style scanlines overlay. Simulates old CRT monitor scanline effect with optional flicker. Args: input_path: Absolute path to input video. output_path: Absolute path for output video. line_height: Pixels per scanline. Default 2. opacity: Line opacity 0-1. Default 0.3. flicker: Brightness variation 0-1. Default 0.1. Returns: Dict with success status and output_path.

Apply vignette effect - darkened edges. Creates a darkened border effect that draws attention to the center of the frame. Args: input_path: Absolute path to input video. output_path: Absolute path for output video. intensity: Darkness amount 0-1. Default 0.5. radius: Vignette radius 0-1 (1 = edge of frame). Default 0.8. smoothness: Edge softness 0-1. Default 0.5. Returns: Dict with success status and output_path.

Apply CMYK split glitch effect. Shifts RGB channels at 90-degree intervals to simulate four-plate offset print registration errors. Args: input_path: Absolute path to input video. output_path: Absolute path for output video. amount: Shift distance in pixels. Default 8. angle: Base angle in degrees. Default 0. noise: Per-frame noise amplitude (0-1). Default 0. Returns: Dict with success status and output_path.

Apply datamoshing glitch effect. Simulates P-frame corruption where displacement drifts across frames then periodically resets, mimicking real datamosh artifacts. Args: input_path: Absolute path to input video. output_path: Absolute path for output video. drift: Max displacement drift in pixels. Default 20. iframe_interval: Frame interval for displacement resets. Default 30. Returns: Dict with success status and output_path.

Apply depth-based point splatting effect (requires Node.js + GPU). Extracts pseudo-depth from luminance and renders the image as scattered points, creating a 3D particle-like appearance. Args: input_path: Absolute path to input video. output_path: Absolute path for output video. depth_scale: Depth extraction intensity. Default 1.0. spread: Point spread distance in pixels. Default 10.0. point_size: Size of each splatted point. Default 3.0. threshold: Depth cutoff threshold (0-1). Default 0.5. Returns: Dict with success status and output_path.

Apply digital feedback glitch effect (requires Node.js + GPU). Iterative frame feedback with scale/rotation transform. Each frame blends with a scaled+rotated version of the previous output, creating ghostly trails and recursive visual patterns. Args: input_path: Absolute path to input video. output_path: Absolute path for output video. feedback_mix: Blend between current and feedback (0-1). Default 0.5. scale: UV scale for previous frame. Default 1.0. rotation: Rotation in degrees. Default 0.0. decay: Ghost trail opacity (0-1). Default 0.9. Returns: Dict with success status and output_path.

Apply macroblocking glitch effect. Simulates codec artifacting by downscaling/upscaling to create blocky pixelation combined with color posterization. Args: input_path: Absolute path to input video. output_path: Absolute path for output video. block_size: Block size in pixels. Default 16. intensity: Blend with original (0-1). Default 0.7. color_reduction: Color level reduction (0-1). Default 0.3. Returns: Dict with success status and output_path.

Apply point cloud rendering effect (requires Node.js + GPU). Samples the image as scattered points arranged in a 3D-rotated grid, with depth-based displacement creating a volumetric look. Args: input_path: Absolute path to input video. output_path: Absolute path for output video. density: Point sampling density (0-1). Default 0.5. point_size: Size of each point. Default 2.0. rotation: 3D rotation angle in degrees. Default 0.0. depth: Depth displacement intensity. Default 1.0. Returns: Dict with success status and output_path.

Apply RGB channel shift glitch effect. Shifts red and blue channels in opposite directions for a chromatic split look. Optionally adds per-frame noise for a jittery feel. Args: input_path: Absolute path to input video. output_path: Absolute path for output video. amount: Shift distance in pixels. Default 10.0. angle: Shift direction in degrees. Default 0 (horizontal). noise: Per-frame noise amplitude (0-1). Default 0. Returns: Dict with success status and output_path.

Apply scanline jitter glitch effect. Displaces random horizontal rows of pixels for a CRT malfunction look. Args: input_path: Absolute path to input video. output_path: Absolute path for output video. jitter_amount: Max horizontal displacement in pixels. Default 15. frequency: Fraction of rows affected (0-1). Default 0.3. speed: Animation speed multiplier. Default 5. row_height: Height of each jitter band in pixels. Default 4. Returns: Dict with success status and output_path.

Apply screen tearing glitch effect. Creates horizontal tear bands at varying Y positions that shift left/right over time. Args: input_path: Absolute path to input video. output_path: Absolute path for output video. tear_count: Number of tear bands. Default 5. offset_range: Max horizontal offset in pixels. Default 80. speed: Animation speed. Default 3. Returns: Dict with success status and output_path.

Apply slit-scan temporal displacement effect (requires Node.js + GPU). Each row/column of the output is sampled from a different past frame, creating a time-smeared effect reminiscent of slit-scan photography. Args: input_path: Absolute path to input video. output_path: Absolute path for output video. depth: Number of past frames to use (1-120). Default 30. direction: 0=top-bottom, 1=bottom-top, 2=left-right, 3=right-left. Default 0. Returns: Dict with success status and output_path.

Apply turbulent displacement glitch effect. Uses layered sin/cos expressions at different frequencies to approximate fractal Brownian motion noise for organic-looking displacement. Args: input_path: Absolute path to input video. output_path: Absolute path for output video. amount: Displacement magnitude in pixels. Default 20. scale: Base noise frequency. Default 0.01. speed: Animation speed. Default 1. octaves: Number of noise octaves (1-5). Default 3. Returns: Dict with success status and output_path.

Apply VHS tracking error glitch effect. Simulates VHS tape tracking problems with color bleed, rolling bands, and analog noise. Args: input_path: Absolute path to input video. output_path: Absolute path for output video. tracking: Tracking error intensity (0-1). Default 0.5. noise_amount: VHS noise intensity (0-1). Default 0.03. color_bleed: Red channel shift in pixels. Default 3. roll_speed: Vertical roll speed. Default 2. Returns: Dict with success status and 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).

Benchmark Hyperframes render speed and file size.

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.

Run Hyperframes environment diagnostics.

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).

Cut a person or a product out of a still or video. Default model ``u2net_human_seg`` is people-only (talking heads). For products, packaging, jewelry, bottles, ceramics, or any non-person object, pass ``model="birefnet-general"`` (requires ``pip install "kinocut[object-matte]"``). Never falls through to the people model. Call ``info=True`` with no input to list models and cache without downloading. Guide: docs/PRODUCT_MATTE.md.

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.

Transcribe audio/video to word-level timestamps or import transcripts.

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.

Analyze a product image or video frame — extract colors and optionally generate AI description. Extracts dominant colors from an image. Optionally uses Claude Vision to generate a natural language description of the product. Args: image_path: Absolute path to the image or video file. If video, extracts a representative frame. use_ai: If True, use Claude Vision to generate a description (requires ANTHROPIC_API_KEY). n_colors: Number of dominant colors to extract (default 5).

Establish-locked still match with plan/receipt (intent is audit metadata). v1 pixel path is free establish mean-RGB match only; ``intent`` is required metadata and does not select pixel ops. Opted-in paid generation requests still fail because no paid still-generation adapter exists. Dry-run returns a plan without mutating pixels. Args: source: Absolute source still path. reference: Absolute establish/reference still path. intent: Required audit text (what the agent meant); not a NL pixel director. output_dir: Absolute output directory. prefer: 'edit' (default) or 'gen'. allow_paid_gen: Explicit paid generative permission (default False). dry_run: Plan only when True.

Extract dominant colors from an image or video frame. Uses K-means clustering to find the most prominent colors. Returns hex codes, RGB values, CSS color names, and percentage coverage. Args: image_path: Absolute path to the image or video file. If video, extracts a representative frame. n_colors: Number of dominant colors to extract (1-20, default 5).

Generate a color harmony palette from an image or video frame. Extracts the dominant color and generates harmonious colors based on color theory (complementary, analogous, triadic, split_complementary). Args: image_path: Absolute path to the image or video file. If video, extracts a representative frame. harmony: Harmony type (complementary, analogous, triadic, split_complementary). n_colors: Number of dominant colors to base palette on (default 5).

Install the exact locked Revideo dependencies for a materialized project.

Materialize Kinocut's pinned Revideo project for a validated job.

Render and atomically publish a verified local Revideo artifact.

Materialize, install, render, and verify one local Revideo job.

Find registered MCP tools by name, keyword, or a supported task phrase. Returns JSON {success, query, count, tools:[{name, description, required_params}]}. Use to find the right tool for a task without reading every description. Pass query with a term such as blur, resize, subtitle, audio, or trim, or a task such as "remove filler words", "resume render", or "keep face in frame". Exact names rank first. Discovery describes contracts, not installed backend availability. Args: query: Search term — e.g. "blur", "resize", "subtitle", "audio", "trim".

Package approved platform renders from a saved plan. Never posts.