Troubleshooting

License errors

"Monolook license key required"

• You must provide a licenseKey in the constructor

"License validation failed"

• Check that the license key is correct
• Verify that your domain is authorized for this license
• Check your internet connection

"BUILD_ID mismatch"

• You are using an SDK build that does not match your license
• Contact support for an updated license

"Token expired"

• The SDK refreshes tokens automatically
• If the issue persists, check that the system clock is correct

Video not showing

• Make sure to use colorSpace = THREE.SRGBColorSpace on the texture
• Use toneMapped = false on the material
• Use flipX: true if the video appears mirrored

Poor tracking

• Check that the marker image has enough contrast
• Improve lighting conditions
• Use a larger printed marker (minimum 10x10 cm)
• Keep the camera stable
• See Good markers

WASM not loading

• Make sure minitrack-wasm.js is in the same directory as minitrack-core.js
• Check the browser console
• Verify that the server serves .wasm with MIME type application/wasm

WebXR not working

• WebXR requires HTTPS
• Check that the browser supports WebXR (Chrome 90+, Firefox 88+)
• On iOS, WebXR is not available: use the AppClip bridge

Camera not activating

• The user must grant camera permission
• HTTPS is required for camera access
• Some browsers block camera in iframes: use allow="camera" on the iframe