⏱️ Timing / Latency Issues (Web App Fix Guide)

✅ What this fixes

• Notes feel delayed when you play
• You play correctly, but scoring is off
• Input doesn’t line up with what you hear

Time: 2–10 minutes
Difficulty: Easy → Moderate

🚨 Start Here (Quick Check)

Press a key.

👉 What happens?

• Notes appear instantly AND sound matches timing
  → This is NOT a latency issue → check Scoring Issues (Notes Marked Incorrect)
• Notes appear late OR sound is delayed
  → Continue below

🧠 What’s Happening (Simple)

Latency = delay between:

• Pressing a key
• Hearing the sound

👉 Even a small delay makes timing feel wrong

🔍 Step 1 — Check Your Audio Output

This is the #1 cause.

Avoid:

• Bluetooth headphones
• TV/HDMI audio
• Wireless speakers

👉 These add delay

Use instead:

• Wired headphones
• Built-in speakers

👉 Test again.

• Fixed? → Done
• Still delayed? → Continue

🌐 Step 2 — Use the Right Browser

• Use Google Chrome (recommended)
• Fully close and reopen the browser

⚠️ Common issue:

• Older browsers introduce delay

👉 Test again.

• Fixed? → Done
• Still delayed? → Continue

🔄 Step 3 — Reduce System Load

Your computer may be lagging.

Close:

• Other browser tabs
• Background apps
• Music software / DAWs

👉 Test again.

🎧 Step 4 — Check Audio Settings

On Windows:

• Sound Settings → Output device
• Avoid “enhancements” or virtual effects

On Mac:

• Sound Settings → Output
• Use default output

⚠️ Common issue:

• Audio processing effects causing delay

👉 Test again.

🧪 Step 5 — Is It Input or Audio Delay?

This matters.

Test:

Watch the screen while playing.

• Notes appear instantly but sound is delayed
  → Audio latency issue
• Notes appear delayed
  → Input latency issue

🔧 If Audio Delay

• Switch to wired headphones
• Change output device
• Restart browser

🔧 If Input Delay

• Reconnect keyboard
• Avoid USB hubs
• Try a different USB port

🧩 Edge Cases

Bluetooth devices

• Almost always introduce delay
  → Avoid for best results

Audio interfaces

• May need buffer size adjustment
• Lower buffer = less delay

Older computers

• May struggle with real-time processing

🎯 If You’re Still Stuck

Include:

• Computer type (Windows/Mac)
• Audio device (wired, Bluetooth, interface)
• Keyboard model

👉 Contact support with this info