Repository navigation
Highlights
The toolkit makes films with a 3D character in them. That arrived across v0.28.0 and v0.29.0 without ever being said in one place, so this release says it.
Watch Just a Quick One, the toolkit's trailer (1:44). The man in the kitchen is a 3D character. Nobody animated him: every step, the mug, the laptop lid and the sip is a line in a JSON file. Short on time? There is a 27 second teaser.
- How it works: you write the shots by type (
wide,closeup,side) and the acting as verbs (walk,sit_down,carry,sip). Blender builds the set, places the cameras and renders. There are no keyframes and no coordinates in the spec. - A consistent character: the same person in every shot, doing the same thing again tomorrow, which image-to-video models can't hold.
- Checked before it renders:
checktakes seconds. It verifies every camera and measures the body: a hand inside the body, a limb through a table, a sliding foot, a mug that tips. - Your own character: a model from an image-to-3D service is fitted to the shared rig in one command. New in this release,
tools/reference_capture.pytakes the reference photos of a person at a webcam, pose by pose (#234). - Anywhere in a video: a whole film with sound, or one clip per shot, transparent if you ask, inside a Remotion video.
What it needs: Blender 4.2 or later, which is free. It is optional, and nothing else in the toolkit depends on it. The limit is your machine: with a GPU a frame takes a second or two, so a 27 second example is about 25 minutes. Run uv run tools/blender_render.py doctor first; it times a frame for you. Fitted characters, the kitchen and the lecture hall are experimental. It has been run in full on macOS and its checks pass on Linux. Windows is untested.
Start:
uv run tools/blender_render.py check examples/blender-disk-panic/spec.json # seconds
uv run tools/blender_render.py render examples/blender-disk-panic/spec.json # a 22 second filmAlso in this release: the site's home page and the README open with the trailer (#232).
How it works, with pictures · The announcement, and where to show what you make
What's Changed
- Release v0.29.1: the toolkit makes films with a 3D character, said in one place, and a webcam tool for a fitted character's reference photos (adf889b)
- ADD: reference_capture.py takes the reference photos of a person for a fitted 3D character, from a webcam, pose by pose (#234) (70fbf1e)
- DOCS: the site's home page and the README open with the trailer and say the toolkit makes films with a 3D character (db14c7c)
Full Changelog: v0.29.0...v0.29.1