Skip to main content

​
Troubleshooting Guide

This comprehensive troubleshooting guide helps you resolve common issues with VozCraft. If you encounter problems with audio generation, playback, export, or any other feature, this guide provides solutions.

​
Audio Generation Issues

​
No Audio Plays

Symptom: Click “Generate Audio” but hear nothing
Try these immediate solutions:
1

Check System Volume

  • Verify system volume is not muted
  • Increase volume to at least 50%
  • Check if other websites/apps play audio
  • Test with a YouTube video
2

Check Browser Permissions

  • Browser may be blocking audio
  • Look for speaker icon in address bar
  • Click icon and allow audio
  • Refresh page and try again
3

Verify Text Entered

  • Ensure text area is not empty
  • Must have at least 1 character
  • Try simple test: “Hello world”
  • Check character counter shows > 0
Important: If no audio plays anywhere on your system (not just VozCraft), the issue is with your system audio configuration, not VozCraft.

​
Audio Sounds Robotic or Unnatural

Symptom: Audio plays but sounds artificial, choppy, or robotic
Try These Settings:
  1. Use Neutral Mood:
    • Extreme moods can sound unnatural
    • Neutral provides most natural results
    • Avoid Enthusiastic or Melancholic unless needed
  2. Use Normal Speed:
    • Very Fast (1.60x) often sounds unnatural
    • Normal (1.00x) is most natural
    • Slow (0.75x) also natural but slower
  3. Use Normal Voice Type:
    • High-pitched can sound artificial
    • Normal voice often more natural
    • Especially for serious content
  4. Try Different Language Variant:
    • English (US) often best quality
    • Try UK or AU if US sounds off
    • Some accents better supported than others
Optimal Natural Settings:
  • Voice: Normal
  • Speed: Normal
  • Mood: Neutral
  • Language: English (US) or Español (México)
Improve with Better Text:Add Proper Punctuation:
Good: "Hello! Welcome to our service. How can I help you?"
Bad:  "hello welcome to our service how can i help you"
Break Long Sentences:
Good: "We offer many services. These include consulting, 
       training, and support."
Bad:  "We offer many services including consulting training 
       and support all of which are customized to your needs."
Spell Out Abbreviations:
Good: "The United States Department of Defense"
Bad:  "The US DoD"
Write Numbers as Words (for better pronunciation):
Good: "The price is twenty dollars."
Bad:  "The price is $20."
Improve System Voices:Windows:
  1. Settings > Time & Language > Speech
  2. Download additional voices
  3. Select “Microsoft [Name] Online” voices (higher quality)
  4. Windows 11 has better neural voices than Windows 10
macOS:
  1. System Preferences > Accessibility > Spoken Content
  2. Click “System Voice” dropdown
  3. Download “Enhanced” or “Premium” voices (larger size, better quality)
  4. macOS 13+ has significantly improved voices
Android:
  1. Settings > System > Languages & input > Text-to-speech
  2. Tap settings icon next to Google TTS
  3. Install voice data for your languages
  4. Use “High quality” option if available
Best Practice: Keep OS updated for latest TTS improvements

​
Wrong Language or Accent

Symptom: Selected Spanish but getting English voice, or wrong accent
Cause: Your system doesn’t have a voice for that languageSolutions:
  1. Install Language Pack:
    • Windows: Settings > Time & Language > Language > Add a language
    • macOS: System Preferences > Accessibility > Spoken Content > System Voice > Manage Voices
    • Linux: Install appropriate TTS packages for your distro
  2. Try Related Variant:
    • If Español (México) doesn’t work, try Español (España)
    • If English (UK) fails, try English (US)
    • If Português (Brasil) unavailable, try Português (Portugal)
  3. Use Better-Supported Language:
    • English (US) has best support across platforms
    • Spanish (Mexico/Spain) well-supported
    • French, German, Italian generally available
  4. Try Different Browser:
    • Chrome/Edge often have best voice support
    • Safari excellent on macOS/iOS
    • Firefox has limited support
Symptom: Keep getting wrong accent despite selectionPossible Causes:
  1. System only has one voice for that language
  2. Browser defaulting to system default
  3. Voice not properly installed
Diagnosis:
  1. Open browser console (F12)
  2. Type: speechSynthesis.getVoices()
  3. Press Enter
  4. Look for your language in the list
  5. Check which voices are actually available
If Voice Missing:
  • Install language pack on your OS
  • Restart browser after installation
  • Verify voice appears in console
  • Try generating audio again

​
Playback Issues

​
Audio Starts Then Stops

Symptom: Audio begins playing but cuts off abruptly
Common Causes:
  1. Tab Backgrounded:
    • Some browsers pause audio in background tabs
    • Keep VozCraft tab active during playback
    • Especially affects mobile browsers
  2. Power Saving Mode:
    • Mobile devices may throttle background tabs
    • Disable battery saver during use
    • Keep device charging if possible
  3. Memory Issues:
    • Long audio with limited RAM
    • Close other tabs
    • Restart browser
    • Try shorter text segments
Solutions:
  • Keep VozCraft tab in foreground
  • Close unnecessary browser tabs
  • Disable browser extensions temporarily
  • Try different browser

​
Playback Speed Issues

Symptom: Audio plays too fast, too slow, or speed varies
Causes:
  • Speed setting is Fast or Very Fast
  • Mood adds rate multiplier (Energetic 1.30x, Enthusiastic 1.25x)
  • Combined effects multiply
Example of Extreme Speed:
Speed: Very Fast (1.60)
Voice: High-pitched (+0.05)
Mood: Energetic (1.30x)

Final Rate = (1.60 + 0.05) * 1.30 = 2.145x
Solutions:
  1. Change Speed to Normal or Slow
  2. Use Neutral mood (1.00x rate multiplier)
  3. Use Normal voice type (avoids +0.05)
  4. Test with conservative settings first
Causes:
  • Speed set to Slow or Very Slow
  • Mood reduces speed (Melancholic 0.78x, Relaxed 0.82x, Serious 0.88x)
  • Normal voice type subtracts 0.05
Example of Very Slow:
Speed: Very Slow (0.50)
Voice: Normal (-0.05)
Mood: Melancholic (0.78x)

Final Rate = (0.50 - 0.05) * 0.78 = 0.351x
Solutions:
  1. Increase Speed to Normal or Fast
  2. Use Neutral mood
  3. Try High-pitched voice (+0.05 instead of -0.05)
Symptom: Speed varies during playbackCauses:
  1. Browser performance throttling
  2. System resource constraints
  3. Tab backgrounded on mobile
Solutions:
  1. Keep tab in foreground
  2. Close other applications
  3. Use desktop instead of mobile
  4. Export as MP3/WAV (consistent speed)
  5. Try different browser

​
Export Issues

​
Download Doesn’t Start

Symptom: Click MP3/WAV/TXT button but nothing downloads
1

Check Browser Downloads

Allow Downloads:
  • Chrome: chrome://settings/content/pdfDocuments
  • Check “Download PDF files” is ON
  • Also check chrome://settings/downloads
  • Verify download location exists
Check Download Bar:
  • May be downloading silently
  • Look at bottom of browser window
  • Click “Show all downloads” (Ctrl+J)
  • Check Downloads folder directly
2

Disable Pop-up Blocker

  • Click icon in address bar
  • Allow pop-ups for VozCraft
  • Some blockers prevent downloads
  • Try disabling temporarily
3

Check Disk Space

  • Need 10-50 MB free space
  • Check drive where Downloads folder is located
  • Clear space if needed
  • Try different download location
4

Try Different Browser

  • Chrome or Edge recommended
  • Some browsers have stricter download policies
  • Verify works in different browser

​
Exported Audio is Silent

Symptom: Downloaded MP3/WAV plays but no sound
Check Mood Volume:Different moods have different volumes:
  • Melancholic: 88% (quietest)
  • Relaxed: 90%
  • Serious: 95%
  • Tense: 95%
  • All others: 100%
Solution:
  1. Use Neutral mood (100% volume)
  2. Test playback in history BEFORE exporting
  3. If history plays fine, export should too
  4. Increase system volume when playing export
File May Be Corrupted:Check File Size:
  • Valid MP3/WAV: At least 100KB
  • Empty file: 0KB or very small
  • If too small, regeneration failed
Solutions:
  1. Play audio in history first (verify it works)
  2. Delete failed download
  3. Click export button again
  4. Try different format (WAV instead of MP3)
  5. Try different browser
  6. Shorten text and try again
Some Players May Not Support Format:Try Different Player:
  • VLC Media Player (plays everything)
  • Windows Media Player
  • QuickTime (macOS)
  • Default system player
Test on Computer First:
  • Before trying on phone/tablet
  • Verify file plays correctly
  • Then transfer to mobile if needed
Convert if Needed:
  • Use Audacity to convert
  • Try MP3 if WAV doesn’t work
  • Try WAV if MP3 doesn’t work

​
File Won’t Open or Import

Symptom: Audio editor or player says file is invalid
Audacity Import Issues:
  1. Update Audacity:
    • Download latest version
    • Older versions may not recognize format
  2. Use File > Import > Audio:
    • Don’t drag and drop
    • Use menu import
    • Try both MP3 and WAV
  3. Install FFmpeg (for Audacity MP3):
    • Audacity may need FFmpeg library
    • Download from audacityteam.org
    • Install and restart Audacity
Other Editor Issues:
  • Export as WAV (more compatible)
  • Check editor supports 22,050 Hz sample rate
  • Try converting with VLC first
  • Verify file isn’t corrupted (check size)
“Cannot Play File” Error:
  1. Try VLC Media Player:
    • Free, plays almost everything
    • Download from videolan.org
    • Most reliable option
  2. Check File Extension:
    • Should be .mp3 or .wav
    • Browser may have added extra extension
    • Rename if needed: file.mp3.txt → file.mp3
  3. Check File Size:
    • Should be at least 100KB
    • If smaller, file is corrupted
    • Re-export from VozCraft
  4. Mobile Device Issues:
    • Some phones don’t support WAV
    • Use MP3 for mobile devices
    • Transfer to computer to convert if needed

​
History and Storage Issues

​
History Disappeared

Symptom: History panel empty after page refresh
Most Common Cause:History stored in browser localStorage:
  • Clearing browser data deletes history
  • Incognito mode doesn’t persist
  • Different browser = different storage
Prevention:
  1. Export History JSON Regularly:
    • Click ”💾 Save” button
    • Save vozcraft-historial.json
    • Do this after each session
  2. Don’t Clear Browser Data:
    • Or exclude “Cookies and site data”
    • Or export before clearing
  3. Avoid Incognito Mode:
    • Data deleted when window closes
    • Use normal browsing for persistence
Storage is Per-Browser:
  • Chrome history ≠ Firefox history
  • Browser profiles have separate storage
  • Incognito ≠ normal browsing
Solutions:
  1. Use Same Browser:
    • Return to original browser
    • Check if history is there
  2. Import Backup:
    • If you exported history JSON
    • Click ”📂 Load” button
    • Select your backup file
    • History restored
  3. Export for Cross-Browser:
    • Export from Browser A
    • Import to Browser B
    • Manual transfer method
Symptom: History stops savingCause: localStorage has 5-10MB limitSolutions:
  1. Clear Old History:
    • Click “Clear all” button
    • Removes all history
    • Frees storage space
  2. Export Before Clearing:
    • Save JSON backup first
    • Then clear history
    • Can import later if needed
  3. Reduce History Size:
    • Delete old unused items
    • Use shorter text (less storage)
    • Export and clear regularly

​
Cannot Import History

Symptom: Click “Load” and select file but nothing happens
Error: “Error al leer el archivo”Causes:
  1. File is not valid JSON
  2. File is corrupted
  3. Wrong file selected
  4. File wasn’t exported from VozCraft
Solutions:
  1. Verify File:
    • Open in text editor
    • Should start with [ and end with ]
    • Should look like:
    [
  {
    "id": "1705349100000",
    "timestamp": 1705349100000,
    ...
  }
]
  2. Validate JSON:
    • Use jsonlint.com
    • Paste file contents
    • Check for errors
    • Fix if possible
  3. Re-export from Source:
    • If file is corrupted
    • Export fresh copy from original browser
    • Try importing again
Make Sure:
  1. File is .json Extension:
    • Not .txt or .json.txt
    • Some systems hide extensions
    • Check file properties
  2. Select Correct File:
    • Named vozcraft-historial.json
    • Or custom name you gave it
    • From VozCraft export
  3. File Readable:
    • Not corrupted
    • Not empty (0 bytes)
    • Can open in text editor

​
Performance Issues

​
Slow Generation

Symptom: Takes long time to start playing audio
Expected Delays:
  • Short text (100 chars): Instant (< 1 second)
  • Medium text (500 chars): 1-2 seconds
  • Long text (2000 chars): 2-3 seconds
  • Maximum text (5000 chars): 3-5 seconds
If delays are longer, continue troubleshooting.

​
Interface Lag or Freezing

Symptom: VozCraft interface is slow or unresponsive
30 Items Maximum:History panel can slow down with many items:
  1. Export History:
    • Click ”💾 Save” to backup
    • Saves all items to JSON
  2. Clear History:
    • Click “Clear all”
    • Removes all items
    • Speeds up interface
  3. Import Selected Items:
    • Edit JSON file (keep only needed items)
    • Import edited file
    • Only load what you need
Standard Performance Fixes:
  1. Restart Browser: Memory leak cleanup
  2. Close Other Tabs: Reduce memory usage
  3. Disable Extensions: Test in Incognito
  4. Clear Cache: Remove old data
  5. Update Browser: Get performance improvements
  6. Try Different Browser: Compare performance

​
Browser Compatibility

✅ Fully Supported

Best Experience:
  • Google Chrome (80+)
  • Microsoft Edge (80+)
  • Safari (14+)
  • Opera (67+)
Why:
  • Full Web Speech API support
  • Good voice selection
  • Reliable performance
  • Regular updates

⚠️ Partial Support

Limited Experience:
  • Firefox (any version)
  • Older Safari (< 14)
  • Mobile browsers (varies)
Limitations:
  • Limited voice options
  • Variable quality
  • May miss some features
  • Use supported browser if possible

​
Platform-Specific Issues

Common Issues:
  1. Voices Sound Robotic:
    • Windows 10 voices lower quality
    • Upgrade to Windows 11 for neural voices
    • Or download better voices from Microsoft Store
  2. Limited Language Support:
    • Install language packs
    • Settings > Time & Language > Language
    • Add languages you need
  3. Performance Issues:
    • Update audio drivers
    • Close background apps
    • 8GB+ RAM recommended

​
Getting Additional Help

​
Before Requesting Support

1

Gather Information

Collect these details:
  • Browser: Name and version (Help > About)
  • OS: Windows/macOS/Linux/iOS/Android and version
  • Issue: Exact description of problem
  • Steps: What you did before issue occurred
  • Error Messages: Any red text or error dialogs
  • Console Errors: Press F12, check Console tab
2

Test in Different Browser

  • Does issue occur in Chrome?
  • Does it occur in Safari?
  • This helps identify if browser-specific
3

Test with Simple Input

  • Try: “Hello world test”
  • Use: Normal + Normal + Neutral
  • Language: English (US)
  • If simple works, issue is with your specific settings/text
4

Check This Guide

  • Review relevant troubleshooting sections
  • Try all suggested solutions
  • Note what you’ve already tried

​
Common Questions

Yes, completely free:
  • No registration required
  • No usage limits
  • No hidden fees
  • All features available
  • No premium tier
VozCraft is free to use forever.
No account needed:
  • No registration
  • No login
  • No email required
  • No tracking
  • Completely anonymous
Just open the website and start using it.
Local storage only:
  • History: Browser localStorage
  • Nothing sent to servers
  • Text never leaves your device
  • Audio generated locally
  • Completely private
Your data never leaves your computer.
Yes, after initial load:
  • First visit requires internet (to load page)
  • After loaded, works offline
  • Uses browser’s built-in TTS
  • No server connection needed
Note: Some browsers may fetch voices from cloud.
System-dependent:
  • VozCraft uses your device’s TTS voices
  • Windows has different voices than macOS
  • Mobile devices have different voices
  • Voice quality varies by OS
Best quality:
  • macOS/iOS (Apple voices)
  • Windows 11 (neural voices)
  • Android with Google TTS
Yes, for most uses:
  • Content creation: Yes
  • Business presentations: Yes
  • Marketing materials: Yes
  • Products: Check voice licensing
Important: System TTS voices have their own licenses. Check your OS voice licensing for commercial use restrictions.
5,000 characters per generation:
  • Character counter shows remaining
  • Turns red above 4,500
  • For longer content:
    • Split into segments
    • Generate separately
    • Merge in audio editor
See Using VozCraft Guide for long-form workflows.
Pitch controlled by settings:
  • Voice Type: 0.75 (Normal) or 1.30 (High-pitched)
  • Mood: Additional pitch adjustment (0.70 to 1.35)
  • Combined: Voice Type * Mood
No manual pitch slider, but extensive control through combinations.

​
Still Having Issues?

If you’ve tried everything in this guide and still experiencing problems:

Report Bug

If you believe you’ve found a bug:Visit the GitHub repository to report issues: github.com/MateoRiosdevInclude:
  • Detailed description
  • Steps to reproduce
  • Browser and OS info
  • Console errors (F12)

Try Alternative

If VozCraft doesn’t meet your needs:Consider:
  • Google Cloud TTS: Commercial API
  • Amazon Polly: AWS service
  • Microsoft Azure TTS: Enterprise solution
  • ElevenLabs: AI voices (paid)
VozCraft is free but uses browser TTS, which has limitations.
Remember: Most issues are resolved by using default settings (Normal voice, Normal speed, Neutral mood) with Chrome or Edge browsers on updated systems.

Build docs developers (and LLMs) love

Get started for freeTalk to us