Troubleshooting Common Issues

Having trouble with Polyglotton? Here are solutions to the most common problems.

Lesson Import Issues

“Import Failed” Error

Possible causes:

• Lesson JSON is malformed
• Browser compatibility issue
• Insufficient storage space

Solutions:

1. Validate your JSON using a JSON validator
2. Try a different browser (Chrome, Firefox, Safari, Edge)
3. Clear old lessons to free up space
4. Check browser console (F12) for specific error messages

Lessons Won’t Import from Library

Solutions:

1. Check your internet connection
2. Disable browser extensions (ad blockers might interfere)
3. Clear browser cache and try again
4. Try the direct download link instead of one-click import

Imported Lesson Has No Audio

Audio playback requires:

• Modern browser with Web Speech API support
• Internet connection for text-to-speech
• Microphone permissions (for some features)

App Performance Issues

App is Slow or Laggy

Common causes:

• Too many lessons stored
• Browser running low on memory
• Old browser version

Solutions:

1. Export and archive old lessons you don’t need
2. Close unnecessary browser tabs
3. Update your browser to the latest version
4. Try using the app in a private/incognito window

App Won’t Load

Check:

1. Internet connection is working
2. Try a different browser
3. Clear browser cache and cookies
4. Disable browser extensions temporarily
5. Check if JavaScript is enabled

Data & Progress Issues

My Progress Disappeared

Possible reasons:

• Browser data was cleared
• Using a different browser/device
• Private browsing mode (doesn’t save data)

Prevention:

• Regularly export your lessons as backup
• Don’t use private/incognito mode for learning
• Be careful when clearing browser data

Recovery: If you exported lessons previously, re-import them. Unfortunately, if no backup exists, progress cannot be recovered (this is the tradeoff for privacy-first design).

Lessons Won’t Save

Check:

1. Browser allows local storage (Settings → Privacy)
2. You’re not in private/incognito mode
3. You have enough disk space
4. Browser isn’t blocking site data

Progress Not Syncing Between Devices

Important: Polyglotton does not sync between devices. This is by design for privacy.

Workaround:

1. Export lessons from Device A
2. Transfer JSON files to Device B (email, USB, cloud storage)
3. Import on Device B

AI Generation Issues

“Invalid API Key” Error

1. Verify you copied the entire key (no spaces)
2. Check key is active on provider’s dashboard
3. Ensure billing is set up with your AI provider
4. Try generating a new key

“Rate Limit Exceeded”

Your AI provider limits requests per minute/hour.

Solutions:

• Wait 5-10 minutes and try again
• Upgrade your AI provider account
• Generate fewer lessons at once

Generated Lessons Have Errors

AI can make mistakes. Always review generated content.

If content is consistently poor:

• Use more specific prompts
• Try a more advanced model (GPT-4 vs GPT-3.5)
• Manually edit and improve the lesson

Browser Compatibility

Supported Browsers

✅ Fully Supported:

• Chrome/Edge 90+
• Firefox 88+
• Safari 14+

⚠️ Limited Support:

• Older browser versions (may lack features)
• Mobile browsers (fully functional, but smaller screen)

❌ Not Supported:

• Internet Explorer (discontinued)
• Very old browsers (before 2020)

Audio Issues

Text-to-Speech Not Working

Requirements:

• Modern browser with Web Speech API
• Internet connection
• Target language supported by browser TTS

Solutions:

1. Test in Chrome (best TTS support)
2. Check system audio isn’t muted
3. Try a different target language
4. Update your browser

No Microphone Access (for speech input)

1. Check browser permissions (usually a padlock icon in URL bar)
2. Allow microphone access for the site
3. Try a different browser
4. Check system microphone settings

Privacy & Security

How to Clear All Data

Chrome/Edge:

1. Settings → Privacy and Security → Site Settings
2. View permissions and data → polyglotton.com
3. Clear data

Firefox:

1. Options → Privacy & Security → Cookies and Site Data
2. Manage Data → Search for polyglotton.com
3. Remove

Safari:

1. Preferences → Privacy → Manage Website Data
2. Search for polyglotton.com
3. Remove

Ad Blocker Interference

Some ad blockers may interfere with app functionality.

Solutions:

• Whitelist polyglotton.com
• Temporarily disable the blocker
• Try a different browser

Still Having Issues?

Check Browser Console

1. Press F12 (or Cmd+Option+I on Mac)
2. Go to “Console” tab
3. Look for error messages (red text)
4. Screenshot and report if needed

More Help

• How to Use the App
• Browse all FAQs