Troubleshooting
The Browser Does Not Detect the Microphone
Symptoms
- Error message when clicking "Start recording"
- The modal stays stuck without starting the recording
- No reaction on click
Solutions by Browser
Chrome (Windows/Mac): 1. Look for the padlock icon 🔒 at the left of the address bar 2. Click it → "Microphone" → select "Allow" 3. Reload the page
Chrome (Android): 1. Chrome Settings → "Site settings" → "Microphone" → allow the site
Firefox: 1. The permission request reappears every session (normal Firefox behavior) 2. If blocked: Settings → Privacy & Security → Permissions → Microphone → Remove the block
Safari (Mac/iOS): 1. Safari Preferences → Websites → Microphone → allow the site
If none of these settings work: - Verify that your microphone is properly connected and detected by the system (test in Zoom or a system recorder) - Restart the browser - Try Chrome (recommended)
Audio Quality Is Insufficient
Volume Too Low
- Move closer to the microphone (ideal distance: 10–15 cm)
- Speak louder or more distinctly
- Check the microphone input level in system settings:
- Windows: Control Panel → Sound → Recording → Microphone Properties → Levels
- Mac: System Preferences → Sound → Input → Input volume
Significant Background Noise
- Close windows and doors
- Turn off fans and noisy appliances
- Change rooms if possible
- Record early in the morning or late at night (less outside noise)
Muffled Sound or Echo
- Muffled: check that the microphone is not covered or obstructed
- Echo: add absorbing elements in the room (cushions, curtains, rugs)
Clipping (Distorted Sound)
- Move slightly further from the microphone
- Lower the microphone input volume in system settings
- Speak more softly
The Recording Does Not Submit
Symptoms
- Loading animation spinning indefinitely
- Error message during submission
- The modal does not close after clicking "Submit"
Solutions
- Check your internet connection (switch to Wi-Fi if you are on mobile data)
- File size: if you uploaded a file, check that it does not exceed 50 MB
- Format: check that the format is accepted (MP3, WAV, WebM, OGG, M4A, FLAC)
- Try again: click "Submit" again — sometimes a temporary network issue resolves itself
- Restart the recording: close and reopen the modal, redo the recording
The Interface Is Slow or Unresponsive
Solutions
- Close other browser tabs (frees up RAM)
- Close other applications on your device
- Restart the browser
- Restart the device
- Clear the browser cache (you will need to log in again)
I Cannot Find an Item
The interface has no text search bar. To find an item:
- If you are looking for what remains: filter on "To do"
- If you are looking for what is done: filter on "Done"
- Items are grouped by card — scroll to the desired card number
I Re-Recorded but the Old Audio Is Still Being Served
Cause
There may be a cache delay: - Browser cache: your browser has cached the old audio - CDN cache: the audio CDN (MinIO) may be serving a cached version
Solution
- Clear your browser cache on the application page
- Reload the page (Ctrl+Shift+R / Cmd+Shift+R)
- If the audio served to users is still the old one, wait a few minutes — the CDN cache expires automatically
ℹ️ End users who had already downloaded the audio offline will receive the update at their next internet connection.
My Access Code No Longer Works
Possible causes: - The administrator has changed your code (may happen during a security reset) - Your account has been deactivated
→ Contact the project administrator to get a new code or reactivate your account.
I Lose My Connection During Submission
If the connection is lost during upload: - The recording is not saved on the server - The item remains with "To do" status - Reconnect to the internet and redo the recording for that item