Create a new manimgl scene with the given configuration.

IMPORTANT: Always use MCP tools for scene operations. Do NOT write or execute standalone manim scripts.

Get the current scene's configuration and element counts.

IMPORTANT: Always use MCP tools for scene operations.

Returns: Scene information including resolution, mobject/animation counts.

Example: >>> get_scene_info()

Remove all mobjects and animations from the current scene.

IMPORTANT: Always use MCP tools for scene operations.

Returns: True if successful.

Example: >>> clear_scene()

Add a wait/pause to the scene timeline.

IMPORTANT: Always use MCP tools for scene operations.

Save the current scene state for later restoration.

IMPORTANT: Always use MCP tools for scene operations.

Returns: True if state was saved.

Example: >>> save_state()

Restore the scene to a previously saved state.

IMPORTANT: Always use MCP tools for scene operations.

Returns: True if state was restored, False if no saved state exists.

Example: >>> restore_state()

Configure the camera position and/or orientation.

IMPORTANT: Always use MCP tools for scene operations.

Set global rendering configuration parameters.

IMPORTANT: Always use MCP tools for scene operations.

Inject custom Python code into the scene script.

The code will be inserted inside the construct() method body. Use this for advanced manim functionality not covered by other tools.

IMPORTANT: Always use MCP tools for scene operations. Do NOT write or execute standalone manim scripts.

Detect overlapping visual elements (mobjects) in the current scene.

Computes axis-aligned bounding boxes for each mobject based on its stored position and dimension properties (radius, width, height, side_length, font_size). Reports any pair whose bounding boxes intersect.

NOTE: Positions are only reliably updated by move_to(). After shift/scale/rotate/next_to/align_to, the stored position may be stale. Text and TeX dimensions are estimated from font_size and character count — actual rendered glyphs may differ.

Returns: List of overlap reports, each with the pair of overlapping mobjects, their positions, types, and overlap magnitudes.

Example: >>> verify_scene_overlaps()

Generate the full Python script for the current scene.

IMPORTANT: Always use MCP tools for scene operations. Do NOT write or execute standalone manim scripts. Use render_scene() and get_render_result() for rendering instead.

Returns: The complete Python script as a string.

Example: >>> generate_scene_script()

Render the current scene to a video file.

Renders in the background to avoid MCP timeouts. Returns a render_id immediately. Poll get_render_result() with that render_id to check completion and get the output path.

Poll for the result of an async render started by render_scene().

Returns the render result dict when done, or a "still running" status. Keep polling until status is "completed" or "failed". The caller should use exponential backoff between polls: 1s, 2s, 4s, 8s... (cap at 30s). The count resets when the render completes or fails.

IMPORTANT: Always use this MCP tool for scene operations. Do NOT write or execute standalone manim scripts.

Save a single frame (image) of the current scene.

IMPORTANT: Always use this MCP tool for scene operations. Do NOT write or execute standalone manim scripts.

Check if manimgl and OpenGL are available for rendering.

IMPORTANT: Always use this MCP tool for scene operations. Do NOT write or execute standalone manim scripts.

Returns: Dictionary with availability status of manimgl and OpenGL.

Example: >>> get_render_status()

Inspect a rendered video file and return its technical properties.

Uses ffprobe to extract codec info, streams, duration, resolution, and bitrate. Verifies the file exists and has both video and audio.

IMPORTANT: Always use this MCP tool for scene operations. Do NOT write or execute standalone manim scripts.

Get the duration of any audio file in seconds.

Accepts audio files (.mp3, .wav, .ogg, .mid) created by the server. Uses ffprobe internally.

Generate and add a text-to-speech narration audio track to the scene.

The audio plays at the point in the timeline where this tool is called. Uses Google TTS (gTTS) for voice synthesis.

IMPORTANT: Always use MCP tools for scene operations.

Add background music to the scene.

The music plays from the beginning of the rendered video. Accepts audio files (.mp3, .wav, .ogg) or MIDI files (.mid, .midi). MIDI files are rendered to audio using FluidSynth and a system SoundFont.

When narration tracks are also present, the music volume auto-ducks during narration via sidechain compression in post-processing.

IMPORTANT: Always use MCP tools for scene operations.