> ## 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.

# Browse and compare voices in the Voices library

> Find a voice in Hamsa Media by use case, language, dialect, style and gender, listen and compare up to three, keep favorites, and manage your project's voices.

The Voices library is where you find the voice for your text to speech, voice overs and other audio. Browse Hamsa's voices by use case, dialect and style, listen to them side by side, star the ones you like, and see the voices your team has added to the project.

Open **Voices library** in the sidebar. The page has two sections: **Voices** and [**Dictionaries**](https://docs.tryhamsa.com/media/voices/dictionaries.md). Switch between them with the control at the top.

![The Voices library on the Explore tab: tabs, search, Language and Dialect filters, use case chips, three collections and a list of featured voices](https://mintcdn.com/hamsa-452fa79a/SjdNHyLOJ-5kYaqE/images/media/voices/library-explore-light.webp?fit=max\&auto=format\&n=SjdNHyLOJ-5kYaqE\&q=85\&s=eac6e19eeda0f7168d5de431bc2f84ab)

## Find a voice

**1. Pick a tab**

| Tab | What it shows |
| - | - |
| **Explore** | Collections and featured voices chosen by Hamsa. Open a collection to see its voices, then **Back to explore** to return. |
| **Project voices** | Voices added to this project from a recording. "Everyone in this project can use it." |
| **Favorites** | Voices you starred in this project. "Only you see your favorites." |
| **All voices** | Every Hamsa voice for Hamsa Media. Your project's voices are under **Project voices**, not here. |

![The Stories and audiobooks collection open, with Back to explore above its four voices](https://mintcdn.com/hamsa-452fa79a/SjdNHyLOJ-5kYaqE/images/media/voices/library-collection-light.webp?fit=max\&auto=format\&n=SjdNHyLOJ-5kYaqE\&q=85\&s=e75cd503ed1caafb935917e40ddd6a7d)

**2. Narrow the list**

* **Search voices** finds a voice by its name or its voice ID.
* Use case chips: **Stories**, **Social media**, **Documentary**, **Advertising**, **Commercial**, **Religious**, **Audiobooks**, **Automatic response**, **Podcasts**, **Educational**, **Children education**, **Poetry**. Pick several to see voices that fit any of them.
* **Language**: **Arabic** or **English**.
* **Dialect**: one or more Arabic dialects. The list follows the language you picked. English voices have no dialect.
* **Filters**: **Style** and **Gender**. A number on the button shows how many are on.

![The Dialect list open under the filter bar, with Lebanon, Jordan, Syria, Fusha (MSA), Saudi Arabia and more](https://mintcdn.com/hamsa-452fa79a/SjdNHyLOJ-5kYaqE/images/media/voices/library-dialect-filter-light.webp?fit=max\&auto=format\&n=SjdNHyLOJ-5kYaqE\&q=85\&s=481f9903ce075610e3b234f519a750dc)

![The Filters panel with Conversational and Female selected, the Filters button showing 2, and Clear filters](https://mintcdn.com/hamsa-452fa79a/SjdNHyLOJ-5kYaqE/images/media/voices/library-filters-light.webp?fit=max\&auto=format\&n=SjdNHyLOJ-5kYaqE\&q=85\&s=c7aa2117d02bac23d013b31d26c3ee91)

**Clear filters** resets everything. Switching tabs also clears the search and filters.

![The Advertising and Social media chips selected, and the Filtered voices list showing 10 voices](https://mintcdn.com/hamsa-452fa79a/SjdNHyLOJ-5kYaqE/images/media/voices/library-filtered-light.webp?fit=max\&auto=format\&n=SjdNHyLOJ-5kYaqE\&q=85\&s=f532a9d94015543ba1d5da91e0da883e)

**3. Listen**

Click a voice's row, or its play button, to hear its sample. One sample plays at a time.

**4. Use it**

Click **Use** on the row. [Text to speech](https://docs.tryhamsa.com/media/text-to-speech/generate-speech.md) opens with that voice selected.

On the Explore tab, a search or filter lists the matching Hamsa voices with a count. Project voices aren't part of those results; look under **Project voices** for them.

### Keyboard

"Up and down arrows, or J and K, move between voices. Space plays the preview, Enter uses the voice." Press Cmd+K on Mac or Ctrl+K on Windows to switch tabs, switch section, search, create a voice or open a collection. See [Navigation](https://docs.tryhamsa.com/media/workspace/navigation.md).

## What a voice row shows

| Item | What it tells you |
| - | - |
| Name and picture | A voice without a picture gets a colored avatar |
| **Custom voice** | The voice was added to this project from a recording. Shown outside **Project voices**, where every voice is one. |
| Gender | Male or Female |
| Language or dialect | With a flag, for example Saudi Arabia, Egypt or English |
| Style | One of the styles below |
| Description and use cases | Hover the name for the full description |

| Style | What it sounds like |
| - | - |
| **Narrator** | "Clear and professional: fast-paced, continuous delivery that's clear, direct, and free of distractions." |
| **Conversational** | "Engaging and realistic: with natural pauses, breathing, and expressions that feel just like a real conversation." |
| **Enthusiastic**, **Formal**, **Dramatic**, **Whispering**, **Melodious** | Listen to a voice's sample to hear its delivery |

### Dialects

Arabic voices each speak one dialect. The app names them: Saudi Arabia, Arabic (Gulf), UAE, Kuwait, Qatar, Bahrain, Oman, Iraq, Jordan, Palestine, Syria, Lebanon, Egypt and MSA (Modern Standard Arabic). In the **Dialect** filter, MSA is listed as **Fusha (MSA)**. Pick the dialect your listeners speak.

## Compare voices

Hear up to three voices side by side before you choose.

**1. Add voices**

On a voice's row, open **More options** and click **Compare**. The voice gets a **Comparing** badge and a tray appears at the bottom of the page. Add at least two.

![A voice row's More options menu: Compare, Copy name and Copy ID](https://mintcdn.com/hamsa-452fa79a/SjdNHyLOJ-5kYaqE/images/media/voices/voice-more-options-light.webp?fit=max\&auto=format\&n=SjdNHyLOJ-5kYaqE\&q=85\&s=8a112af366121ad16eeadabbdb5bb9cb)

![Three voices with a Comparing badge, and the tray at the bottom reading 3 voices to compare with a Compare button](https://mintcdn.com/hamsa-452fa79a/etUfiFCo8p_6XpY_/images/media/voices/compare-tray-light.webp?fit=max\&auto=format\&n=etUfiFCo8p_6XpY_\&q=85\&s=effb798d295cb2d74519f0faee058c31)

**2. Open the comparison**

Click **Compare** in the tray. **Compare voices** opens: "Hear the voices side by side, then use the one you like."

**3. Listen and pick**

Play each voice, or click **Play all in turn** to hear them one after another. Click **Use this voice** on the one you want.

![The Compare voices panel with Rania, Fayez and Omar side by side, Fayez playing, and Play all in turn at the top](https://mintcdn.com/hamsa-452fa79a/etUfiFCo8p_6XpY_/images/media/voices/compare-voices-light.webp?fit=max\&auto=format\&n=etUfiFCo8p_6XpY_\&q=85\&s=a436aa56fca706c0c8efef58ddd4d814)

* A fourth voice can't be added: "You can compare up to 3 voices. Remove one to add another."
* The down arrow at the top right of the panel (or Escape) folds it back into the tray. **Clear** empties the comparison; in the tray, the X does the same.
* Your picks stay while you browse and after a reload, in that browser tab, and each project keeps its own.

## Favorites

Click the star on a voice to add it to **Favorites**. Click it again to remove it. Favorites are yours alone and belong to the project you starred them in: starring a voice in one project doesn't star it in another.

![The Favorites tab listing three starred voices: Rania, Nour and Omar](https://mintcdn.com/hamsa-452fa79a/SjdNHyLOJ-5kYaqE/images/media/voices/library-favorites-light.webp?fit=max\&auto=format\&n=SjdNHyLOJ-5kYaqE\&q=85\&s=bcae07015fdd62caf9193aa5b2a34d9d)

## Project voices

A voice you add from a recording is a project voice. Every member of the project sees it under **Project voices**, and it also appears in Hamsa Agents for the same project. To add one, click **Create a voice**. See [Add a voice](https://docs.tryhamsa.com/media/voices/add-a-voice.md).

![The Project voices tab with two voices: Salma, which you added, shows a delete button in place of the star; Dana, added by a teammate, shows a star](https://mintcdn.com/hamsa-452fa79a/SjdNHyLOJ-5kYaqE/images/media/voices/library-project-voices-light.webp?fit=max\&auto=format\&n=SjdNHyLOJ-5kYaqE\&q=85\&s=64201defe945a76e598a597193610fc2)

### Delete a project voice

**1. Find the voice**

Open **Project voices**. Only the person who added a voice can delete it.

**2. Delete it**

Click the delete button on its row, or **More options** > **Delete voice**, and confirm with **Delete**.

![More options on a project voice you added, with Delete voice at the bottom](https://mintcdn.com/hamsa-452fa79a/SjdNHyLOJ-5kYaqE/images/media/voices/project-voice-menu-light.webp?fit=max\&auto=format\&n=SjdNHyLOJ-5kYaqE\&q=85\&s=1b97d43a04325e4a5b7f9b7775f4617e)

**3. Undo if needed**

The voice leaves the list at once. The message "Deleted \{name}" has **Undo** for a few seconds. After that the voice is deleted for good.

![Salma gone from Project voices, and the message Deleted Salma with an Undo button in the corner](https://mintcdn.com/hamsa-452fa79a/SjdNHyLOJ-5kYaqE/images/media/voices/project-voice-deleted-undo-light.webp?fit=max\&auto=format\&n=SjdNHyLOJ-5kYaqE\&q=85\&s=4a55251a904b660832c473d51531e89a)

A voice can't be deleted, and comes back to the list with an error, when:

* it was used in a text to speech job that still exists in the project (delete those jobs first), or
* an agent in Hamsa Agents uses it ("Please unselect it from all agents to delete it.").

Hamsa's own voices can't be deleted or changed.

## Who can do what

| Action | Who, by default |
| - | - |
| Browse, listen, compare, use a voice | Everyone in the project |
| Star favorites | Everyone in the project |
| Add a voice | Owners and admins |
| Delete a project voice | Owners and admins, and only the voice they added |

Members see the **Create a voice** and delete buttons, but the request is refused unless an owner gives them the voices permissions. See [Roles and permissions](https://docs.tryhamsa.com/overview/projects/roles-and-permissions.md).

## Good to know

* **Copy ID** in **More options** copies the voice ID, for the API. **Copy name** copies its name.
* You can't star a voice you added yourself: its row shows delete in that place. Others in the project can star it.
* The voice picker in Text to speech, project defaults and the web reader is this same library, with **Select** instead of **Use** and no compare.

## Related

> [card] [Add a voice](https://docs.tryhamsa.com/media/voices/add-a-voice.md)
>
> Clone a voice for your project from a short recording.

> [card] [Dictionaries](https://docs.tryhamsa.com/media/voices/dictionaries.md)
>
> Fix how voices say specific words.

> [card] [Generate speech](https://docs.tryhamsa.com/media/text-to-speech/generate-speech.md)
>
> Turn your script into audio with the voice you picked.

> [card] [Voices in Hamsa Agents](https://docs.tryhamsa.com/agents/voices/choose-a-voice.md)
>
> Pick a voice for an agent.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.