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

# Transcribe a file, then turn it into speech

> Your first steps in Hamsa Media: sign in, transcribe a short recording, open the transcript, send part of it to text to speech, generate and download.

This guide takes you through the two services most people start with. You transcribe a short recording, read the transcript, send a part of it to text to speech, generate it in a voice you pick, and download the audio.

## Before you start

* A Hamsa account. Every new account gets a **Default** project and free credits to try Hamsa. Both steps here use [credits](https://docs.tryhamsa.com/overview/billing.md): speech to text about 1 credit a minute of audio, text to speech about 2 credits a minute.
* A short recording, a minute or two, of someone speaking Arabic or English: an MP3, WAV, OGG, WebM or MP4 file up to 200 MB. You can also use a YouTube link, or record with your microphone.

## 1. Sign in

**1. Open Hamsa Media**

Go to media.tryhamsa.com. If you don't have an account yet, click **Sign up** and create one.

**2. Sign in**

Enter your **Email** and **Password** and click **Sign in**, or use **Google** or **Microsoft**.

Hamsa Media opens on **Home**, in your project. To work in another project, pick it in the project switcher at the top of the page.

![Home after signing in: the greeting, the credits meter at the top right and the Start something cards, with Transcribe a file first](https://mintcdn.com/hamsa-452fa79a/-M2jaaqAG__ylQZS/images/media/workspace/home-light.webp?fit=max\&auto=format\&n=-M2jaaqAG__ylQZS\&q=85\&s=c44c52c7b5e350ce9c303c81d3e22533)

## 2. Transcribe a file

**1. Open the upload dialog**

On **Home**, click **Transcribe a file**. Speech to text opens with the upload dialog ready. (From the sidebar: **Speech to text**, then **Upload a file**.)

**2. Choose the file**

Drop your file on the dialog, or click **Choose files** and pick it.

**3. Check the title and language**

The **Title** is filled in from the file name; change it if you like. Set **Main language** to the language spoken: العربية (Arabic, the default) or English.

![The Transcribe a file dialog with evening-bulletin.wav chosen, the Title filled in from the file name and Main language set to Arabic](https://mintcdn.com/hamsa-452fa79a/fdE-9_eEW1W6yh_s/images/media/speech-to-text/upload-file-dialog-light.webp?fit=max\&auto=format\&n=fdE-9_eEW1W6yh_s\&q=85\&s=82f7b587844110e0c9d53712feb05b14)

**4. Start**

Click **Transcribe**. "Transcription started." confirms it, and the transcript appears at the top of the list as **Pending**.

![The Speech to text list with the new transcript at the top marked Pending, and the Transcription started message](https://mintcdn.com/hamsa-452fa79a/fdE-9_eEW1W6yh_s/images/media/start/transcription-started-light.webp?fit=max\&auto=format\&n=fdE-9_eEW1W6yh_s\&q=85\&s=df7fb1cb9b7faa14e27348beace9982c)

To use a YouTube link or your microphone instead, click **YouTube link** or **Record** on the Speech to text page. See [Transcribe files and links](https://docs.tryhamsa.com/media/speech-to-text/transcribe-files.md).

## 3. Open the transcript

You don't have to wait on the page: the **Activity** icon in the header follows the job, and "Transcript ready" tells you when it's done.

**1. Open it**

When the row says **Completed**, click it. The transcript opens in the editor, with the audio in the player at the bottom of the page.

**2. Play it**

Press Space, or click any word to play from there. The text follows the audio as it plays.

**3. Correct a segment**

If a word is wrong, click the pencil (**Edit segment**) on its segment, correct it, and click **Save**.

![A segment open for editing, with Save and Cancel](https://mintcdn.com/hamsa-452fa79a/fdE-9_eEW1W6yh_s/images/media/speech-to-text/edit-segment-light.webp?fit=max\&auto=format\&n=fdE-9_eEW1W6yh_s\&q=85\&s=dd52dd626e9cef90d5928ff3f64a0c70)

![The transcript playing: the current word highlighted in its segment, the speakers on the right and the player at the bottom](https://mintcdn.com/hamsa-452fa79a/fdE-9_eEW1W6yh_s/images/media/speech-to-text/transcript-editor-light.webp?fit=max\&auto=format\&n=fdE-9_eEW1W6yh_s\&q=85\&s=a281713e46863c4cb7ec92ec3bd6c8a0)

If the job shows **Failed** instead, open the row's menu and choose **Try again**. See [Troubleshooting](https://docs.tryhamsa.com/media/reference/troubleshooting.md#a-job-failed).

![The Run this job again dialog for a failed transcript, with Main language and Run again](https://mintcdn.com/hamsa-452fa79a/fdE-9_eEW1W6yh_s/images/media/speech-to-text/try-again-dialog-light.webp?fit=max\&auto=format\&n=fdE-9_eEW1W6yh_s\&q=85\&s=7d31375db189e5a86da9e7a4fe1164c2)

## 4. Send part of it to text to speech

**1. Pick the part**

Shift-click a segment, then Shift-click another to select every segment between them. The bar above the list shows how many are selected.

![Three segments selected, with Copy selection and Send to in the bar above the list](https://mintcdn.com/hamsa-452fa79a/fdE-9_eEW1W6yh_s/images/media/speech-to-text/segments-selected-light.webp?fit=max\&auto=format\&n=fdE-9_eEW1W6yh_s\&q=85\&s=0e61af11670ab8b4d9997a7cd37cee63)

**2. Send it**

In the bar, click **Send to**, then **Send to text to speech**. Text to speech opens with the text as the script, without times or speaker names.

![The Send to menu open on the selection bar, with Send to text to speech and Use in a voice over](https://mintcdn.com/hamsa-452fa79a/fdE-9_eEW1W6yh_s/images/media/start/send-to-menu-light.webp?fit=max\&auto=format\&n=fdE-9_eEW1W6yh_s\&q=85\&s=3195d2f7799ead3484a261528bc82683)

To send one segment, use **Send to text to speech** in its **More actions** menu. To send the whole transcript, use the **Copy** menu in the header.

Text to speech takes up to 3,000 characters at a time. If your selection is longer, a dialog offers **Use the first 3,000 characters**.

> [!TIP]
>
> You can skip the transcript and write a script yourself: click **Text to speech** in the sidebar (or **Generate speech** on Home) and type or paste into the editor.

## 5. Pick a voice and generate

**1. Pick the voice**

The **Voice settings** tab beside the script shows the voice that will read it. To change it, click **Change voice**, play a few samples, and click **Select** on the one you want. The voice decides the language and the dialect: pick an Egyptian voice for Egyptian Arabic, an English voice for English.

![The voice browser opened from Change voice, with voices to play and Select](https://mintcdn.com/hamsa-452fa79a/etUfiFCo8p_6XpY_/images/media/text-to-speech/select-a-voice-light.webp?fit=max\&auto=format\&n=etUfiFCo8p_6XpY_\&q=85\&s=cfa0fd457ed7faaea5d1ba9590d5ad4f)

**2. Check the estimate**

Beside **Generate speech**, the estimate shows the expected length and credits.

**3. Generate**

Click **Generate speech**, or press Cmd+Enter (Ctrl+Enter on Windows). The audio starts playing in the player as it arrives. When it's done, "TTS job created successfully" confirms it.

![Text to speech with the transcript text as the script, the Voice settings tab with the voice and Change voice, and the estimate beside Generate speech](https://mintcdn.com/hamsa-452fa79a/fdE-9_eEW1W6yh_s/images/media/start/tts-script-from-transcript-light.webp?fit=max\&auto=format\&n=fdE-9_eEW1W6yh_s\&q=85\&s=67a8fd664f710e8449419e4d41082fb3)

## 6. Download the audio

**1. Open History**

Open the **History** tab beside the script. Your take is at the top.

**2. Download**

Open the take's menu (the three dots) and click **Download**. "Audio downloaded" confirms it.

![A take's menu open in the History tab, on View, Copy, Download, Compare and Delete](https://mintcdn.com/hamsa-452fa79a/etUfiFCo8p_6XpY_/images/media/text-to-speech/take-menu-light.webp?fit=max\&auto=format\&n=etUfiFCo8p_6XpY_\&q=85\&s=0b9c72a4d73b66783d5e30b2ed9a2bb5)

The audio is a WAV file. You can also download the take in the player from its **More options** menu, with **Download media**.

## Next steps

> [card] [Export the transcript](https://docs.tryhamsa.com/media/speech-to-text/export.md)
>
> Subtitles, Word, text, PDF, a web page or JSON.

> [card] [Name the speakers](https://docs.tryhamsa.com/media/speech-to-text/speakers.md)
>
> Rename Speaker 1 and Speaker 2, merge and filter.

> [card] [Fix a word a voice gets wrong](https://docs.tryhamsa.com/media/voices/dictionaries.md)
>
> Save how it should be said in a dictionary.

> [card] [Make a voice over](https://docs.tryhamsa.com/media/voice-overs/create-a-voice-over.md)
>
> Narration with music, from a prompt or your script.

> [card] [Find a voice](https://docs.tryhamsa.com/media/voices/voices-library.md)
>
> Browse voices by dialect and use case, and compare them.

> [card] [How it fits together](https://docs.tryhamsa.com/media/concepts.md)
>
> Projects, jobs, credits, voices and permissions.


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