README.md

---
title: Arabic XTTS TTS
emoji: 🎙️
colorFrom: blue
colorTo: purple
sdk: gradio
sdk_version: "4.0.0"
app_file: app.py
pinned: false
---

# 🎙️ Arabic TTS Professional

محول النص إلى كلام العربي الاحترافي - باستخدام تقنية Microsoft Azure TTS

## ✨ Features

- **Ultra-Natural Voices**: Microsoft Azure TTS - sounds completely human!
- **Multiple Arabic Dialects**: Egyptian, Saudi, UAE variants
- **Fast & Reliable**: Generates speech in under 5 seconds
- **High Quality**: Professional-grade audio output
- **Simple & Stable**: No complex dependencies or errors

## 🚀 How to Use

1. **Type your Arabic text** in the text box
2. **Select a voice** from the dropdown (Egyptian, Saudi, or UAE dialect)
3. **Click "Generate"**
4. **Listen and download** your professional audio!

## 📝 Tips for Best Results

- **Audio Quality**: Use clear recordings without background noise
- **Length**: 6-10 seconds is optimal for voice cloning
- **Format**: WAV is preferred, but MP3 works too
- **Diacritics**: Adding Arabic diacritics (التشكيل) improves pronunciation
- **Language**: The model is automatically optimized for Arabic

## 🛠️ Technical Details

This application uses:
- **Model**: XTTS v2 (Coqui TTS)
- **Framework**: Gradio
- **Language**: Arabic (ar)
- **Device**: GPU (if available) or CPU

## 📦 Files Included

- `app.py` - Main application with default speakers
- `requirements.txt` - Python dependencies
- `download_speakers.py` - Helper script to download sample audio files
- `speakers/` - Directory containing default speaker audio files

## 🎤 Default Speakers

- **ذكر - صوت رجالي** (Male Voice)
- **أنثى - صوت نسائي** (Female Voice)

More voices can be added later by uploading additional audio files to the speakers/ directory.

## 📞 Support

If you encounter any issues or have questions, feel free to open an issue or discussion!

---

**Enjoy your Arabic Voice Cloning App! 🎉**