ODDSPRIG ANIMATION STUDIO - HOW TO Updated: 30 October 2026 - Framing & Review 1.2 Open: https://oddsprig.com/tools/animation-studio/ Find it: https://oddsprig.com/tools/music-video/ WHAT IT DOES Build a sequence from the same rigged characters and imported animation clips. Direct connected shots, cameras and sound, then export video on your own device. You use the webpage. No local Bridge server or paid media service is required. ASSET STATUS, CAMERA FIT AND REPEATABLE REVIEW Cast/model cards show GLB-derived rig/joint, animation-clip and morph information. "0 animation clips (rest pose)" means no performance is included. Unknown stays unknown; counts do not prove correct weighting or animation quality. Select a cast member and enable 3D preview. Under Quick framing & review: - Fit selected actor prepares a static camera around its CURRENT posed geometry. Frame padding 1.15 gives margin on both axes. Roll, lens and projection remain. Applying replaces that shot's timed camera move; inspect the prepared report. - Prepare review shots appends eight one-second rest views at world camera yaw 0,45,90,135,180,225,270,315 degrees around the cast member's BASE root pose. Those angles describe the camera, not the character's authored facing. - Include clip midpoints adds separately fitted frozen midpoint views of real imported named clips (at most 24 per plan), using measured source durations. Both buttons fill and preview a JSON scene plan without saving. Apply prepared plan commits once. Prior shots, assets and sound remain. Save project preserves the fitted cameras and review shots in the complete backup. AI FRAMING AND REVIEW const studio = window.oddsprigAnimationStudio; await studio.idle(); // Seek to the intended shot/frame before fitting its visible posed actor. const fit = studio.fitPlan({actor_id:'COPY_ACTOR_ID', padding:1.15}); // Inspect fit.assistance and fit.document, then explicitly commit if desired. await studio.applyPlan(fit, fit.revision); const review = await studio.reviewPlan({actor_id:'COPY_ACTOR_ID', source_shot_id:'COPY_SHOT_ID', include_clips:true, padding:1.15}); await studio.applyPlan(review, review.revision); Copy actual IDs from inspect(); the example IDs above are placeholders. fitPlan options: actor_id?,shot_id?,padding?,bounds?. reviewPlan options: actor_id?,shot_id?/source_shot_id?,padding?,bounds?,include_clips?,clip_samples?, clip_names?. clip_names selects up to 24 unique exact source names. Supplied bounds are {min:[x,y,z],max:[x,y,z]} in WORLD units. Numeric review with preview off needs bounds at the cast BASE root pose; include_clips also needs clip_samples:[{name,duration,bounds}] with actual duration in seconds and actual midpoint bounds. Supplied values are labeled supplied, not measured here. No helper enables GPU, fetches media or saves implicitly. Impossible camera fits fail instead of clipping the asset. Exact measurement has a 10,000,000 vertex-work budget per sample; oversized work fails without truncation. Review refuses to quietly omit a requested view. Select fewer clips if necessary. QUICK START: TWO CONNECTED 10-SECOND SHOTS 1. Open RiggerSet: https://oddsprig.com/tools/riggerset/studio/ Finish the character rig and animation there. Export a self-contained animated GLB. Keep the original editable character file as your master. 2. Open Animation Studio and choose Import GLB models. Your first model creates a reusable cast member and a 10-second shot. Sets and props can be GLBs too. A GLB must contain its textures/resources; separate linked files are unsupported. 3. Enable 3D preview. Choose a cast member and an imported animation clip under Actor direction. Set its start/end position, rotation and scale; animation start time, speed and loop setting. Choose Save actor direction. Rotations use radians. Positions use the model's units. Clip names come from the actual imported file; importing a rig alone does not create a performance. 4. Set the shot's camera position, look-at point and field of view. Choose Save shot & camera. Expand Angles, lens & clipping for yaw/pitch/distance, roll, projection and lens. Timed camera move adds a moving camera window. 5. Select the shot and choose Add connected shot. The next shot starts at its end transforms and continues its animation phase. Reuse the same cast member to keep the character consistent. Change the new shot's camera/direction. 6. Import WAV, MP3, OGG or WebM audio. Add a cue from the audio library to a shot, set its start time, offset and gain, and save the cue. Sound can continue across shots: add that cue once, rather than replaying it in every shot. Play sound enables audible preview. Muting preview does not mute export. 7. Scrub or play the sequence. Use the shot arrows to reorder, Duplicate shot to make a copy, and Remove shot to remove that shot's direction. 8. Choose Export selected shot or Export sequence. Preview must be enabled. Wait for Download video. MP4 is used when supported; WebM is the fallback. Cancel export stops an unfinished export and restores the preview. SAVING AND REOPENING - Accepted changes save in this browser on this device. Wait for Saved version. An edited form is not saved until you press its save button. - Save project downloads a complete .sprigfilm backup with the production, imported models and sound. Use it regularly and before switching devices. - Open project restores a .sprigfilm into the current production. Use New first when you want to keep the current production separately. - New opens a separate empty production with its own URL. Bookmark that URL to return to that production. The main studio URL opens the default production. - Browser data can be cleared or evicted. A downloaded backup keeps your work independently of the browser. The site does not upload your models or audio. - If another tab or AI changed the production, choose Reload saved before trying another edit. Revision checks prevent silent overwrites. KEEPING SHOTS CONSISTENT - Reuse the same GLB and cast member across shots. - Choose the frame rate before directing. Lengths save to whole frames. - Add connected shots after the preceding direction is saved. - Editing an earlier shot or changing the frame rate does not automatically rewrite all later directions. Recheck those cuts afterward. - Preserve the original RiggerSet character master as well as .sprigfilm backups. CAN AI OPERATE IT? Yes, an AI agent connected to this browser can operate its named controls. It can inspect the production, import supplied files, direct actors and cameras, pick existing animation clips, add/reorder connected shots, arrange sound cues, and save or restore complete project backups. It can use browser controls for preview and video export. The webpage does not include an AI chat pilot. Simply opening this webpage does not connect a separate AI service or your Bridge workspace. The agent needs access to this page and browser profile, and access to the files you supply. There is no automatic sync between Bridge's workspace and this browser's data. AI does not currently generate character performances, voices, lip sync or finished episodes inside this app. Use imported assets/clips/audio and review the result. Video quality depends on those source assets and the direction. INSTRUCTIONS FOR A BROWSER-CONNECTED AI AGENT The page exposes window.oddsprigAnimationStudio. Use named commands instead of guessing IDs or modifying IndexedDB directly. Commands do not automatically enable GPU preview, start a model download or call a paid service. First wait for storage and inspect: const studio = window.oddsprigAnimationStudio; await studio.idle(); const { document, asset_details } = studio.inspect(); document contains the saved revision, assets, cast and shots. asset_details is an array containing the imported files and their actual clip names in clips. Inspect again after each accepted change. Copy IDs and clip names exactly. Example: add a shot that continues the preceding shot: await studio.command( { op: 'shot.add', name: 'Next shot', inherit: true }, document.revision ); Every command requires the current expected_revision as its second argument. If a command fails with a revision conflict, use Reload saved in the webpage, inspect again, and decide whether the intended change is still appropriate. SUPPORTED COMMANDS production.rename: {op, name} production.settings: {op, fps?, width?, height?} actor.add: {op, asset_id, name} actor.update: {op, id, name?, position?, rotation?, scale?} shot.add: {op, name?, after_id?, inherit?} shot.update: {op, id, name?, duration?, background?, camera?} shot.track: {op, shot_id, track} shot.audio: {op, shot_id, audio} shot.move: {op, id, index} shot.duplicate: {op, id} shot.remove: {op, id} document.import: {op, document} Here op means the exact command name above, e.g. 'shot.update'. Optional fields are marked ?. For update/settings commands, supply at least one changed field. Every vector is [x,y,z]. Positive scale is required. Shot indices start at 0. shot.audio replaces the whole cue list; shot.track replaces only that actor's track. Preserve anything you intend to retain. document.import requires media already in this production; it is not a complete-project backup import. camera = {position:[5,3,7], target:[0,1,0], fov:45} pose = {position:[0,0,0], rotation:[0,0,0], scale:[1,1,1]} track = { actor_id: 'COPY_FROM_INSPECT', from: pose, to: pose, clip: 'EXACT_IMPORTED_CLIP_NAME', clip_start: 0, speed: 1, loop: true, visible: true } audio = [{asset_id:'COPY_AUDIO_ID_FROM_INSPECT', start:0, offset:0, gain:1}] These are field examples, not valid IDs to send unchanged. Empty clip '' selects rest pose. For a model without named animation, inspect its fallback clip name. FILE AND BACKUP METHODS await studio.importFile(file): import a supplied browser File (GLB/audio). await studio.exportProject(): return a Blob containing a complete .sprigfilm. await studio.importProject(file): restore a supplied .sprigfilm File. await studio.idle(): wait for queued storage operations. studio.assetUrl(id): return an owned Blob URL for an already-loaded asset. exportProject is a PROJECT BACKUP, not a rendered movie. Use the visible video export controls to render/download the movie. The API does not expose a named render-video command. Enable preview and sound only when authorized; the file picker and download controls still require the agent's browser/file access. LIMITS - 12-60 fps; output 16-3840 pixels wide and 16-2160 pixels high. - Each shot is 0.25-60 seconds, rounded to whole frames. - Up to one hour of saved shots, 1,000 entries per collection and 2 MiB of production metadata. Each GLB is at most 64 MiB; audio at most 32 MiB. - Complete .sprigfilm backups are at most 1 GiB. - Each video export is at most 10 minutes or 36,000 frames and uses browser memory. Use shorter segments and a final editor for full movie assembly. - Cameras can move on timed linear/orbit paths; actor transforms support timed keys. Performances come from imported bone/morph clips. No built-in bone keyframe editor, physics/IK editor, compositor, subtitles or final multitrack timeline. - Extra model compression decoders and external glTF resources are unsupported. - Preview/export depend on working browser WebGL/WebCodecs and available memory. NUMERIC DIRECTOR: BUILD THE SCENE WITH NUMBERS The scene clock shows a zero-based frame and HH:MM:SS:FF timecode. FF is a frame number, not milliseconds. At 24 fps, two 10-second shots contain 480 frames: shot 1 owns scene frames 0..239, shot 2 owns 240..479. The cut end is exclusive. Use the Scene frame box or previous/next frame buttons to seek exactly. In the inspector, expand these sections: - Frames & timing markers: set exact whole-frame shot length. Add named markers at the playhead and edit their frame offset, duration and color. They label beats and timers; they do not execute arbitrary events. - Angles, lens & clipping: target xyz, yaw, pitch, distance, roll, vertical FOV, perspective/orthographic projection, orthographic vertical span, near/far, focal length and sensor width. The output aspect controls lens conversion. - Timed camera move: start, duration, easing, linear/orbit interpolation and a full endpoint camera. Camera holds before/after the window. Clear resets it. - Timed actor movement: move from/to poses during a selected time window. - Transform keyframes: add multiple transform keys at exact playhead frames; edit each position/rotation/scale/easing, then save. Keys must be ordered. Nonempty keys OVERRIDE simple from/to and root movement; clear keys to return. - Clip clock & visibility window: delay, stop or limit imported animation and show an actor only during a selected inclusive time window. - Production lighting & look / Shot lighting & look overrides: exposure, tone mapping, shadows and their map size/span/bias; sky/ground light; key/fill/rim light colors, intensities and positions; floor material; grid; fog distance. Checked Override fields are authored here. Unchecked shot fields inherit production settings. Editing a value checks its override. Save the form. UNITS AND EVALUATION +Y is up. Camera yaw 0 is +Z from its target, yaw +90 is +X. Positive pitch is above the target. Exactly vertical camera positions use +Z as the roll reference. Camera yaw/pitch/roll/FOV use DEGREES; FOV is vertical. Actor rotation uses RADIANS in XYZ order. Position/scale follow the source GLB units; keep an agreed model scale across assets. Orthographic span is vertical world units. Focal length/sensor width use mm. Far must exceed near; camera position must differ from target; moving cameras keep the same projection at endpoints. Authored seconds snap with floor(seconds * fps + 0.5). Nonzero movement windows must span at least one frame and remain inside their shot. Up to 128 transform keys per actor per shot and 128 markers per shot. Easing: linear, step, ease_in, ease_out, ease_in_out, smoothstep. A key's easing controls its outgoing segment. Endpoint transforms hold outside the key range. Orbit uses the shortest yaw arc. A positive marker duration excludes its end frame; duration zero labels one frame. Plan camera.lastFrame is the final encoded sample; camera.end is the boundary pose used by connected-shot inheritance. A step ending exactly at the cut changes at that boundary, so end it one frame earlier to show the destination before the cut. clip_timing {start,duration} advances the source clock only inside that window. It still combines with clip_start, speed and loop. API duration 0 freezes it. visibility {start,end} includes both endpoints and also requires visible:true. Connected shots inherit the evaluated END pose/camera/clip phase and clear local keys/movement/clip/visibility windows so the previous action does not replay. Editing earlier direction does not automatically rewrite an existing later shot. AI: PREVIEW A PLAN BEFORE ONE ATOMIC SAVE Use the JSON scene plan panel. Load cast example fills a real plan using the selected/imported actor (or a camera-only plan without cast). Preview plan shows calculated timeline, camera start/end, look settings and warnings without saving. Apply prepared plan commits once. Edits after preview require another preview. A stale preview is rejected. No GPU is needed for numerical planning. const studio = window.oddsprigAnimationStudio; await studio.idle(); const snapshot = studio.inspect(); const catalog = studio.settings(); const commandGuide = snapshot.command_guide; const commands = [ {op:'shot.add', as:'wide', name:'Wide', inherit:true}, {op:'shot.timing', shot_id:'$wide', frames:240}, {op:'camera.orbit', shot_id:'$wide', target:[0,1,0], yaw:35, pitch:12, distance:8, fov:45}, {op:'shot.markers', shot_id:'$wide', markers:[{name:'Action',time:2,duration:1}]} ]; const preview = studio.plan(commands); // Inspect preview.document, preview.bindings and preview.summary. await studio.applyPlan(preview, preview.revision); const timeline = studio.timeline(); const predicted = studio.evaluate(48); studio.seek(48); Use frames:studio.inspect().document.fps * 10 for ten seconds at the CURRENT fps. The literal 240 above assumes 24fps. Scene evaluate/seek accepts an integer from 0 through totalFrames-1. evaluate() is pure math; seek() updates the visible playhead and draws only when preview is already enabled. inspect().scene is the actual rendered camera/lights/actor matrices when preview is ready, else null. Numerical transforms cannot invent missing bone animation or make a poor asset look good; choose the actual imported performance and review the rendered cut. A plan has 1..256 commands, no nested batches. actor.add, shot.add and shot.duplicate may use as:'handle'. Later ID fields may reference '$handle'. Handles resolve only IDs, never text. Preview reserves the prepared document's IDs; apply saves that document without recompiling a different set of IDs. The expected revision must still match inside the storage queue. ADDITIONAL COMMANDS (exact required/optional fields in AI-CONTROLS.json) shot.timing: {op,shot_id,frames} shot.markers: {op,shot_id,markers} [] clears camera.orbit: {op,shot_id,target,yaw,pitch,distance,fov?,roll?,projection?,ortho_scale?} camera.lens: {op,shot_id,focal_mm,sensor_width_mm?} camera.motion: {op,shot_id,motion} null clears motion={to:camera,start,duration,easing,mode:'linear'|'orbit'} actor.motion: {op,shot_id,actor_id,start,duration,easing?} actor.keyframes: {op,shot_id,actor_id,keyframes} [] clears key={time,position,rotation,scale,easing?} actor.clip: {op,shot_id,actor_id,clip?,clip_start?,speed?,loop?,visible?,clip_timing?,visibility?} null clip_timing/visibility clears the respective window production.look: {op,look} null clears shot.look: {op,shot_id,look} null clears document.batch: {op,commands} one atomic commit Look commands deep-merge partial overrides. To remove individual overrides, clear the scope then apply the remaining override object in one batch. shot.track replaces that actor's complete track; preserve optional fields you intend to keep. shot.update camera replaces the full camera; preserve optional lens/projection/clipping fields. camera.orbit preserves existing optional fields. Machine-readable bounds/defaults/commands/API example: https://oddsprig.com/tools/animation-studio/AI-CONTROLS.json The public studio-math.js evaluator has no DOM, storage, renderer or network dependency; use it with studio-settings.js and studio-errors.js for shared math. BACKUP COMPATIBILITY Old saved projects and older .sprigfilm backups remain supported. New backups use header format_version:2 so an older studio rejects them instead of silently stripping numeric director settings. Refresh old tabs before opening new backups. The document schema remains version 1; optional director fields need no migration. IF SOMETHING FAILS - No animation: confirm the GLB actually contains clips and choose one exactly. - Missing textures: export a self-contained GLB from your character tool. - Save conflict: Reload saved; do not keep retrying an old revision. - Storage full: download a project backup and free browser/device space. - Preview error: turn preview off/on; check the model format and device support. - Export error: try a shorter segment or lower output resolution, and read the displayed error. An unsupported codec is not a completed export. ONLINE HELP https://oddsprig.com/tools/animation-studio/help.html Download this guide: https://oddsprig.com/tools/animation-studio/HOW-TO.txt