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

# Audio Narrative

> Turn any text into a fully hosted, embeddable audio experience

Audio Narrative lets you convert written content into a rich audio experience — complete with a branded player you can embed anywhere. Paste your text, pick a voice, customize the look, and get a ready-to-use embed code in seconds.

## Overview

With Audio Narrative you can:

* Generate high-quality Arabic speech from any text (up to 10,000 characters)
* Choose from multiple Munsit voices and models
* Customize the player colors and theme to match your brand
* Embed the player on any website with a single `<script>` tag
* Manage and revisit all your generated narratives from your history

## How to use

<Steps>
  <Step title="Open Audio Narrative">
    From the Munsit dashboard, navigate to **Audio Narrative** in the sidebar. Click **Create New** to open the creation dialog.
  </Step>

  <Step title="Fill in page details">
    In the **Page Details** step:

    * **Title** – the headline shown on the player (e.g. article title)
    * **Author** – the byline displayed beneath the title
    * **Text** – paste the content you want read aloud (up to 10,000 characters)
    * **Model** – choose between `faseeh-v1-preview` for highest quality or `faseeh-mini-v1-preview` for faster generation
    * **Stability** – higher values produce a more consistent, neutral delivery; lower values add more expressive variation
    * **Speed** – adjust playback rate from 0.7× (slower) to 1.2× (faster)
    * **Voice** – select the voice that best fits your content
  </Step>

  <Step title="Customize the player">
    Switch to the **Player Customization** step to style the embedded player:

    * **Theme** – choose **Default** or **Light**
    * **Background color** – pick any hex color for the player background
    * **Text color** – pick any hex color for titles, controls, and timestamps

    A live preview updates in real time so you can see exactly how the player will look.
  </Step>

  <Step title="Generate and embed">
    Click **Create** to generate your audio narrative. Once ready, open the narrative from your history to:

    * Preview the audio with the built-in player
    * Tweak colors or theme further
    * Copy the embed code — a single `<script>` tag — and paste it into any webpage
  </Step>
</Steps>

## Live demo

Here's the player you get after generating a narrative — try it:

<iframe srcdoc="<!DOCTYPE html><html><head><meta charset='utf-8'><style>body{margin:0;padding:0}</style></head><body><script src='https://munsit-widget.pages.dev/widget.js' data-audio='https://pub-a2eeb500293c41df9e06b82b4178468a.r2.dev/generations/user_35sqHNyZfxsfCgn2jDbX5WEsGYY/023bdd41-c187-428c-9614-0cb16ac99c00.wav' data-title='Listen to this article' data-author='Your publication' data-bg='#ffffff' data-color='#1a1a1a' data-theme='default'></script></body></html>" width="100%" height="80" frameBorder="0" />

## The embed code

After generating a narrative, copy the embed code from the detail page and paste it into your HTML:

```html theme={null}
<script
  src="https://widget.munsit.com/audio-narrative@0.1.0-beta.js"
  data-audio="YOUR_AUDIO_URL"
  data-title="Your Article Title"
  data-author="Author Name"
  data-bg="#ffffff"
  data-color="#000000"
  data-theme="light"
></script>
```

| Attribute     | Description                       |
| ------------- | --------------------------------- |
| `data-audio`  | URL of the generated audio file   |
| `data-title`  | Title shown on the player         |
| `data-author` | Author byline shown on the player |
| `data-bg`     | Background color (hex)            |
| `data-color`  | Text and icon color (hex)         |
| `data-theme`  | `default` or `light`              |

## Generation parameters

| Parameter | Range       | Effect                                                                        |
| --------- | ----------- | ----------------------------------------------------------------------------- |
| Stability | 0 – 100%    | Controls delivery consistency; higher = more neutral, lower = more expressive |
| Speed     | 0.7× – 1.2× | Adjusts how fast the narrator speaks                                          |

<Note>
  Audio Narrative is optimized for Arabic content. For best results, ensure your input text is clean, well-punctuated Arabic.
</Note>
