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

> Adjust speed, expressiveness, and other voice parameters

## Overview

Voice controls allow you to fine-tune how the selected voice delivers your text. You can adjust speed, expressiveness, and other parameters to match your content style and audience preferences.

<Info>
  Voice controls are optional. You can use default settings for good results, or fine-tune controls to achieve the perfect delivery for your content.
</Info>

## Speed Control

### Speed Adjustment

Control how fast the voice reads your text:

**Speed Range:**

* **Minimum**: 0x (very slow)
* **Maximum**: 2x (very fast)
* **Default**: 1x (normal speed)
* **Step Size**: 0.1x increments

**Adjustment Methods:**

* Drag slider left/right
* Click on slider track
* Enter value directly (if supported)
* Use increment buttons (if available)

### Speed Guidelines

**Very Slow (0.5x - 0.8x):**

* Clear, deliberate delivery
* Easy to follow
* Good for complex information
* May sound unnatural if too slow

**Normal Speed (0.9x - 1.1x):**

* Natural conversational pace
* Balanced delivery
* Good for most content
* Default recommended setting

**Fast (1.2x - 1.5x):**

* Quick, energetic delivery
* Time-efficient playback
* Good for summaries
* Maintains clarity

**Very Fast (1.6x - 2.0x):**

* Very quick playback
* Maximum time efficiency
* May reduce clarity
* Use with caution

### Speed Use Cases

**Slow Speed:**

* Important instructions
* Complex information
* Educational content
* Audience learning new language

**Normal Speed:**

* General content
* Most use cases
* Standard delivery
* Recommended default

**Fast Speed:**

* Quick summaries
* Time-constrained content
* Review material
* Energetic delivery

## Expressiveness Control

### Expressiveness Adjustment

Control the emotional range and variation in the voice:

**Expressiveness Range:**

* **Minimum**: 0 (more neutral)
* **Maximum**: 2 (more expressive)
* **Default**: 1 (balanced)
* **Step Size**: 0.1 increments

**Adjustment Methods:**

* Drag slider left/right
* Click on slider track
* Enter value directly (if supported)
* Fine-tune gradually

### Expressiveness Guidelines

**More Neutral (0 - 0.5):**

* Consistent, steady delivery
* Minimal emotional variation
* Professional, formal tone
* Good for factual content

**Balanced (0.6 - 1.0):**

* Natural variation
* Moderate expressiveness
* Good for general content
* Default recommended setting

**More Expressive (1.1 - 1.5):**

* Dynamic, varied delivery
* Emotional engagement
* Good for engaging content
* More personality

**Very Expressive (1.6 - 2.0):**

* Highly dynamic delivery
* Strong emotional variation
* Dramatic presentation
* Use for special content

### Expressiveness Use Cases

**Neutral:**

* News reporting
* Technical documentation
* Formal presentations
* Objective content

**Balanced:**

* General content
* Most use cases
* Standard delivery
* Recommended default

**Expressive:**

* Marketing content
* Storytelling
* Engaging presentations
* Emotional content

## Control Interaction

### Speed and Expressiveness Together

**Combined Effects:**

* Speed affects pacing
* Expressiveness affects delivery style
* Work together for overall effect
* Adjust both for best results

**Recommended Combinations:**

* **Formal**: Normal speed + Neutral expressiveness
* **Engaging**: Normal speed + Expressive
* **Quick Summary**: Fast speed + Neutral
* **Dramatic**: Normal speed + Very expressive

## Control Best Practices

### Starting Point

**Default Settings:**

* Start with defaults (1x speed, 1 expressiveness)
* Good for most content
* Professional quality
* Can adjust from there

**Testing:**

* Test with sample text
* Compare different settings
* Listen to results
* Adjust based on feedback

### Adjustment Strategy

**Gradual Changes:**

* Adjust in small increments
* Test after each change
* Compare before/after
* Find optimal settings

**Content-Based:**

* Match controls to content type
* Consider audience preferences
* Test with target audience
* Document preferred settings

### Settings Documentation

**Record Settings:**

* Note preferred settings
* Document for consistency
* Share with team
* Create style guide

**Settings Guidelines:**

* Establish default settings
* Create settings templates
* Train team on settings
* Maintain consistency

## Advanced Controls

### Dictionaries (If Available)

**Pronunciation Customization:**

* Select voice dictionaries
* Custom pronunciation rules
* Technical terms
* Proper nouns

### Text Optimization

**Arabic Text Optimization:**

* Optimize button for Arabic
* Improves pronunciation
* Adds natural pauses
* Enhances quality

## Troubleshooting

### Controls Not Responding

**Issue:** Sliders not working

**Solutions:**

* Refresh page
* Check browser compatibility
* Try different browser
* Clear cache

### Settings Not Saving

**Issue:** Controls reset

**Solutions:**

* Settings save with job
* Check job creation process
* Verify settings before generating
* Settings apply to generation

### Quality Issues

**Issue:** Audio quality poor with settings

**Solutions:**

* Return to defaults
* Adjust gradually
* Test different combinations
* Review text quality

## Next Steps

* **[Creating Jobs](./creating-jobs)** - Learn how to create TTS jobs
* **[Voice Selection](./voice-selection)** - Choose the right voice
* **[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 Selection" href="./voice-selection">
    Choose the right voice for your content
  </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>
