Katpootli guide
Katpootli turns a rigged 3D character into a puppet: grab a bone with your mouse, move it, and the motion is recorded as animation. Layer movements one limb at a time, or lock in key poses and let Katpootli animate between them. Then download the result for Blender, Unity, Unreal Engine or the web.
1. Get a rigged character
Katpootli animates characters that already have a skeleton (a rig): a hierarchy of bones that the mesh is skinned to. Most characters from asset stores, game kits, VRoid/VRM, Ready Player Me and Blender's Rigify have one. If yours doesn't, upload the mesh to an auto-rigger such as Adobe Mixamo, download the rigged result as FBX, and use that.
2. Open it
Drag your file onto the page or click Open model. Katpootli reads GLB/glTF and FBX files, either on their own or in a .zip together with their textures. Textures are matched by file name, so a zip straight out of an asset store usually just works. If a texture is missing, Katpootli tells you which file it was looking for.
The file is opened in your browser and never uploaded. Your work is autosaved in the browser too, so reloading the same file later brings your takes back. Use Clear all in the Takes panel to start over.
3. Select and pose bones
- Switch to Bones view (key B) to see the skeleton through the mesh.
- Click a bone in the viewport, or pick it from the bone list on the left. Use ↑/↓ to jump to the parent or child bone, ←/→ for siblings, and Tab when several bones overlap under the cursor.
- Drag the rotation rings to rotate (R). Only the root/hips bone can be moved (G), because moving other bones stretches the mesh. You can allow it per bone with Allow bone stretch.
- Rest pose puts the character back in its original pose.
4. Record live motion
Select a bone and press Start animation. After a 3-2-1 countdown (you can turn it off), everything you do with the bones is recorded in real time. Press Stop animation or Space when you're done. Katpootli smooths the motion (set how much with Smoothness) and plays the new take in a loop.
For precise moves, set Record speed to 0.5× or 0.25×: you perform in slow motion and the take plays back at normal speed.
5. Layer takes
Each new take plays the earlier ones underneath while you record, so you can build a performance one limb at a time: legs first, then arms, then the head. For every bone, the newest take that moved it wins during that take, and older takes fill in the rest. Mute or delete takes in the Takes panel to try variations.
6. Pose-to-pose with keys
Prefer posing to performing? While recording, put the character in a pose and press Add key (K). Pose it again and add another key. When you press Stop, the take animates from the starting pose through each key to the final pose, and the live movement in between is discarded. Keys appear on the timeline as soon as you add them.
Choose how far apart the keys are (Key spacing: 0.5 s, 1 s, 2 s or as recorded) and how they blend (Smooth or Linear). Afterwards, click a ◆ key on the timeline to select it, drag it to retime it, or press Delete to remove it.
7. Edit, undo and clean up
- Undo Ctrl/⌘ Z and Redo Ctrl/⌘ Shift Z work for bone edits, recordings, deleted or muted takes, key moves and Clear all.
- Scrub the timeline to inspect any frame; change the playback speed or turn looping off.
- In Export, Trim cuts the clip and Loop-friendly blends the end into the start for seamless loops such as idles and walk cycles.
8. Export
- Download GLB: the glTF binary format, for the web, three.js, Babylon.js and Godot.
- Download FBX: binary FBX, for Blender, Unity, Unreal Engine and Maya. Animation is baked at the frame rate you choose (24, 30 or 60 fps).
- Contents → Character + animation includes the mesh, materials and textures.
- Contents → Animation only exports just the skeleton and the bones you moved, under their original names, so the same clip drives every character with the same rig.
Every export is loaded back and checked automatically before it downloads.
9. Use it in your engine
- Blender: File → Import → FBX (or glTF). The animation appears as an action on the armature.
- Unity: drop the FBX into your Assets folder. For an animation-only file, set the rig type to match your character (for example Humanoid for Mixamo characters).
- Unreal Engine: import the FBX and choose your character's existing skeleton to import the animation onto it.
- three.js: load the GLB with
GLTFLoaderand playgltf.animations[0]with anAnimationMixer.
10. Troubleshooting
- "This model has no rig": the file contains no skinned mesh. Rig it first (see step 1).
- Textures missing: put the model and its texture files in one .zip and open that.
- Moving a bone stretches the mesh: only the hips should be moved; rotate the others.
- Animation-only clip doesn't play on another character: the bone names must match. Clips from one Mixamo character work on other Mixamo characters.
- Blank viewport: your browser or graphics driver has WebGL turned off. Try an up-to-date Chrome, Edge, Firefox or Safari.
Frequently asked questions
Is Katpootli free?
Yes. Katpootli is free to use, with no account or sign-up. The site is supported by ads.
Are my 3D models uploaded anywhere?
No. Your files are opened and processed inside your browser. Nothing is sent to a server, and your takes are only autosaved in your own browser storage.
Which file formats can I open?
Rigged characters as GLB/glTF or FBX, either loose or inside a .zip with their textures. OBJ files open too, but OBJ cannot store a skeleton, so rig them first.
My character has no skeleton. What can I do?
Upload it to an auto-rigger such as Adobe Mixamo, download the rigged result as FBX, and open that in Katpootli.
Which formats can I export?
GLB (for the web, three.js, Godot, Babylon.js) and binary FBX (for Blender, Unity, Unreal Engine and Maya). You can export the character with its animation, or the animation only.
Can I use one animation on several characters?
Yes. Choose Contents → Animation only when exporting. The file keeps the original bone names, so it plays on any character that uses the same rig, such as other Mixamo characters.
Can I use the animations I make commercially?
Yes. Animations you create are yours. Make sure you have the rights to the character model you animate.
Does it work on phones and tablets?
Katpootli is designed for a desktop or laptop browser with a mouse. It needs WebGL, which all current versions of Chrome, Edge, Firefox and Safari support.