Troubleshooting
AI generation fails or times out
| Symptom | Fix |
|---|---|
| "Daily limit reached" / out of tokens | Wait for reset, or ask admin to grant tokens |
| Connection failed | Check internet; confirm you're signed in for cloud features |
| "Requires desktop app" | Cloud AI runs inside Kinetix Sync desktop — download from Apps → Sync |
| Closing AI panel mid-generation crashed app | Fixed — update to the latest build |
No audio / flat meter
- Confirm DJ app is playing
- Check Kinetix input device matches your routing (LitLink, Serato Virtual Audio, etc.)
- Mac: grant Microphone permission for Kinetix Sync
- Open in-app Troubleshoot for detected-app-specific steps
macOS blocks the app (unsigned)
- Open
.dmg→ right-click Kinetix Sync → Open → confirm - Or:
xattr -cr "/Applications/Kinetix Sync.app"
Settings changes not saved
Click Save before closing Settings. Unsaved changes prompt to discard.
Shader looks wrong after AI edit
Send a follow-up in AI Studio: e.g. "more uDetail shimmer, less uBeat flash". Built-in seeds start from a known-good template.
Data folders
Default location: ~/Documents/Beat Sync/ (Sessions, Custom Templates). Change in Settings → Storage.