---
name: manimgl-best-practices
description: |-
  Trigger when: (1) User mentions "manimgl" or "ManimGL" or "3b1b manim", (2) Code contains `from manimlib import *`, (3) User runs `manimgl` CLI commands, (4) Working with InteractiveScene, self.frame, self.embed(), ShowCreation(), or ManimGL-specific patterns.

  Best practices for ManimGL (Grant Sanderson's 3Blue1Brown version) - OpenGL-based animation engine with interactive development. Covers InteractiveScene, Tex with t2c, camera frame control, interactive mode (-se flag), 3D rendering, and checkpoint_paste() workflow.

  NOT for Manim Community Edition (which uses `manim` imports and `manim` CLI).
title: manimgl-best-practices
canonical_url: https://skilld.dev/gh/openmontageinc/openmontage/manimgl-best-practices
last_updated: 2026-10-14T05:11:31.000Z
---

> Index of every page on this site: [llms.txt](https://skilld.dev/llms.txt)

> **Skill from skilld.dev.** Follow the user's requested action.
> If the user asked to fork this Skill, follow the fork workflow below. Do not execute the Skill instructions while copying it.
> Otherwise, follow the instructions below for this session. You do not need to install anything.
>
> 106 supporting files sit beside this SKILL.md. When the Skill refers to one, fetch https://skilld.dev/api/skills-raw/openmontageinc/openmontage/manimgl-best-practices/PATH with PATH replaced.
>
> If the user asked to install this Skill, run `npx skilld install openmontageinc/openmontage/manimgl-best-practices`. Install writes the Skill files into the project, so every session loads them.
>
> ## Fork workflow
>
> A fork creates an editable local Skill with its original author and licence. The request authorizes copying and local installation.
> 1. Check `./skills/manimgl-best-practices`, the project lockfile, and selected Agent targets together. If the local directory or installed Skill exists, stop. Never overwrite an existing directory or Agent target.
> 2. Read [source metadata](https://skilld.dev/api/v1/skills/openmontageinc/openmontage/manimgl-best-practices) once. Use sourceUrl, sourceCommit, skillPath, sourceGone, and license. If the source is gone or its path is missing, stop. If license is null, read licence files at the source commit.
> 3. Fetch only the source commit into a temporary Git repository. Do not clone full history. Derive repository_url from sourceUrl, including repository renames. If sourceCommit is absent, resolve the sourceUrl ref once. Set source_commit to that actual commit. Run these commands in one shell call:
>
> ```sh
> git init --quiet "$temporary_dir"
> git -C "$temporary_dir" fetch --quiet --depth=1 "$repository_url" "$source_commit"
> git -C "$temporary_dir" checkout --quiet --detach FETCH_HEAD
> ```
>
> Read applicable licence declarations and notices at that commit. If copying is not permitted, report the restriction and stop.
> 4. Inspect source entries together, then copy the directory containing skillPath into `./skills/manimgl-best-practices`. Use the user's path if selected. Keep the original SKILL.md, relative links, scripts, binary assets, and executable modes. Exclude .git metadata. Reject symlinks and paths outside the Skill directory. After checking entries, use cp -a where available. A regular source directory needs no custom copy script. Do not save this page wrapper as SKILL.md.
> Preserve author credit, notices, and applicable licence files from repository or parent directories. Add PROVENANCE.md with the Skill page, source URL, actual commit, original path, and licence. Retain any existing PROVENANCE.md and record new provenance separately. Batch source inspection, copying, and provenance work where practical.
> 5. In the project root, run `skilld install ./skills/manimgl-best-practices --mode copy --plain`. If skilld is unavailable, use `npx skilld install ./skills/manimgl-best-practices --mode copy --plain`. This known command needs no help lookup. Install does not support --json. Use detected Agent targets, or add --agent for the targets the user selected. Install the local path, never the upstream selector. If installation fails, preserve the local copy and report the exact failure.
> 6. Confirm the local lockfile source and installed Agent copies once. Report the local path, actual commit, and Agent targets. After edits, reinstall the same local path. Upstream updates must not replace it. Do not publish or push unless the user asks.

## How to use

Read individual rule files for detailed explanations and code examples:

### Core Concepts
- [rules/scenes.md](https://skilld.dev/api/skills-raw/openmontageinc/openmontage/manimgl-best-practices/rules/scenes.md) - InteractiveScene, Scene types, and construct method
- [rules/mobjects.md](https://skilld.dev/api/skills-raw/openmontageinc/openmontage/manimgl-best-practices/rules/mobjects.md) - Mobject types, VMobject, Groups, and positioning
- [rules/animations.md](https://skilld.dev/api/skills-raw/openmontageinc/openmontage/manimgl-best-practices/rules/animations.md) - Animation classes, playing animations, and timing

### Creation & Transformation
- [rules/creation-animations.md](https://skilld.dev/api/skills-raw/openmontageinc/openmontage/manimgl-best-practices/rules/creation-animations.md) - ShowCreation, Write, FadeIn, DrawBorderThenFill
- [rules/transform-animations.md](https://skilld.dev/api/skills-raw/openmontageinc/openmontage/manimgl-best-practices/rules/transform-animations.md) - Transform, ReplacementTransform, TransformMatchingTex
- [rules/animation-groups.md](https://skilld.dev/api/skills-raw/openmontageinc/openmontage/manimgl-best-practices/rules/animation-groups.md) - LaggedStart, Succession, AnimationGroup

### Text & Math
- [rules/tex.md](https://skilld.dev/api/skills-raw/openmontageinc/openmontage/manimgl-best-practices/rules/tex.md) - Tex class, raw strings R"...", and LaTeX rendering
- [rules/text.md](https://skilld.dev/api/skills-raw/openmontageinc/openmontage/manimgl-best-practices/rules/text.md) - Text mobjects, fonts, and styling
- [rules/t2c.md](https://skilld.dev/api/skills-raw/openmontageinc/openmontage/manimgl-best-practices/rules/t2c.md) - tex_to_color_map (t2c) for coloring math expressions

### Styling & Appearance
- [rules/colors.md](https://skilld.dev/api/skills-raw/openmontageinc/openmontage/manimgl-best-practices/rules/colors.md) - Color constants, gradients, RGB, hex, GLSL coloring
- [rules/styling.md](https://skilld.dev/api/skills-raw/openmontageinc/openmontage/manimgl-best-practices/rules/styling.md) - Fill, stroke, opacity, backstroke, gloss, shadow

### 3D & Camera
- [rules/3d.md](https://skilld.dev/api/skills-raw/openmontageinc/openmontage/manimgl-best-practices/rules/3d.md) - 3D objects, surfaces, Sphere, Torus, parametric surfaces, lighting
- [rules/camera.md](https://skilld.dev/api/skills-raw/openmontageinc/openmontage/manimgl-best-practices/rules/camera.md) - frame.reorient(), Euler angles, fix_in_frame(), camera animations

### Interactive Development
- [rules/interactive.md](https://skilld.dev/api/skills-raw/openmontageinc/openmontage/manimgl-best-practices/rules/interactive.md) - Interactive mode with `-se` flag, checkpoint_paste()
- [rules/frame.md](https://skilld.dev/api/skills-raw/openmontageinc/openmontage/manimgl-best-practices/rules/frame.md) - self.frame, camera control, reorient, and zooming
- [rules/embedding.md](https://skilld.dev/api/skills-raw/openmontageinc/openmontage/manimgl-best-practices/rules/embedding.md) - self.embed() for IPython debugging, touch() mode

### Configuration & CLI
- [rules/cli.md](https://skilld.dev/api/skills-raw/openmontageinc/openmontage/manimgl-best-practices/rules/cli.md) - manimgl command, flags (-w, -o, -se, -l, -h), rendering options
- [rules/config.md](https://skilld.dev/api/skills-raw/openmontageinc/openmontage/manimgl-best-practices/rules/config.md) - custom_config.yml, directories, camera settings, quality presets

## Working Examples

Complete, tested example files demonstrating common patterns:

- [examples/basic_animations.py](https://skilld.dev/api/skills-raw/openmontageinc/openmontage/manimgl-best-practices/examples/basic_animations.py) - Basic shapes, text, and animations
- [examples/math_visualization.py](https://skilld.dev/api/skills-raw/openmontageinc/openmontage/manimgl-best-practices/examples/math_visualization.py) - LaTeX equations and mathematical content
- [examples/graph_plotting.py](https://skilld.dev/api/skills-raw/openmontageinc/openmontage/manimgl-best-practices/examples/graph_plotting.py) - Axes, functions, and graphing
- [examples/3d_visualization.py](https://skilld.dev/api/skills-raw/openmontageinc/openmontage/manimgl-best-practices/examples/3d_visualization.py) - 3D scenes with camera control and surfaces
- [examples/updater_patterns.py](https://skilld.dev/api/skills-raw/openmontageinc/openmontage/manimgl-best-practices/examples/updater_patterns.py) - Dynamic animations with updaters

## Scene Templates

Copy and modify these templates to start new projects:

- [templates/basic_scene.py](https://skilld.dev/api/skills-raw/openmontageinc/openmontage/manimgl-best-practices/templates/basic_scene.py) - Standard 2D scene template
- [templates/interactive_scene.py](https://skilld.dev/api/skills-raw/openmontageinc/openmontage/manimgl-best-practices/templates/interactive_scene.py) - InteractiveScene with self.embed()
- [templates/3d_scene.py](https://skilld.dev/api/skills-raw/openmontageinc/openmontage/manimgl-best-practices/templates/3d_scene.py) - 3D scene with frame.reorient()
- [templates/math_scene.py](https://skilld.dev/api/skills-raw/openmontageinc/openmontage/manimgl-best-practices/templates/math_scene.py) - Mathematical derivations and equations

## Quick Reference

### Basic Scene Structure
```python
from manimlib import *

class MyScene(InteractiveScene):
    def construct(self):
        # Create mobjects
        circle = Circle()

        # Add to scene (static)
        self.add(circle)

        # Or animate
        self.play(ShowCreation(circle))  # Note: ShowCreation, not Create

        # Wait
        self.wait(1)
```

### Render Command
```bash
# Render and preview
manimgl scene.py MyScene

# Interactive mode - drop into shell at line 15
manimgl scene.py MyScene -se 15

# Write to file
manimgl scene.py MyScene -w

# Low quality for testing
manimgl scene.py MyScene -l
```

### Key Differences from ManimCE

| Feature | ManimGL (3b1b) | Manim Community |
|---------|----------------|-----------------|
| Import | `from manimlib import *` | `from manim import *` |
| CLI | `manimgl` | `manim` |
| Math text | `Tex(R"\pi")` | `MathTex(r"\pi")` |
| Scene | `InteractiveScene` | `Scene` |
| Create anim | `ShowCreation` | `Create` |
| Camera | `self.frame` | `self.camera.frame` |
| Fix in frame | `mob.fix_in_frame()` | `self.add_fixed_in_frame_mobjects(mob)` |
| Package | `manimgl` (PyPI) | `manim` (PyPI) |

### Interactive Development Workflow

ManimGL's killer feature is interactive development:

```bash
# Start at line 20 with state preserved
manimgl scene.py MyScene -se 20
```

In interactive mode:
```python
# Copy code to clipboard, then run:
checkpoint_paste()           # Run with animations
checkpoint_paste(skip=True)  # Run instantly (no animations)
checkpoint_paste(record=True) # Record while running
```

### Camera Control (self.frame)

```python
# Get the camera frame
frame = self.frame

# Reorient in 3D (phi, theta, gamma, center, height)
frame.reorient(45, -30, 0, ORIGIN, 8)

# Animate camera movement
self.play(frame.animate.reorient(60, -45, 0))

# Fix mobjects to stay in screen space during 3D movement
title.fix_in_frame()
```

### LaTeX with Tex class

```python
# Use raw strings with capital R
formula = Tex(R"\int_0^1 x^2 \, dx = \frac{1}{3}")

# Color mapping with t2c
equation = Tex(
    R"E = mc^2",
    t2c={"E": BLUE, "m": GREEN, "c": YELLOW}
)

# Isolate substrings for animation
formula = Tex(R"\sum_{n=1}^{\infty} \frac{1}{n^2} = \frac{\pi^2}{6}")
formula.set_color_by_tex("n", BLUE)
```

### Common Patterns

#### Embedding for debugging
```python
def construct(self):
    circle = Circle()
    self.play(ShowCreation(circle))
    self.embed()  # Drops into IPython shell here
```

#### Set floor plane for 3D
```python
self.set_floor_plane("xz")  # Makes xy the viewing plane
```

#### Backstroke for text readability
```python
text = Text("Label")
text.set_backstroke(BLACK, 5)  # Black outline behind text
```

### Installation

```bash
# Install ManimGL
pip install manimgl

# Check installation
manimgl --version
```

### Common Pitfalls to Avoid

1. **Version confusion** - Ensure you're using `manimgl`, not `manim` (community version)
2. **ShowCreation vs Create** - ManimGL uses `ShowCreation`, not `Create`
3. **Tex vs MathTex** - ManimGL uses `Tex` with capital R raw strings
4. **self.frame vs self.camera.frame** - ManimGL uses `self.frame` directly
5. **fix_in_frame()** - Call on the mobject, not the scene
6. **Interactive mode** - Use `-se` flag for interactive development

## License & Attribution

This skill contains example code adapted from [3Blue1Brown's video repository](https://github.com/3b1b/videos) by Grant Sanderson.

**License:** [CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/)

- **Attribution required** - Credit both 3Blue1Brown and the adapter
- **NonCommercial** - Not for commercial use
- **ShareAlike** - Derivatives must use the same license

See [LICENSE.txt](https://skilld.dev/api/skills-raw/openmontageinc/openmontage/manimgl-best-practices/LICENSE.txt) for full details.
