Ranim

examples/hello_ranim

examples/ranim_logo

Ranim is an animation engine crate implemented in pure rust, inspired heavily by Manim and jkjkil4/JAnim.

[!WARNING] Ranim is now WIP. It only supports some basic items and animations, the apis are unstable and may change frequently, the documentation is also not complete.

Dependencies

Runtime dependencies:

• ffmpeg: encode videos Ranim will try to use ffmpeg from system's path environment variable first, if no ffmpeg is found, ranim will automatic download ffmpeg to the current working dir.

Installation

Currently, it is experimental on crates.io:

[dependencies]
ranim = "0.1.4"

You can also use from git for the latest updates:

[dependencies]
ranim = { git = "https://github.com/azurice/ranim" }

For the usage, check out the examples folder. You can run the examples with:

cargo run --example <example-name>

and you can use --release flag for faster rendering.

Ranim Cli

Ranim cli is a command line tool to help you build the animation. It enables animation previewing with hot reload through dylib.

Please notice that you can use ranim without ranim-cli, the previewing and rendering process can be achieved by simply invoking apis provided by ranim, but it may enhance your experience.

You can install it with:

cargo install ranim-cli

Or install from git:

cargo install --git https://github.com/azurice/ranim

Basic Usage:

• ranim preview: Launch a preview app and invoke cargo to build your library automatically when the source code is changed, then reload it through libloading and show it in the preview app.
• ranim render[ <scene-name>]: Render scene's output, when no scene name is specified, render all scenes.

You can specify the package with --package (just like cargo), and other aditional arguments you want to pass to cargo build can be passed after --.

For example:

ranim render -p xxx scene_a scene_b -- --release

Feature Flags

• app: enable the preview app api

  use preview or run_scene_app API to launch an preview app on a scene

  https://github.com/user-attachments/assets/5bf287e2-b06f-42f8-83b6-76f3775e298e

• profiling: enable profiling with https://github.com/EmbarkStudios/puffin

  CPU uses 127.0.0.1:8585 and GPU uses 127.0.0.1:8586

  

Design

Once the design is stablized, I may write about it.

For now, you can check out the code.

Aknowledgements

• 3b1b/manim
• ManimCommunity/manim
• jkjkil4/JAnim

Star History