How to Configure TTS Engine: First-Time Setup & Troubleshooting FAQ

TTS Engine is built to give Windows users complete control over high-fidelity text-to-speech without locking core features behind paywalls. Because speech generation demands different capabilities depending on whether you are working online, offline, or producing commercial voiceovers, the application uses a smart multi-tier architecture.

Whether you are configuring the software for the first time or diagnosing unexpected voice behavior, this guide explains how the engine modes work, where settings live in Windows, and how to resolve common questions.

Step 1: Understanding the Three Voice Engines

TTS Engine operates across three synthesis modes automatically:

1. Free Cloud Neural Mode (Default):
   Out of the box, the app connects to high-quality cloud neural voices with zero configuration. No credit card, API key, or registration is required. You get access to natural voices in English, Spanish, French, German, Italian, and Portuguese.
2. Azure Speech Enhanced Mode (Optional):
   Entering an Azure Speech API key via the ⚙️ API menu unlocks advanced controls: millisecond-level pause sliders, SSML syntax parsing, and expressive emotional styles (cheerful, sad, whispering, newscast).
3. Offline Fallback Mode (SAPI5):
   If your PC loses internet access or cannot reach cloud servers, the app gracefully switches to your local Windows SAPI5 voice engine so your workflow never grinds to a halt.

Step 2: Customizing Themes, Display Zoom, and Shortcuts

You can tailor the interface to your display resolution and desktop workflow:

• Bilingual Interface (EN / ES): Click EN / ES in the top navigation bar to toggle between English and Spanish. All menus, labels, and modal dialogues switch instantly.
• Theme Auto-Detection: The application automatically reads your Windows personalization registry on launch. You can manually force Light or Dark mode from the THEME menu anytime.
• Display Zoom: Designed for both laptops and high-DPI monitors, you can scale the interface to 100% (Normal), 110%, or 130% via the ZOOM menu or keyboard shortcuts (Ctrl + +, Ctrl + -, and Ctrl + 0).

Step 3: Where Settings and Files Are Saved in Windows

TTS Engine keeps your file system clean by isolating runtime files:

• User Configuration File:
  Settings (last selected language, preferred voice ID, and saved API keys) are stored locally in your Windows user profile:
  %LOCALAPPDATA%\TTSEngine\tts_user_config.json
• Temporary Audio Previews:
  When you click Listen, audio is buffered to Windows temporary storage (%TEMP%) and cleared automatically when you close the application or generate new text.
• Exported MP3 Files:
  When clicking Save MP3, you choose your own save destination. TTS Engine never forces files into hidden app sandboxes.

Frequently Asked Questions & Troubleshooting (FAQ)

1. Why did the app switch to a robotic system voice?

• Cause: When an audio request cannot reach cloud endpoints, TTS Engine falls back to your local Windows SAPI5 offline engine. This happens if:
  • Your internet connection dropped momentarily.
  • An invalid or expired Azure API key/region was entered in the settings.
• Fix: Check your network connection. If you previously entered an Azure key and want to return to the free default engine, open ⚙️ API, delete both the Key and Region fields so they are completely blank, and click Accept.

2. Why did my settings and API key persist after reinstalling the app?

• Cause: Like most standard Windows desktop software, uninstalling removes the application binaries but deliberately preserves your user profile configuration inside %LOCALAPPDATA% to prevent accidental data loss.
• Fix: If you want a 100% clean reset, press Win + R, type %LOCALAPPDATA%\TTSEngine, press Enter, and delete the tts_user_config.json file.

3. Error: “The file already exists and is open or in use by another application…”

• Cause: Windows places an exclusive write lock on any media file currently open in an external media player, audio editor, or browser tab.
• Fix: Close the audio file in your external media player (or choose a different file name in the Save dialog) and click Save MP3 again.

4. How does the 2,000-character limit work?

• Design: The 2,000 character ceiling ensures instant synthesis response times and prevents cloud socket timeouts.
• Tip for long scripts: If you are narrating an article or eBook chapter, split your text into logical paragraphs and export them as separate numbered files (e.g., part-01.mp3, part-02.mp3) before assembling them in your audio editor.