Playing a presentation¶
Manimble presents a deck full screen, in one of two forms:
- With animations, the real Manim animations play as video between builds. This is how a Manim presentation is meant to be seen.
- As stills, the show steps through a picture of each build, with a fade between them. Stills are ready immediately, because the editor has already made them.
Play ▸ Show Animations (⌥⌘A) chooses between the two. When it is ticked, the Play commands, Presenter View and scripted presentations use animations; when it isn't, they use stills.
Start and stop¶
| Command | Shortcut |
|---|---|
| Play ▸ Play from Beginning | ⌥⇧⌘P |
| Play ▸ Play from Current Slide | ⌥⌘P |
| Play ▸ Presenter View | ⌃⌘P |
Press Esc or Q to end the show. The editor then shows the slide and build the show ended on. Hidden slides are skipped; playing from a hidden slide starts at the next slide that is shown.
Building the animations¶
The animations are rendered by Manim Slides into video clips. The first time you play a deck with animations, every slide is built, which can take a few minutes; a pill in the top-right corner of the window shows the progress. After that, only slides whose code has changed are built again. Slides that are still building when the show reaches them show their still picture, then switch to the animation once it is ready.
Builds go into the working copy's slides/ folder, so building never changes the builds in your original deck.
Slides you built outside Manimble with Manim Slides are used as they are, unless you have changed them since.
Animation resolution¶
Play ▸ Animation Resolution sets the size the animations are built at: 720p (the default, and the fastest to build), 1080p, 1440p or 4K. Higher resolutions look sharper on large screens and projectors but take longer to build. After you change the resolution, each slide is rebuilt once, the next time it is played.
Keys during a show¶
| Action | Animated show | Stills |
|---|---|---|
| Next build | → ↓ ↩ Page Down, or click | → ↓ Space ↩ Page Down, or click |
| Previous build | ← ↑ ⌫ Page Up, or right-click | ← ↑ ⌫ Page Up, or right-click |
| Next slide, skipping its remaining builds | N | N |
| First / last slide | Home / End | Home / End |
| Pause or resume the animation | Space | |
| Replay the current build | R | |
| Play the current build in reverse | V | |
| Jump to chapter 1–9 | 1 … 9 | |
| Black screen, and back | B or . | B or . |
| Show or hide the progress bar | P | P |
| End the show | Esc or Q | Esc or Q |
Going back to a previous build shows how that build ends, rather than playing it again.
The animated show honours what the deck's code asks of Manim Slides: builds that loop, builds that continue to the next one automatically, and playback rates.
Links and chapters¶
Text with a hyperlink opens its link when you click it during a show. In the stills show the pointer becomes a hand over a link.
A deck can define chapters and extra clickable regions in a present.json file in the deck folder. With chapters,
1–9 jump to them, and clicking the bottom strip of the slide jumps to the chapter under the
pointer. See Deck file format.
Preview one slide's animations¶
To check a slide's animations without starting a show, choose Play ▸ Preview Current Slide's Animations (⌥⌘R). Manimble builds the slide if needed and plays it in the editor, build after build, with a short pause between builds. Use Previous build, Next build and Replay, the arrow keys, or a click on the slide to step through it by hand, and the player's controls to pause or scrub. Click Close to return to editing.
Dark mode in a show¶
If View ▸ Dark Mode or View ▸ Invert Colors is on, the stills show uses those colours too. The animated show uses them as well. Exports always use the real colours. See Themes, backgrounds and colour.