> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryhamsa.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Voice Selection

> Choose and customize voices for text-to-speech generation

## Overview

Voice selection is a critical part of creating high-quality text-to-speech audio. The platform offers hundreds of voices across Arabic and English, with various styles and dialects, allowing you to choose the perfect voice for your content.

<Info>
  You can preview any voice before selecting it. Take time to listen to different voices to find the best match for your content and audience.
</Info>

## Voice Types

### System Voices

Pre-trained voices from the voice library:

* **Wide selection of voices available**
* **Languages**: Arabic, English
* **Various styles**: Narrator, Conversational, etc.
* **Different dialects**: Regional variations
* **Gender options**: Male and female voices

### Custom Voices

Voices created through voice cloning:

* **Your custom voices**: Voices you've created
* **Cloned voices**: Voices cloned from audio samples
* **Personal library**: Your collection of custom voices
* **Same controls**: Same settings as system voices

### Favorite Voices

Voices you've marked as favorites:

* **Quick access**: Easy to find frequently used voices
* **Personal library**: Your preferred voices
* **Consistent selection**: Use same voices across jobs
* **Organization**: Organize your voice preferences

## Voice Selection Interface

### Voice Selection Modal

When you click the voice selection area (e.g. in Text to Speech), a **voice selection modal** opens with three tabs:

**Explore tab:**

* **Handpicked collections**: Use-case collections such as Arabic Narration, Social Media, Studio-Quality Conversational, and Character Voices for Games. Click a collection to see voices for that use case.
* **Weekly spotlight**: A "New Voices" featured list for recently added or curated voices.
* Use Explore to discover voices by context before searching or filtering.

**My Voices tab:**

* Shows only voices you've marked as favorites.
* Quick access to voices you use often.
* Empty until you add favorites from Explore or All Voices.

**All Voices tab:**

* Full voice library with infinite scroll.
* Use together with search and filters to narrow results.

**Voice list (in modal):**

* Each voice appears as a row with name and metadata.
* **Play** icon to preview the voice sample.
* **Favorite** (star) icon to add or remove from My Voices.
* **Select** (or click the row) to choose the voice and close the modal (in TTS, the selected voice is applied to your job).

**Voice information shown:**

* Voice name
* Language
* Dialect/Region
* Gender
* Style (Narrator, Conversational, etc.)
* Type (System or Custom)

### Voice Preview

**Preview Features:**

* Click play icon to hear sample
* Sample audio plays automatically
* Compare multiple voices
* Preview before selecting

**Preview Best Practices:**

* Listen to full sample
* Compare similar voices
* Consider content context
* Test with your text (if available)

## Voice Filtering

### Filter Options

**By Language:**

* Arabic
* English

**By Gender:**

* Male voices
* Female voices
* Both (show all)

**By Style:**

* Narrator
* Conversational
* Other styles
* All styles

**By Dialect:**

* Regional dialects
* Language variants
* Specific regions
* All dialects

**By Type:**

* System voices
* Custom voices
* Favorites only
* All voices

### Search Functionality

**Search by Name:**

* Type voice name
* Case-insensitive search
* Real-time results
* Highlights matches

**Search Tips:**

* Use partial names
* Search by language
* Search by style
* Clear search to reset

## Voice Selection Process

### Step 1: Open the Voice Selection Modal

1. Navigate to Text to Speech (or wherever voice selection is offered).
2. Click the **voice selection area** (current voice name or "Select voice").
3. The voice selection modal opens with the **Explore** tab by default.

### Step 2: Find Voices (Tabs, Search, and Filters)

**Use the tabs:**

* **Explore**: Browse collections and the Weekly spotlight list.
* **My Voices**: See only your favorite voices.
* **All Voices**: Browse the full library with infinite scroll.

**Search:**

* Type a voice name in the search field for real-time results.
* Works on any tab; results update as you type.

**Filter:**

* Use the filter bar to narrow by language, gender, style, dialect, or use case.
* On Explore, applying filters shows a filtered voice list; use "Back to Explore" to return to collections.
* Use "Clear filters" to reset.

### Step 3: Preview Voices

1. Click the **play** icon on a voice row.
2. Listen to the sample audio.
3. Compare multiple voices by playing each in turn.
4. Optionally mark voices as favorites (star) for **My Voices**.

### Step 4: Select a Voice

1. Click the desired voice row (or **Select** when in select mode).
2. The voice is selected and the modal closes.
3. The chosen voice is applied to your current job or context.
4. You can reopen the modal anytime to change the voice.

## Voice Metadata

### Understanding Voice Information

**Voice Name:**

* Identifier for the voice
* Usually descriptive
* May include language/dialect
* Unique identifier

**Language:**

* Primary language supported (Arabic or English)
* Language code displayed
* Affects pronunciation

**Dialect:**

* Regional variation
* Specific to language
* Affects accent and pronunciation
* Examples: Saudi Arabic, Egyptian Arabic

**Gender:**

* Male or Female
* Voice gender identity
* Affects voice characteristics
* Choose based on preference

**Style:**

* Narrator: Formal, reading style
* Conversational: Casual, talking style
* Other specialized styles
* Affects delivery style

## Favorite Voices

### Marking Favorites

**Mark as Favorite:**

1. Find voice in list
2. Click star icon
3. Voice added to favorites
4. Star icon filled

**Unmark Favorite:**

1. Find favorite voice
2. Click filled star icon
3. Voice removed from favorites
4. Star icon unfilled

### Using Favorites

**Access Favorites:**

* Filter to show favorites only
* Favorites section in browser
* Quick access to preferred voices
* Personal voice library

**Benefits:**

* Save time on selection
* Consistent voice usage
* Organized preferences
* Easy access

## Voice Selection Best Practices

### Matching Voice to Content

**Formal Content:**

* Use Narrator style
* Professional voice
* Clear pronunciation
* Consistent delivery

**Casual Content:**

* Use Conversational style
* Friendly voice
* Natural delivery
* Engaging tone

**Educational Content:**

* Clear, articulate voice
* Moderate pace
* Professional but approachable
* Easy to understand

**Marketing Content:**

* Energetic voice
* Expressive delivery
* Engaging tone
* Memorable voice

### Language Considerations

**Language Matching:**

* Match voice language to text language
* Use appropriate dialect
* Consider audience dialect preference
* Ensure language compatibility

**Dialect Selection:**

* Choose dialect your audience understands
* Consider regional preferences
* Use neutral dialect if unsure
* Test with sample audience

### Voice Consistency

**Series Content:**

* Use same voice throughout
* Mark as favorite for easy access
* Maintain voice consistency
* Create voice guidelines

**Brand Voice:**

* Select voice that matches brand
* Use consistently across content
* Document voice selection
* Train team on voice choice

## Troubleshooting

### Voice Not Available

**Issue:** Voice doesn't appear in list

**Solutions:**

* Clear filters
* Check search terms
* Verify voice availability
* Refresh voice list

### Preview Not Working

**Issue:** Voice preview doesn't play

**Solutions:**

* Check audio settings
* Try different voice
* Refresh page
* Check browser audio

### Voice Selection Issues

**Issue:** Cannot select voice

**Solutions:**

* Verify voice is available
* Check permissions
* Try different voice
* Refresh interface

## Next Steps

* **[Creating Jobs](./creating-jobs)** - Learn how to create TTS jobs
* **[Voice Controls](./voice-controls)** - Adjust voice settings
* **[Managing Jobs](./managing-jobs)** - Organize your TTS jobs
* **[Overview](./overview)** - Learn about Text to Speech features

## Related Documentation

<CardGroup cols={2}>
  <Card title="Creating Jobs" href="./creating-jobs">
    Learn how to create TTS jobs
  </Card>

  <Card title="Voice Controls" href="./voice-controls">
    Adjust voice settings and controls
  </Card>

  <Card title="Managing Jobs" href="./managing-jobs">
    Organize and manage your TTS jobs
  </Card>

  <Card title="Overview" href="./overview">
    Learn about Text to Speech features
  </Card>
</CardGroup>
