Quick start

A five-minute guide to the whole flow: sign in → create a project → upload → diagnose → clean → review → export. If you only read one thing: you must create a project before you can upload (see step 2).

The one-line mental model

Kapnetix cleans motion-capture takes. Confidence measures how cleanly we can fix a take, not how broken it is. You see the same confidence map twice: Before (predicted — plan your review) and After (measured — verify the result). Raw capture is never modified; every cleanup is a new Clean v1, v2, … version.

1. Sign in

Open the site and choose Continue with Google or enter your work email. Your first sign-in creates your own private workspace — your data is isolated from everyone else's. You'll land on Projects & Data.

2. Create a project — do this first

Uploads attach to a project, so a brand-new workspace needs one before anything can come in.

• Click the ＋ next to Projects in the left rail (or the prompt in the upload dialog) and name it — for example Bones · Ch.1.
• Select it in the left rail.

TIP

If you open Upload with no project yet, the upload button stays inactive until a project exists. Create one first.

3. Upload takes

Click Upload (top-right). In the dialog:

• Drop files onto the dashed area, drop a whole shoot-day folder, or click it to pick files from your machine.
• Supported formats: FBX · C3D · BVH · TRC · TAK · VDF — format and tags are auto-detected.
• Confirm the project (and shoot day), then click Upload N files.

TAK and VDF are read-only

TAK (OptiTrack Motive) and VDF (Vicon Shōgun) are read-only formats. You can upload and clean them, but their clean versions and exports come back as FBX — there's no writer for TAK or VDF. The dialog says so. See Supported formats.

Large multi-take uploads run one after another with a per-file progress bar; you can leave the dialog open.

4. Data screen — takes auto-diagnose

Each uploaded take is diagnosed automatically. This takes from seconds to a few minutes for large multi-performer takes. Watch the take row:

• Diagnosing… → then a status: Clean (kept as raw), High confidence, Low confidence, or Recommended manual cleanup.
• The right panel shows the take's stats (duration, markers, actors) and its version stack (Raw capture → Clean vN).

Takes are grouped by shoot day and sorted worst-first.

5. Before · Triage — the predicted map

Open Before in the left sidebar. This is the predicted confidence map for a batch:

• A 3D viewer and heat timeline (pink = needs eyes, cyan = clean), per-frame flagged regions (gaps, swaps, jitter), and a triage list split into scheduled versus clean.
• Use it to decide what to clean and how much review to expect. Nothing is changed here.

6. Cleanup run — Auto or Assisted

Open Run. Two modes:

• Auto — cleans every scheduled take unattended. Kapnetix picks the best model per error and applies the fix order (gaps → swaps → jitter).
• Assisted — tune per take: frame range, which error types to fix, which markers (all or specific), and solve constraints (bone-length lock, foot-plant lock, preserve finger contacts). You can also tick already-cleaned takes to re-clean.

Launch with Clean N files. Progress is live; you can leave the screen — results appear in After.

7. After · Review — the measured map

Open After. This is the measured result, verified against what the AI actually did:

• A before → after confidence delta per take, and a Raw / Clean v1 / Overlay viewer toggle.
• What the AI changed, per region: each fill lists what changed, the model that produced it, a confidence, and a Revert button. A reverted region is excluded from the clean version.
• A take that couldn't be verified is shown honestly as unverified, rather than given a fake score.

8. Export

From a cleaned take, choose Export:

• Format: Keep original (or FBX for read-only TAK/VDF). Convert is coming with the convert worker.
• Contents: Cleaned only or Cleaned + original.
• Destination: Download · Shared storage · Pipeline.

The output is standard and editable — straight back into Maya, MotionBuilder, Motive, or Vicon.

Tips

• Start with a small take to see the whole loop fast, then try a large multi-performer one.
• A fresh upload goes all the way through (upload → diagnose → clean → verify). Pre-seeded example takes are illustrative and may not re-diagnose.
• Re-cleaning the same raw file won't change the result — cleanup is deterministic per (raw, options, model). Change the frame range or options, or upload a new raw, to see a different result. See the FAQ.

Known limitations

• Convert-format export (for example C3D → BVH) isn't wired yet — use Keep original or FBX.
• TAK and VDF are read-only in, FBX out, by design.