How to use
Read individual rule files for detailed explanations and code examples:
Core Concepts
- rules/scenes.md - InteractiveScene, Scene types, and construct method
- rules/mobjects.md - Mobject types, VMobject, Groups, and positioning
- rules/animations.md - Animation classes, playing animations, and timing
Creation & Transformation
- rules/creation-animations.md - ShowCreation, Write, FadeIn, DrawBorderThenFill
- rules/transform-animations.md - Transform, ReplacementTransform, TransformMatchingTex
- rules/animation-groups.md - LaggedStart, Succession, AnimationGroup
Text & Math
- rules/tex.md - Tex class, raw strings R"...", and LaTeX rendering
- rules/text.md - Text mobjects, fonts, and styling
- rules/t2c.md - tex_to_color_map (t2c) for coloring math expressions
Styling & Appearance
- rules/colors.md - Color constants, gradients, RGB, hex, GLSL coloring
- rules/styling.md - Fill, stroke, opacity, backstroke, gloss, shadow
3D & Camera
- rules/3d.md - 3D objects, surfaces, Sphere, Torus, parametric surfaces, lighting
- rules/camera.md - frame.reorient(), Euler angles, fix_in_frame(), camera animations
Interactive Development
- rules/interactive.md - Interactive mode with
-se flag, checkpoint_paste()
- rules/frame.md - self.frame, camera control, reorient, and zooming
- rules/embedding.md - self.embed() for IPython debugging, touch() mode
Configuration & CLI
- rules/cli.md - manimgl command, flags (-w, -o, -se, -l, -h), rendering options
- rules/config.md - custom_config.yml, directories, camera settings, quality presets
Working Examples
Complete, tested example files demonstrating common patterns:
- examples/basic_animations.py - Basic shapes, text, and animations
- examples/math_visualization.py - LaTeX equations and mathematical content
- examples/graph_plotting.py - Axes, functions, and graphing
- examples/3d_visualization.py - 3D scenes with camera control and surfaces
- examples/updater_patterns.py - Dynamic animations with updaters
Scene Templates
Copy and modify these templates to start new projects:
- templates/basic_scene.py - Standard 2D scene template
- templates/interactive_scene.py - InteractiveScene with self.embed()
- templates/3d_scene.py - 3D scene with frame.reorient()
- templates/math_scene.py - Mathematical derivations and equations
Quick Reference
Basic Scene Structure
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
# 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:
# Start at line 20 with state preserved
manimgl scene.py MyScene -se 20
In interactive mode:
# 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)
# 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
# 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
def construct(self):
circle = Circle()
self.play(ShowCreation(circle))
self.embed() # Drops into IPython shell here
Set floor plane for 3D
self.set_floor_plane("xz") # Makes xy the viewing plane
Backstroke for text readability
text = Text("Label")
text.set_backstroke(BLACK, 5) # Black outline behind text
Installation
# Install ManimGL
pip install manimgl
# Check installation
manimgl --version
Common Pitfalls to Avoid
- Version confusion - Ensure you're using
manimgl, not manim (community version)
- ShowCreation vs Create - ManimGL uses
ShowCreation, not Create
- Tex vs MathTex - ManimGL uses
Tex with capital R raw strings
- self.frame vs self.camera.frame - ManimGL uses
self.frame directly
- fix_in_frame() - Call on the mobject, not the scene
- Interactive mode - Use
-se flag for interactive development
License & Attribution
This skill contains example code adapted from 3Blue1Brown's video repository by Grant Sanderson.
License: CC 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 for full details.
1---2name: manimgl-best-practices3description: |4 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.56 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.78 NOT for Manim Community Edition (which uses `manim` imports and `manim` CLI).9metadata:10 source: https://skillmd.com/skills/adithya-s-k/manimgl-best-practices11---1213## How to use1415Read individual rule files for detailed explanations and code examples:1617### Core Concepts18- [rules/scenes.md](rules/scenes.md) - InteractiveScene, Scene types, and construct method19- [rules/mobjects.md](rules/mobjects.md) - Mobject types, VMobject, Groups, and positioning20- [rules/animations.md](rules/animations.md) - Animation classes, playing animations, and timing2122### Creation & Transformation23- [rules/creation-animations.md](rules/creation-animations.md) - ShowCreation, Write, FadeIn, DrawBorderThenFill24- [rules/transform-animations.md](rules/transform-animations.md) - Transform, ReplacementTransform, TransformMatchingTex25- [rules/animation-groups.md](rules/animation-groups.md) - LaggedStart, Succession, AnimationGroup2627### Text & Math28- [rules/tex.md](rules/tex.md) - Tex class, raw strings R"...", and LaTeX rendering29- [rules/text.md](rules/text.md) - Text mobjects, fonts, and styling30- [rules/t2c.md](rules/t2c.md) - tex_to_color_map (t2c) for coloring math expressions3132### Styling & Appearance33- [rules/colors.md](rules/colors.md) - Color constants, gradients, RGB, hex, GLSL coloring34- [rules/styling.md](rules/styling.md) - Fill, stroke, opacity, backstroke, gloss, shadow3536### 3D & Camera37- [rules/3d.md](rules/3d.md) - 3D objects, surfaces, Sphere, Torus, parametric surfaces, lighting38- [rules/camera.md](rules/camera.md) - frame.reorient(), Euler angles, fix_in_frame(), camera animations3940### Interactive Development41- [rules/interactive.md](rules/interactive.md) - Interactive mode with `-se` flag, checkpoint_paste()42- [rules/frame.md](rules/frame.md) - self.frame, camera control, reorient, and zooming43- [rules/embedding.md](rules/embedding.md) - self.embed() for IPython debugging, touch() mode4445### Configuration & CLI46- [rules/cli.md](rules/cli.md) - manimgl command, flags (-w, -o, -se, -l, -h), rendering options47- [rules/config.md](rules/config.md) - custom_config.yml, directories, camera settings, quality presets4849## Working Examples5051Complete, tested example files demonstrating common patterns:5253- [examples/basic_animations.py](examples/basic_animations.py) - Basic shapes, text, and animations54- [examples/math_visualization.py](examples/math_visualization.py) - LaTeX equations and mathematical content55- [examples/graph_plotting.py](examples/graph_plotting.py) - Axes, functions, and graphing56- [examples/3d_visualization.py](examples/3d_visualization.py) - 3D scenes with camera control and surfaces57- [examples/updater_patterns.py](examples/updater_patterns.py) - Dynamic animations with updaters5859## Scene Templates6061Copy and modify these templates to start new projects:6263- [templates/basic_scene.py](templates/basic_scene.py) - Standard 2D scene template64- [templates/interactive_scene.py](templates/interactive_scene.py) - InteractiveScene with self.embed()65- [templates/3d_scene.py](templates/3d_scene.py) - 3D scene with frame.reorient()66- [templates/math_scene.py](templates/math_scene.py) - Mathematical derivations and equations6768## Quick Reference6970### Basic Scene Structure71```python72from manimlib import *7374class MyScene(InteractiveScene):75 def construct(self):76 # Create mobjects77 circle = Circle()7879 # Add to scene (static)80 self.add(circle)8182 # Or animate83 self.play(ShowCreation(circle)) # Note: ShowCreation, not Create8485 # Wait86 self.wait(1)87```8889### Render Command90```bash91# Render and preview92manimgl scene.py MyScene9394# Interactive mode - drop into shell at line 1595manimgl scene.py MyScene -se 159697# Write to file98manimgl scene.py MyScene -w99100# Low quality for testing101manimgl scene.py MyScene -l102```103104### Key Differences from ManimCE105106| Feature | ManimGL (3b1b) | Manim Community |107|---------|----------------|-----------------|108| Import | `from manimlib import *` | `from manim import *` |109| CLI | `manimgl` | `manim` |110| Math text | `Tex(R"\pi")` | `MathTex(r"\pi")` |111| Scene | `InteractiveScene` | `Scene` |112| Create anim | `ShowCreation` | `Create` |113| Camera | `self.frame` | `self.camera.frame` |114| Fix in frame | `mob.fix_in_frame()` | `self.add_fixed_in_frame_mobjects(mob)` |115| Package | `manimgl` (PyPI) | `manim` (PyPI) |116117### Interactive Development Workflow118119ManimGL's killer feature is interactive development:120121```bash122# Start at line 20 with state preserved123manimgl scene.py MyScene -se 20124```125126In interactive mode:127```python128# Copy code to clipboard, then run:129checkpoint_paste() # Run with animations130checkpoint_paste(skip=True) # Run instantly (no animations)131checkpoint_paste(record=True) # Record while running132```133134### Camera Control (self.frame)135136```python137# Get the camera frame138frame = self.frame139140# Reorient in 3D (phi, theta, gamma, center, height)141frame.reorient(45, -30, 0, ORIGIN, 8)142143# Animate camera movement144self.play(frame.animate.reorient(60, -45, 0))145146# Fix mobjects to stay in screen space during 3D movement147title.fix_in_frame()148```149150### LaTeX with Tex class151152```python153# Use raw strings with capital R154formula = Tex(R"\int_0^1 x^2 \, dx = \frac{1}{3}")155156# Color mapping with t2c157equation = Tex(158 R"E = mc^2",159 t2c={"E": BLUE, "m": GREEN, "c": YELLOW}160)161162# Isolate substrings for animation163formula = Tex(R"\sum_{n=1}^{\infty} \frac{1}{n^2} = \frac{\pi^2}{6}")164formula.set_color_by_tex("n", BLUE)165```166167### Common Patterns168169#### Embedding for debugging170```python171def construct(self):172 circle = Circle()173 self.play(ShowCreation(circle))174 self.embed() # Drops into IPython shell here175```176177#### Set floor plane for 3D178```python179self.set_floor_plane("xz") # Makes xy the viewing plane180```181182#### Backstroke for text readability183```python184text = Text("Label")185text.set_backstroke(BLACK, 5) # Black outline behind text186```187188### Installation189190```bash191# Install ManimGL192pip install manimgl193194# Check installation195manimgl --version196```197198### Common Pitfalls to Avoid1992001. **Version confusion** - Ensure you're using `manimgl`, not `manim` (community version)2012. **ShowCreation vs Create** - ManimGL uses `ShowCreation`, not `Create`2023. **Tex vs MathTex** - ManimGL uses `Tex` with capital R raw strings2034. **self.frame vs self.camera.frame** - ManimGL uses `self.frame` directly2045. **fix_in_frame()** - Call on the mobject, not the scene2056. **Interactive mode** - Use `-se` flag for interactive development206207## License & Attribution208209This skill contains example code adapted from [3Blue1Brown's video repository](https://github.com/3b1b/videos) by Grant Sanderson.210211**License:** [CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/)212213- **Attribution required** - Credit both 3Blue1Brown and the adapter214- **NonCommercial** - Not for commercial use215- **ShareAlike** - Derivatives must use the same license216217See [LICENSE.txt](LICENSE.txt) for full details.218