Fixing tracking errors
What the status messages mean and what helps.
Error messages
| Message | Cause | Remedy |
|---|---|---|
| Camera could not be opened | Device busy or wrongly chosen | Close the other program, pick the camera again |
| Model download failed | No internet on first run | Check the connection, start again |
| Python 3 not found | Fallback path without the bundled tracker | Install Python 3 |
| Tracker program missing | Incomplete installation | Reinstall Hologramu |
| Graphics libraries (libGL) missing | Distribution without Mesa/OpenGL packages | Install libgl1, libglib2.0-0 [linux] |
| Preview not possible | GUI libraries missing | Tracking keeps running regardless |
| Tracker exited unexpectedly | A crash | See below |
When the tracker crashes
TODO: Where the log lives and what belongs in a report.
The avatar shakes
TODO: Smoothing, room lighting, camera frame rate.
The avatar drifts away
TODO: Reset the pose, calibrate, check "avatar moves along".