Kinalyse

Support

Kinalyse for macOS.

Email info@kinalyse.com. Please say which version you are running — it is at the bottom of every exported report, and in the app under Settings — and what you did, what you expected, and what happened instead.

Ask for help Report a bug

Help is inside the app

Kinalyse ships its full documentation with it, so it works without a connection: open Help from the sidebar or press ⌘?. It covers calibration, tracking, the guided tests, what each measurement badge means, and how to read a result.

Common problems

Voice-over records nothing

macOS grants microphone access once, the first time you record. Open System Settings ▸ Privacy & Security ▸ Microphone and check Kinalyse is switched on. If it already is, switch it off and on again, then quit and reopen Kinalyse — the permission is read when the app starts.

Check System Settings ▸ Sound ▸ Input too: if a headset is selected but not plugged in, macOS records from a device that is not there.

My athletes are missing after an update

Kinalyse now keeps its data in a protected folder of its own. If you used a version from before that change, your athletes are still in the old location. Settings ▸ Data ▸ Import from a previous install… brings them across. It never overwrites anything already there, so it is safe to run twice.

Tracking loses the point

Most often it is the footage rather than the settings.

Motion blur means the point genuinely is not sharp in the frame — a faster shutter fixes it and nothing downstream can. Occlusion, where a limb passes in front, is corrected on the far side of the crossing. A low-contrast point is worth re-picking somewhere the tracker can see.

The in-app help topic Tracking loses the point goes through the rest.

A number looks wrong

Every result carries a badge saying how it was obtained, and exported reports include a methods section giving the formula and the assumptions behind each one. That is the first place to look: most surprising numbers come from a broken assumption rather than a broken calculation — an athlete filmed off-axis, a clip at 30 fps, or a calibration measured out of the plane of movement.

If it still looks wrong after that, it may well be a bug. Send the clip if you can.

A capture file will not open

Kinalyse reads C3D, TRC, MOT and CSV. A file that fails now reports why rather than closing the app — if you get a message naming a bad field, send it along with the file if you are able to share it.

The report window is blank

Quit and reopen Kinalyse, then try again. If it persists, the report itself is fine — use Save HTML in that window and open the file in a browser, and let us know so it can be fixed properly.

Reporting a bug well

A screenshot is worth a great deal. A description of a layout problem is much harder to act on than a picture of one, and several issues have been fixed within minutes of an image arriving.

If a specific file causes the trouble, say so — a capture that will not open is usually reproducible, and that makes it fixable.