Repository navigation
v0.29.0
Highlights
3D characters: this release and v0.28.0 together add films with a 3D character who acts from a JSON spec. It is optional and needs Blender. The announcement, in one place: https://github.com/digitalsamba/claude-code-video-toolkit/discussions/233
Characters get up from the desk. The toolkit's trailer, Just a Quick One, was made with what is in this release, and its opening is in the repo for you to render.
- Fitted characters (experimental):
blender_render.py fitseats a generated 3D model on the shared rig, with a face and fingers of its own. Two are in the repo: Mara, who is invented, and the toolkit's author (#222, #227). - On their feet: characters stand, walk straight or round furniture, sit down, open a door by hand, point, and present at a board in a lecture hall (#222, #223).
- A kitchen and a mug:
carryholds the mug by its handle, andput_down,pick_upandsipdo what they say (#224). - The body is checked before a frame is rendered:
checkfails on a hand inside the body, a limb through furniture, a sliding foot, a stretched sleeve or a carried thing that tips, andrenderfails on flicker (#222, #224). examples/blender-kitchen: two films in the same kitchen, one for each fitted character, in three commands (#225, #227).- Blender is optional, not experimental: the limit is your machine, so the docs now say what it needs and how long a character film takes. Only fitted characters, the kitchen and the lecture hall keep the experimental label (#226). There is a new page on the site: 3D characters.
- How a film gets made:
docs/blender.mddescribes the process behind the trailer: a brief, a storyboard fromcheckstills, an unattended build, and a prompt each session writes for the next (#224).
Checked on macOS with Blender 5.3, and on Linux with Blender 4.2.3 for both fitted characters and four example films (#229). Windows is untested. A full sip still stretches a fitted sleeve past the check's limit, so the examples drink at part height.
What's Changed
- Release v0.29.0: fitted 3D characters that stand, walk and carry a mug, a kitchen and a lecture hall, the body checked before a render, and Blender labelled optional (cb9fc9f)
- DOCS: the agent skill covers fitted characters, the kitchen example and how long a character film takes (6d3b7af)
- DOCS: the README has a YouTube subscribe badge and the site links the channel from its nav, showcase and footer (dd412e6)
- DOCS: both fitted characters, the kitchen films, the disk-panic film and the product stage pass their checks on Linux with Blender 4.2.3 (3edc1ac)
- DOCS: the README and the 3D characters page link the trailer on YouTube, now that it is public there (aa91ef5)
- ADD (experimental): the toolkit's author as a second fitted character in the repo, with his own film in the kitchen example, so the tests that needed his model run for everyone (0e750a6)
- DOCS: Blender is optional, not experimental: the README shows the trailer, the site has a page on 3D characters with what your machine needs, and only fitted characters keep the experimental label (af6b0fc)
- ADD (experimental): examples/blender-kitchen, a 27.6 s film with a fitted character that runs from the repo: Mara walks in with a mug, sits, opens a laptop and drinks (bb3b37c)
- DOCS: a film starts from a brief the person brings and a storyboard made from check stills before anything renders, with a roadmap item to make both tools (6691cd2)
- DOCS: the Blender page tells a model from the rig and a render, with a picture, and lists what a session measures before it hands a film over (d812fdc)
- DOCS: a character film takes hours to render, and how one is carried over several sessions by a prompt each session writes for the next (dd6205a)
- ADD (experimental): a mug held by its handle, picked up and drunk from, checks on what a hand carries, and shaped brows on a fitted face (0d2e3f2)
- TEST, DOCS: the kitchen, a seated lid by the fingertips, and what a standing arm cannot reach (c719b85)
- ADD (experimental): a kitchen set with a mug, a lid opened and shut by hand, and Claude the CRT at his keys (78f0356)
- DOCS: frames read from their source, shots played by id, a pick-up is an onset cue, and the render itself is read every 10 s (2ca73e6)
- FIX (experimental): the flicker check reads still points between pixels, so writing on a board under a moving camera is not reported (40647aa)
- ADD (experimental): BlenderClip takes a crop and a background, so one part of a clip can fill an inset (338687b)
- TEST, DOCS: a walk's stride, a loose hand, the whistle and a sound's gains (0df1122)
- ADD (experimental): a clip's effects can be written again with one kind of sound turned down, such as footsteps under a door (fe7d889)
- ADD (experimental): a walk takes a stride, a free hand can hang loose, and the lips can purse for a whistle (de7a15e)
- FIX (experimental): a hand that has put a cup down goes back to the side round the belly, and the chest leans a little further to the table (82f7f62)
- TEST, DOCS: the lecture hall, the presenter verbs and the fixed camera (e2c96c2)
- ADD (experimental): a lecture hall set and presenter verbs: the mouth on the narration's words, gestures, showing a board, a cup carried and put down, chalk in the hand, hands dusted (5150dc3)
- ADD (experimental): a fixed camera shot, put where the spec says, with a window that renders one part of the frame and a slow push (448c40c)
- FIX (experimental): the flicker check leaves a still point out while a limb moves beside it, so fingers' shadows crossing a desk are not read as flicker (383c4cd)
- DOCS: the Blender docs cover hands sized to the body, the wrist at the cuff, furniture from the body's measures, the one-frame jump check, welding seams before reducing a model, and how the rig is refined on two bodies (4ee56fe)
- TEST: Mara's model is reduced again with its seams welded first (it had opened along every seam: torn cloth and shards round the eyes) (279f784)
- FIX (experimental): a resting hand's fingertips are held just off the leg, lap hands lift clear before they reach, and a swinging arm has room for the stride's roll (222068c)
- FIX (experimental): the fit erases painted lashes that run past an eye, leaves flecks of sleeve out of the hand it cuts off, keeps the wrist's stub with the forearm, and smooths a lump off a hand where the fit says (f3d466a)
- FIX (experimental): the walk-in passes on a second fitted character (Mara): desk, keys, door reach and lap come from each body's own measures, hands travel between spots, and a new check fails anything that jumps in one frame (6845439)
- FIX (experimental): the fit sizes a donor's hands to the body's own, puts the wrist joint at the cuff and measures each part of the sleeve, so nothing in a hand or an arm is read off a still (0b6b6b4)
- DOCS: the Blender skill and docs cover parted legs, brows under a fringe, head shots on a fitted character and the Mara example (a8e565a)
- TEST: Mara, an invented fitted character in tests/fixtures, is fitted with a face and fingers and acts, so the fit is tested without anyone's likeness (9c7ce0f)
- FIX (experimental): a fitted character's head shots aim at its own head, not where the clay cast's would be on legs as long (7876f49)
- FIX (experimental): the fit parts legs a generator made touching, and erasing painted eyes leaves a fringe and the blush alone (brows_hidden for a brow under the hair) (a48ed88)
- DOCS: the Blender skill and docs cover point, the thumb the fit lays in to the palm, and how a hand lies on keys and a desk (abeb7f2)
- FEAT (experimental): point lifts the arm nearly straight at a target in the room, the screen or the camera, with the hand on the target's side, and says how true the aim is (43f5aaf)
- FIX (experimental): a fitted hand's thumb is laid in to the palm in the fit (the fit fails if it still stands off), so the hands type at a typist's slope of 20 degrees, and a hand laid flat rests on its heel and fingers together (ff58803)
- DOCS: the Blender skill and docs cover how a fitted character's arms hang and swing and how its hands type, with the fitted test asserting both (98fb6c7)
- FIX (experimental): a fitted character's arms hang from the shoulder and swing like a pendulum, its typing hands rest on the keys and the fingers press them, and check measures both (walks.arms, typing) (1a5a470)
- FIX (experimental): a fitted character's hands keep the palm to the leg through a walk and no longer turn over on every swing, check measures it as palm_turn_deg, and the docs cover making grafted hands smaller (7ab3bd9)
- DOCS: the Blender skill and docs cover the fitted face, hands with fingers, curved walks and the flicker checks, with tests for a bent walk, hand shapes, the shared-plane check and flicker in a render (729ec32)
- FEAT (experimental): a fitted character gets a face made from its own marks and hands with fingers (hand shapes, a grip, palms laid flat by measurement), walks can bend, and check measures the face, the skin, fingertips in the body, hands into each other and a tipped palm (af80f1e)
- FIX (experimental): the door set has no faces in one plane, check fails a set whose surfaces would flicker, and render reads still points out of the finished frames and fails on flicker (d616a2d)
- DOCS: the Blender skill and docs cover the contact checks and the door opened by hand, with tests for a walk-in's contacts, a body that does not move like a machine and a hand on the door (d87178a)
- FEAT (experimental): a fitted character moves like a body: the eyes lead, the chest and head follow the pelvis, the weight shifts, hands travel to the thighs, the lap and a door handle, and check fails on a hand inside the body, a body through furniture, a sliding foot or a missed touch (756c283)
- DOCS: the Blender skill and docs cover standing, walking and fitted 3D characters, with tests for a walk-in and for mistakes with postures (f08904f)
- FEAT: Blender sets and cameras for a character on their feet: a door, a chair that pulls out and in, furniture placed for the character, follow, full, feet and tilt_up shots, wink, look_at, glance and reach, and a check that no foot goes through the floor (e919375)
- FEAT (experimental): a fitted 3D character keeps its own shape and stands, walks, turns, sits down and stands up: it is bound in its A-pose, its feet stay planted on the floor, and blender_render.py fit binds a model in one command (0fab01d)
- FEAT (experimental): a generated 3D character can join the Blender cast: fit_model.py seats and weights an image-to-3D model on the rig, and a cast entry names it with "model" (b6d7c16)
Full Changelog: v0.28.0...v0.29.0