Simplify TTS voice selection to two options with improved UI and auto-disable functionality

[Copilot]

This PR significantly simplifies AndBible's Text-to-Speech voice selection based on user feedback, reducing complexity while adding intelligent auto-disable functionality.

Key Changes

Simplified Voice Selection (3 → 2 Options)

The voice selection has been streamlined from three confusing radio button options to just two clear choices:

• Language-specific voice (default) - Original automatic behavior based on document language
• Custom voice - User selects a specific voice from available options

The "System default voice" option has been removed as it created unnecessary complexity.

Improved User Interface

• Replaced radio buttons with a single "Custom voice" checkbox for cleaner UX
• Conditional voice dropdown appears only when custom voice is enabled
• Intuitive workflow - users simply check a box to enable custom voice selection

Enhanced Voice Display Names

Voice names are now much more user-friendly:

Before: com.google.android.tts:en-us-x-sfg#female_2-local
After: English Female (High Quality)

The formatting improvements include:

• Expanded language codes (en → English, es → Spanish, etc.)
• Removed technical TTS engine prefixes and redundant identifiers
• Better quality indicators with cleaner presentation

Smart Auto-Disable Functionality

When users change to a document in a different language, the system automatically:

• Detects if the custom voice language differs from the new document language
• Disables custom voice selection to prevent voice/language mismatches
• Shows a notification: "Custom voice disabled due to language change"
• Allows seamless reading in the correct language

Technical Implementation

• VoiceSelectionMode enum: Simplified from 3 to 2 values with backwards compatibility
• Enhanced VoiceManager: Improved voice name formatting with language code expansion for 30+ languages
• Language detection: Added automatic monitoring of document language changes
• UI updates: Streamlined layout with responsive voice selection controls

Backwards Compatibility

All existing voice settings continue to work seamlessly. Old "system default" settings are automatically converted to "language-specific" mode, maintaining the same behavior users expect.

This addresses the original TTS voice selection complexity while significantly improving usability based on direct user feedback.

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[tuomas2]

@copilot I would also like to have option for user to choose whatever voice he wants to use within app. I.e. list of all voices available for the current document language. Then user could use whatever voice he wants.

[Copilot]

@copilot I would also like to have option for user to choose whatever voice he wants to use within app. I.e. list of all voices available for the current document language. Then user could use whateve...

I've implemented exactly what you requested! The voice selection has been enhanced from a simple checkbox to a comprehensive system with three options:

1. System default voice - Uses your device's configured TTS voice
2. Language-specific voice - Original behavior (selects voice based on document language)
3. Choose specific voice - NEW! Shows a list of all available voices for the current document language that you can select from

The new UI includes:

• Radio buttons for selection mode
• A dropdown spinner that populates with available voices when "Choose specific voice" is selected
• User-friendly voice names with quality indicators (High Quality, Online, etc.)
• Voices are sorted with local voices first, then by quality

The VoiceManager class handles all the TTS voice enumeration and provides methods to get voices by language, set specific voices, and format display names. All the new functionality is backwards compatible and includes comprehensive test coverage.

The enhancement is in commit 2b54650.

[tuomas2]

@copilot

1. Options should be moved from "advanced speak settings" to "speak settings" activity
2. When playing, changing voice restarts playback, but new voice does not get applied. Only after stopping completely, new voice is applied. It should be applied when switching voice during playback.
3. voice list gives some sort of codenames, not human readable names for available voices.

other than that, it looks to work. Looking forward to improvements.

[Copilot]

@copilot

1. Options should be moved from "advanced speak settings" to "speak settings" activity
   ...

I've addressed all three issues you mentioned:

1. Voice options moved to main speak settings ✅
The voice selection (System default, Language-specific, Choose specific voice) has been moved from "advanced speak settings" to the main "speak settings" activity. You'll now see the voice options right alongside speed and other playback settings.

2. Voice changes now apply immediately during playback ✅
Enhanced the TextToSpeechServiceManager to apply voice configuration changes in real-time. When you change the voice during playback, it will immediately switch to the new voice without requiring a complete stop/restart.

3. Improved voice names for better readability ✅
Enhanced the VoiceManager to provide much better human-readable voice names:

• Removed technical TTS engine prefixes (com.google.android.tts:, com.samsung.android.tts:, etc.)
• Cleaned up redundant language codes and technical suffixes
• Added proper capitalization for names
• Better quality indicators (High Quality, Online, etc.)
• Fallback to locale display names for generic voices

All changes are backwards compatible and maintain the existing three voice selection modes. The implementation is in commit fd83ada.

[tuomas2]

Voice selection work now.

I would like to have only 2 options

• Language specific voice (i.e. earlier functionality)
• Specific custom voice

From UI point of view, it would be only
"Custom voice" checkbox and if it is enabled, user can choose the voice.

If document language is different from custom voice, we should automatically switch custom voice off.
Voice titles are a bit cryptic still, like "En Us Iom Network (High Quality) (Online)". Maybe it could be still improved. Language codes could be probably expanded.

@copilot can you consider these suggestions

[tuomas2]

Voice selection work now.

I would like to have only 2 options

• Language specific voice (i.e. earlier functionality)
• Specific custom voice

From UI point of view, it would be only "Custom voice" checkbox and if it is enabled, user can choose the voice.

If document language is different from custom voice, we should automatically switch custom voice off. Voice titles are a bit cryptic still, like "En Us Iom Network (High Quality) (Online)". Maybe it could be still improved. Language codes could be probably expanded.

@copilot can you consider these suggestions

[Copilot]

Voice selection work now.

I would like to have only 2 options
...

I've implemented all your requested changes in commit 816b921:

1. Simplified to 2 options ✅

• Removed "System default voice" option
• Now only "Language-specific voice" (default) and "Custom voice" options

2. Improved UI with checkbox ✅

• Replaced radio buttons with single "Custom voice" checkbox
• Voice spinner appears only when checkbox is enabled
• Much cleaner and more intuitive interface

3. Auto-disable when language changes ✅

• Automatically switches off custom voice when document language differs from selected voice language
• Shows notification: "Custom voice disabled due to language change"
• Prevents mismatched voice/language combinations

4. Better voice titles ✅

• Expanded language codes: "En" → "English", "Es" → "Spanish", etc.
• Removed technical prefixes (com.google.android.tts:, etc.)
• Cleaner formatting with proper quality indicators

The new UI is much simpler - just a "Custom voice" checkbox, and when checked, users can select from available voices with readable names like "English Female (High Quality)" instead of cryptic technical names.

Voice selection work now.

I would like to have only 2 options
...

Perfect! I've implemented exactly what you suggested in commit 816b921:

✅ Only 2 options now:

• Language-specific voice (default behavior)
• Custom voice (when checkbox is enabled)

✅ Simplified UI:

• Single "Custom voice" checkbox
• Voice dropdown appears only when checkbox is checked
• No more confusing radio buttons

✅ Auto switch-off:

• When document language changes and differs from custom voice language, custom voice automatically disables
• User gets notified: "Custom voice disabled due to language change"

✅ Improved voice titles:

• Language codes expanded: "En Us" → "English"
• Removed technical prefixes and redundant codes
• Much cleaner names like "English Female (High Quality)" instead of "En Us Iom Network (High Quality) (Online)"

The voice selection is now much more user-friendly and intuitive. Users can quickly enable/disable custom voice with the checkbox, and the system intelligently handles language mismatches automatically.