Troubleshooting Guide

Verification stuck at "Analyzing audio..."

Cause: Track may not have audio preview available from Deezer

Solution:

• Wait 30 seconds - system will continue with metadata-only analysis
• Metadata-only results are still valid but may have lower confidence
• If stuck longer than 60 seconds, refresh page and retry

"Track not found in database" error

Cause: Database cache delay or track not in system

Solution:

• Wait 5 seconds and click "Refresh Track List"
• Verify track name and artist spelling
• Try alternative spelling or official release title
• If persistent, report via feedback button with track details

Results seem incorrect or unexpected

Cause: Beta software still learning, edge cases, or ambiguous tracks

Solution:

• Click thumbs down button on results page
• Provide details in feedback form (why you think it's wrong)
• Include any additional context (known AI platform, human artist proof)
• Your feedback directly improves model accuracy

Confidence score is very low (<40%)

Cause: Ambiguous track, limited data, or edge case

Interpretation:

• System is uncertain - don't rely on low-confidence results
• Try re-running verification (may fetch better data)
• Check if audio analysis was included (higher confidence)
• Consider manual expert review for critical decisions

"API rate limit exceeded" message

Cause: Too many verifications in short time period

Solution:

• Wait indicated time (usually 30-60 seconds)
• Beta testers have higher limits than production Free tier
• Contact support if limits seem too restrictive for testing

Page won't load or shows blank screen

Solution:

• Hard refresh: Ctrl+Shift+R (Windows/Linux) or Cmd+Shift+R (Mac)
• Clear browser cache and cookies for beta.copyrightchains.com
• Try different browser (Chrome, Firefox, Safari recommended)
• Disable browser extensions temporarily (ad blockers can interfere)
• Check browser console (F12) for error messages, share with support

Track dropdown not loading

Cause: Database connection issue or initial load delay

Solution:

• Wait 10-15 seconds for initial load
• Click "Refresh Track List" button
• Check internet connection
• If persistent, check browser console for WebSocket errors

Results not displaying after verification

Cause: WebSocket connection lost or display bug

Solution:

• Scroll down - results may be below fold
• Wait 5 seconds - display may be delayed
• Refresh page and check "Recent Verifications" section
• Report bug with browser console screenshot

Can't export report (PDF/JSON)

Cause: Browser popup blocker or download restriction

Solution:

• Allow popups for beta.copyrightchains.com
• Check browser Downloads folder (may have downloaded silently)
• Try right-click → "Save Link As" on export button
• Use different browser if issue persists

Login fails or session expires quickly

Cause: Cookie settings or beta authentication issue

Solution:

• Enable third-party cookies for beta.copyrightchains.com
• Clear cookies and re-login
• Check that you're using credentials from beta acceptance email
• Contact support if credentials don't work

Audio features all show "N/A" or zeros

Cause: No audio preview available for track

Solution:

• This is expected for tracks without Deezer previews
• Results are still valid based on metadata and AI analysis
• Confidence may be slightly lower without audio
• Not a bug - just data unavailability

"Audio download timeout" error

Cause: Slow Deezer server response or network issue

Solution:

• System has 15-second timeout (not user-fixable)
• Retry verification - may succeed on second attempt
• Check your internet connection speed
• Results will continue with metadata-only analysis

Spectral features look unusual or inconsistent

Cause: Audio preview quality varies by source

Interpretation:

• Deezer previews are 30-second clips, not full tracks
• Features extracted from preview may differ from full song
• System accounts for this in confidence scoring
• If multiple tracks show same pattern, may indicate Deezer issue

401 Unauthorized API error

Cause: Invalid or missing API key

Solution:

• Verify API key format: cc93_...
• Check Authorization header format: Bearer cc93_...
• Regenerate API key in dashboard if compromised
• Ensure no extra spaces or newlines in key

Webhook not receiving events

Cause: Incorrect URL, firewall, or signature validation issue

Solution:

• Verify webhook URL is publicly accessible (test with curl)
• Check webhook endpoint returns 200 OK
• Validate HMAC signature using webhook secret
• Check webhook logs in dashboard for delivery attempts
• Test with webhook.site first to verify payloads

Batch API requests timing out

Cause: Too many tracks in single batch or slow processing

Solution:

• Reduce batch size (max 100 tracks, but 20-50 more reliable)
• Disable audio analysis for faster processing
• Implement timeout handling (60 seconds recommended)
• Use webhooks for async processing instead of waiting

Verification taking longer than expected

Expected Times:

• Metadata only: 5-10 seconds
• With audio analysis: 15-30 seconds
• First track of session: +5 seconds (cold start)

If longer: Check network, report if >60 seconds

Dashboard feels slow or laggy

Solution:

• Close unnecessary browser tabs (memory usage)
• Clear browser cache
• Disable resource-heavy extensions
• Check system resources (CPU/RAM usage)
• Beta builds may not be fully optimized yet