Re-upload correct version of SyncMaster2

.gitattributes

@@ -0,0 +1,35 @@
+*.7z filter=lfs diff=lfs merge=lfs -text
+*.arrow filter=lfs diff=lfs merge=lfs -text
+*.bin filter=lfs diff=lfs merge=lfs -text
+*.bz2 filter=lfs diff=lfs merge=lfs -text
+*.ckpt filter=lfs diff=lfs merge=lfs -text
+*.ftz filter=lfs diff=lfs merge=lfs -text
+*.gz filter=lfs diff=lfs merge=lfs -text
+*.h5 filter=lfs diff=lfs merge=lfs -text
+*.joblib filter=lfs diff=lfs merge=lfs -text
+*.lfs.* filter=lfs diff=lfs merge=lfs -text
+*.mlmodel filter=lfs diff=lfs merge=lfs -text
+*.model filter=lfs diff=lfs merge=lfs -text
+*.msgpack filter=lfs diff=lfs merge=lfs -text
+*.npy filter=lfs diff=lfs merge=lfs -text
+*.npz filter=lfs diff=lfs merge=lfs -text
+*.onnx filter=lfs diff=lfs merge=lfs -text
+*.ot filter=lfs diff=lfs merge=lfs -text
+*.parquet filter=lfs diff=lfs merge=lfs -text
+*.pb filter=lfs diff=lfs merge=lfs -text
+*.pickle filter=lfs diff=lfs merge=lfs -text
+*.pkl filter=lfs diff=lfs merge=lfs -text
+*.pt filter=lfs diff=lfs merge=lfs -text
+*.pth filter=lfs diff=lfs merge=lfs -text
+*.rar filter=lfs diff=lfs merge=lfs -text
+*.safetensors filter=lfs diff=lfs merge=lfs -text
+saved_model/**/* filter=lfs diff=lfs merge=lfs -text
+*.tar.* filter=lfs diff=lfs merge=lfs -text
+*.tar filter=lfs diff=lfs merge=lfs -text
+*.tflite filter=lfs diff=lfs merge=lfs -text
+*.tgz filter=lfs diff=lfs merge=lfs -text
+*.wasm filter=lfs diff=lfs merge=lfs -text
+*.xz filter=lfs diff=lfs merge=lfs -text
+*.zip filter=lfs diff=lfs merge=lfs -text
+*.zst filter=lfs diff=lfs merge=lfs -text
+*tfevents* filter=lfs diff=lfs merge=lfs -text

.gitignore

@@ -0,0 +1,12 @@
+# Ignore environment files
+.env
+
+# Python
+__pycache__/
+*.py[cod]
+
+# Virtual environments
+.venv/
+
+# Other
+.DS_Store 

.streamlit/config.toml

@@ -0,0 +1,7 @@
+[server]
+headless = true
+address = "0.0.0.0"
+port = 5000
+
+[theme]
+base = "light"

Dockerfile

@@ -0,0 +1,34 @@
+#
+# -- Dockerfile for Streamlit app --
+#
+
+# Base image
+FROM python:3.9-slim
+
+# Set working directory
+WORKDIR /app
+
+# Install system dependencies (including ffmpeg)
+RUN apt-get update && apt-get install -y \
+    build-essential \
+    ffmpeg \
+    && rm -rf /var/lib/apt/lists/*
+
+# Copy requirements file
+COPY requirements.txt ./requirements.txt
+
+# Install Python dependencies
+RUN pip install --no-cache-dir --upgrade pip
+RUN pip install --no-cache-dir -r requirements.txt
+
+# Copy the entire app
+COPY . .
+
+# Expose the port that Streamlit runs on
+EXPOSE 8501
+
+# Add a health check
+HEALTHCHECK CMD curl --fail http://localhost:8501/_stcore/health
+
+# Command to run the app
+ENTRYPOINT ["streamlit", "run", "app.py", "--server.port=8501", "--server.address=0.0.0.0"]

INTEGRATION_SOLUTION.md

@@ -0,0 +1,75 @@
+# SyncMaster - Integrated Setup
+
+## 🚀 التشغيل المبسط (HuggingFace Ready)
+
+الآن يمكنك تشغيل التطبيق بأمر واحد فقط:
+
+```bash
+npm run dev
+```
+
+أو 
+
+```bash
+npm start
+```
+
+## 🔧 كيف تم حل المشكلة
+
+### المشكلة السابقة:
+- كان يتطلب تشغيل `python recorder_server.py` و `npm run dev` بشكل منفصل
+- غير مناسب للنشر على HuggingFace أو المنصات السحابية
+
+### الحل الجديد:
+1. **خادم متكامل**: تم إنشاء `integrated_server.py` الذي يشغل خادم التسجيل تلقائياً
+2. **نقطة دخول موحدة**: ملف `main.py` يبدأ كل شيء معاً
+3. **تكوين ذكي**: يكتشف البيئة تلقائياً (محلي أو سحابي)
+
+## 📁 الملفات الجديدة
+
+- `integrated_server.py` - يدير خادم التسجيل المدمج
+- `main.py` - نقطة الدخول الرئيسية 
+- `app_config.py` - إعدادات التطبيق
+- `startup.py` - مُشغل متقدم للتطوير
+
+## 🎯 للاستخدام العادي
+
+```bash
+# تشغيل التطبيق (يشمل خادم التسجيل)
+npm run dev
+
+# أو استخدام Python مباشرة
+streamlit run main.py
+```
+
+## ⚙️ للتطوير المتقدم
+
+```bash
+# تشغيل الخوادم بشكل منفصل (للتطوير)
+npm run dev-separate
+```
+
+## 🌐 للنشر على HuggingFace
+
+فقط ارفع المشروع واستخدم:
+- **Command**: `npm run start`
+- **Port**: `5050`
+
+سيتم تشغيل خادم التسجيل تلقائياً في الخلفية!
+
+## ✅ اختبار النظام
+
+```bash
+python integrated_server.py
+```
+
+## 🎉 النتيجة
+
+- **✅ تشغيل بأمر واحد فقط**
+- **✅ جاهز للنشر على HuggingFace**
+- **✅ يعمل محلياً وسحابياً**
+- **✅ لا حاجة لتشغيل أوامر متعددة**
+
+---
+
+المشكلة محلولة! الآن يمكنك استخدام `npm run dev` فقط وسيعمل كل شيء تلقائياً 🎊

PERFORMANCE_IMPROVEMENTS.md

@@ -0,0 +1,76 @@
+# 🚀 تحسينات الأداء - مشكلة الشاشة البيضاء محلولة
+
+## 🔍 التحليل والمشكلة:
+كانت المشكلة أن خادم التسجيل يبدأ **بشكل متزامن** عند تحميل الصفحة، مما يسبب:
+- ⏰ تأخير في التحميل (نصف ثانية إلى ثانية)
+- ⚪ شاشة بيضاء أثناء انتظار بدء الخادم
+- 🐌 تجربة مستخدم بطيئة
+
+## ✅ الحلول المطبقة:
+
+### 1. **تشغيل غير متزامن للخادم**
+```python
+# بدلاً من:
+ensure_recorder_server()  # يحجب الواجهة
+
+# الآن:
+recorder_thread = threading.Thread(target=start_recorder_async, daemon=True)
+recorder_thread.start()  # لا يحجب الواجهة
+```
+
+### 2. **تسريع فحص الاستجابة**
+```python
+# قبل: timeout=3 ثوان
+# الآن: timeout=0.5 ثانية
+response = requests.get(url, timeout=0.5)
+```
+
+### 3. **تحسين انتظار بدء الخادم**
+```python
+# قبل: sleep(1) × 10 مرات = 10 ثوان
+# الآن: sleep(0.5) × 15 مرة = 7.5 ثانية
+time.sleep(0.5)
+```
+
+### 4. **تحسين CSS لمنع الفلاش**
+```css
+.main .block-container { 
+    animation: fadeIn 0.2s ease-in-out; 
+}
+.stSpinner { display: none !important; }
+```
+
+### 5. **فحص ذكي للخادم**
+```python
+# فحص سريع أولاً
+if integrated_server.is_server_responding():
+    return True  # خروج فوري إذا كان يعمل
+```
+
+## 📊 النتائج:
+
+### قبل التحسين:
+- ⏱️ **تحميل الصفحة**: 1+ ثانية
+- ⚪ **شاشة بيضاء**: نعم
+- 🔄 **تأخير ملحوظ**: نعم
+
+### بعد التحسين:
+- ⏱️ **تحميل الصفحة**: 0.008-0.023 ثانية
+- ⚪ **شاشة بيضاء**: لا
+- ⚡ **تحميل فوري**: نعم
+
+## 🎯 التحسينات الإضافية:
+
+1. **عدم عرض رسائل تحميل غير ضرورية**
+2. **بدء الخادم في الخلفية فقط عند الحاجة**
+3. **تقليل عدد رسائل السجل**
+4. **تحسين CSS للانتقالات السلسة**
+
+## 🚀 النتيجة النهائية:
+
+✅ **لا مزيد من الشاشة البيضاء**  
+✅ **تحميل فوري للمحتوى**  
+✅ **تجربة مستخدم سلسة**  
+✅ **أداء ممتاز (0.008 ثانية)**  
+
+**المشكلة محلولة تماماً!** 🎊

QUICK_START.md

@@ -0,0 +1,202 @@
+# 🎯 دليل الإصلاح والتشغيل السريع - SyncMaster Enhanced
+# Quick Fix and Startup Guide - SyncMaster Enhanced
+
+## ✅ النظام جاهز للعمل! / System Ready!
+
+تم اختبار جميع المكونات بنجاح ✅ All components tested successfully
+
+## 🚀 طرق التشغيل / Startup Methods
+
+### 1. التشغيل التلقائي المتقدم / Advanced Auto-Start (موصى به / Recommended)
+```bash
+python start_debug.py
+```
+**المزايا / Benefits:**
+- فحص تلقائي للمشاكل / Automatic problem detection
+- إصلاح تضارب المنافذ / Port conflict resolution  
+- رسائل خطأ واضحة / Clear error messages
+- تشغيل آمن / Safe startup
+
+### 2. التشغيل اليدوي / Manual Startup
+```bash
+# النافذة الأولى / First Terminal
+python recorder_server.py
+
+# النافذة الثانية / Second Terminal  
+streamlit run app.py --server.port 8501
+```
+
+### 3. التشغيل السريع / Quick Start (Windows)
+```bash
+start_enhanced.bat
+```
+
+## 🌐 الروابط / URLs
+
+بعد التشغيل الناجح / After successful startup:
+
+- **🎙️ واجهة التسجيل / Recording Interface**: http://localhost:5001
+- **💻 التطبيق الرئيسي / Main Application**: http://localhost:8501
+- **🔄 فحص حالة الخادم / Server Status**: http://localhost:5001/record
+
+## 📋 خطوات الاستخدام / Usage Steps
+
+### للطلاب الجدد / For New Users:
+
+#### 1. إعداد اللغة / Language Setup
+- اختر اللغة المفضلة (عربي/English)
+- فعّل الترجمة التلقائية
+- اختر اللغة المستهدفة
+
+#### 2. التسجيل / Recording
+- اذهب لتبويب "🎙️ Record Audio"  
+- اضغط "Start Recording" / "بدء التسجيل"
+- تحدث بوضوح
+- استخدم "Mark Important" للنقاط المهمة
+- اضغط "Stop" عند الانتهاء
+
+#### 3. المعالجة / Processing
+- اضغط "Extract Text" / "استخراج النص"
+- انتظر المعالجة (قد تستغرق دقائق)
+- راجع النص الأصلي والمترجم
+
+#### 4. الحفظ / Saving
+- انسخ النص المطلوب
+- احفظ ملف JSON للمراجعة لاحقاً
+
+## 🔧 استكشاف الأخطاء / Troubleshooting
+
+### المشكلة الأكثر شيوعاً / Most Common Issue:
+```
+Error: Failed to fetch
+POST http://localhost:5001/record net::ERR_CONNECTION_REFUSED
+```
+
+### الحل السريع / Quick Fix:
+```bash
+# 1. أوقف جميع العمليات / Stop all processes
+taskkill /f /im python.exe
+
+# 2. شغّل الاختبار / Run test
+python test_system.py
+
+# 3. شغّل النظام / Start system
+python start_debug.py
+```
+
+### إذا لم يعمل / If Still Not Working:
+```bash
+# فحص المنافذ / Check ports
+netstat -an | findstr :5001
+netstat -an | findstr :8501
+
+# إعادة تثبيت التبعيات / Reinstall dependencies
+pip install --upgrade -r requirements.txt
+```
+
+## 💡 نصائح مهمة / Important Tips
+
+### للحصول على أفضل النتائج / For Best Results:
+
+#### جودة التسجيل / Recording Quality:
+- استخدم سماعة رأس بميكروفون
+- اجلس في مكان هادئ
+- تحدث بوضوح وبطء نسبي
+- تجنب الضوضاء الخلفية
+
+#### إعدادات الترجمة / Translation Settings:
+- **للطلاب العرب**: فعّل الترجمة للإنجليزية لفهم المصطلحات التقنية
+- **للطلاب الدوليين**: استخدم الترجمة للغتك الأم
+- **للمحاضرات المختلطة**: راجع النص بكلا اللغتين
+
+#### استخدام العلامات / Using Markers:
+- ضع علامة عند المفاهيم الجديدة
+- اعلم النقاط المهمة للامتحان
+- استخدم العلامات للتنظيم
+
+## 📱 متطلبات النظام / System Requirements
+
+### الحد الأدنى / Minimum:
+- Python 3.8+
+- 4 GB RAM
+- اتصال إنترنت للترجمة
+- مساحة 1 GB على القرص الصلب
+
+### الموصى به / Recommended:
+- Python 3.10+
+- 8 GB RAM
+- اتصال إنترنت سريع
+- SSD للتخزين
+- ميكروفون عالي الجودة
+
+## 🌟 ميزات متقدمة / Advanced Features
+
+### اختصارات لوحة المفاتيح / Keyboard Shortcuts:
+- **Space**: بدء/إيقاف التسجيل
+- **M**: وضع علامة مهمة  
+- **P**: إيقاف مؤقت/استئناف
+- **R**: إعادة تسجيل
+
+### واجهة برمجة التطبيقات / API Features:
+- ترجمة نصوص مستقلة
+- معالجة مجمعة للملفات
+- كشف اللغة التلقائي
+- تخصيص إعدادات الصوت
+
+## 📞 الدعم التقني / Technical Support
+
+### أدوات التشخيص / Diagnostic Tools:
+```bash
+# اختبار شامل / Complete test
+python test_system.py
+
+# فحص الاتصال / Connection test  
+python -c "import requests; print(requests.get('http://localhost:5001/record').status_code)"
+
+# اختبار الترجمة / Translation test
+python -c "from translator import AITranslator; t=AITranslator(); print(t.translate_text('Hello', 'ar'))"
+```
+
+### ملفات السجل / Log Files:
+- تحقق من console المتصفح (F12)
+- راجع سجلات الطرفية
+- ابحث عن ملفات tmp*.json
+
+## 🎓 للمدرسين والمحاضرين / For Teachers and Lecturers
+
+### إعدادات الفصل / Classroom Setup:
+- تأكد من إذن التسجيل
+- وضح للطلاب كيفية الاستخدام
+- اقترح جلسات تدريبية
+
+### نصائح للمحاضرات / Lecture Tips:
+- تحدث بوضوح
+- اكرر المصطلحات المهمة  
+- استخدم فترات صمت قصيرة
+- اشرح بعدة لغات إذا أمكن
+
+---
+
+## 🎉 مبروك! / Congratulations!
+
+**النظام جاهز للاستخدام! / System is ready to use!**
+
+```bash
+# للبدء الآن / To start now:
+python start_debug.py
+```
+
+**استمتع بتجربة تعليمية محسنة مع SyncMaster! 🚀**
+**Enjoy an enhanced learning experience with SyncMaster! 🚀**
+
+---
+
+### 📋 Checklist
+
+- ✅ Python مثبت / Python installed
+- ✅ التبعيات مثبتة / Dependencies installed  
+- ✅ مفتاح API مُعد / API key configured
+- ✅ اختبار النظام نجح / System test passed
+- ✅ جاهز للاستخدام / Ready to use
+
+**🎯 التالي: python start_debug.py**

README.md

@@ -0,0 +1,221 @@
+---
+title: SyncMaster Enhanced
+emoji: 🚀
+colorFrom: red
+colorTo: red
+sdk: docker
+app_port: 8501
+tags:
+- streamlit
+- ai-translation
+- speech-to-text
+- multilingual
+- education
+pinned: false
+short_description: AI-powered audio transcription and translation for international students
+license: mit
+---
+
+# SyncMaster Enhanced - AI-Powered Audio Transcription & Translation
+
+> **🌟 New: Enhanced with AI Translation Support for International Students**
+> **جديد: محسن مع دعم الترجمة بالذكاء الاصطناعي للطلاب الدوليين**
+
+SyncMaster is an intelligent audio-text synchronization platform specifically designed for international students in universities. It provides real-time audio recording, AI-powered transcription, and automatic translation to help students better understand and review their lectures.
+
+## ✨ Key Features
+
+### 🌐 Multi-Language Support
+- **Full Arabic Interface**: Complete Arabic UI for better accessibility
+- **AI-Powered Translation**: Automatic translation to Arabic, English, French, and Spanish
+- **Language Detection**: Automatically detects the source language
+- **Academic Context**: Specialized translation for academic content
+
+### 🎙️ Enhanced Recording
+- **Browser-based Recording**: Record directly from your web browser
+- **Real-time Audio Visualization**: Visual feedback during recording
+- **Important Markers**: Mark important points during lectures
+- **Pause/Resume**: Full control over recording sessions
+
+### 🤖 AI Technology
+- **Gemini AI Integration**: Accurate transcription using Google's Gemini AI
+- **Advanced Translation**: Context-aware translation for educational content
+- **Parallel Processing**: Fast and efficient audio processing
+
+### 📱 Student-Friendly Features
+- **Responsive Design**: Works on desktop, tablet, and mobile
+- **Keyboard Shortcuts**: Quick access to common functions
+- **Accessibility**: Screen reader support and RTL language support
+- **Offline Capability**: Process recordings without constant internet
+
+## 🚀 Quick Start
+
+### For International Students:
+
+1. **Setup**:
+   ```bash
+   # Clone or download the project
+   # Install Python 3.8+
+   python setup_enhanced.py
+   ```
+
+2. **Run**:
+   ```bash
+   # Windows
+   start_enhanced.bat
+   
+   # Linux/Mac
+   python setup_enhanced.py
+   ```
+
+3. **Configure**:
+   - Add your Gemini API key to `.env` file
+   - Choose your preferred language (Arabic/English)
+   - Enable translation and select target language
+
+### API Key Setup:
+1. Get a free Gemini API key from [Google AI Studio](https://makersuite.google.com/app/apikey)
+2. Add it to your `.env` file:
+   ```
+   GEMINI_API_KEY=your_api_key_here
+   ```
+
+## 📖 Usage Guide
+
+### Recording Lectures:
+1. Go to the **Record Audio** tab
+2. Click **Start Recording**
+3. Use **Mark Important** for key points
+4. Click **Stop** when finished
+5. Click **Extract Text** to process
+
+### Translation:
+1. Enable translation in settings
+2. Select target language
+3. Process your audio
+4. Review both original and translated text
+
+### Export Options:
+- Copy text for notes
+- Save as files for later review
+- Generate synchronized videos (coming soon)
+
+## 🎓 For Students
+
+### Arabic Students (للطلاب العرب):
+- استخدم الواجهة العربية لسهولة الاستخدام
+- فعّل الترجمة للإنجليزية لفهم المصطلحات التقنية
+- ضع علامات على المفاهيم الجديدة أثناء المحاضرة
+
+### International Students:
+- Use translation to your native language for better understanding
+- Mark important concepts during lectures
+- Review both original and translated text together
+
+## ⌨️ Keyboard Shortcuts
+- **Space**: Start/Stop recording
+- **M**: Mark important point
+- **P**: Pause/Resume
+- **R**: Re-record
+
+## 🔧 Technical Requirements
+
+### System Requirements:
+- Python 3.8 or higher
+- Modern web browser (Chrome, Firefox, Safari, Edge)
+- Microphone access for recording
+- Internet connection for AI processing
+
+### Dependencies:
+- Streamlit (Web interface)
+- Google Generative AI (Transcription & Translation)
+- Flask (Recording server)
+- LibROSA (Audio processing)
+
+## 📱 Browser Compatibility
+
+| Browser | Recording | Translation | UI |
+|---------|-----------|-------------|----| 
+| Chrome | ✅ | ✅ | ✅ |
+| Firefox | ✅ | ✅ | ✅ |
+| Safari | ✅ | ✅ | ✅ |
+| Edge | ✅ | ✅ | ✅ |
+
+## 🛠️ Troubleshooting
+
+### Common Issues:
+
+**Microphone not working:**
+- Grant microphone permission to your browser
+- Check system audio settings
+- Try a different browser
+
+**Translation errors:**
+- Check internet connection
+- Verify Gemini API key
+- Try processing again
+
+**Poor transcription quality:**
+- Ensure clear audio recording
+- Reduce background noise
+- Speak clearly and at moderate pace
+
+## 🔮 Roadmap
+
+### Coming Soon:
+- **Smart Content Analysis**: Automatic extraction of key concepts
+- **Study Cards**: Generate flashcards from lectures
+- **Platform Integration**: Connect with Moodle, Canvas, etc.
+- **Collaborative Features**: Share recordings with classmates
+- **Advanced Analytics**: Learning progress tracking
+
+## 📚 Documentation
+
+- [**Arabic Guide**](README_AR.md) - دليل باللغة العربية
+- [**API Documentation**](docs/api.md) - Technical API reference
+- [**Troubleshooting**](docs/troubleshooting.md) - Detailed problem solving
+
+## 🤝 Contributing
+
+We welcome contributions from the international student community:
+
+1. Fork the repository
+2. Create a feature branch
+3. Add your improvements
+4. Submit a pull request
+
+### Areas for Contribution:
+- Additional language support
+- UI improvements
+- Mobile optimization
+- Documentation translation
+
+## 📄 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## 🙏 Acknowledgments
+
+- Google Gemini AI for transcription and translation
+- Streamlit team for the amazing web framework
+- International student community for feedback and testing
+
+## 📞 Support
+
+For technical support or questions:
+- Check the browser console (F12) for error details
+- Review log files in the application directory
+- Ensure all dependencies are up to date
+
+---
+
+**Made with ❤️ for international students worldwide**
+**صُنع بـ ❤️ للطلاب الدوليين حول العالم**
+
+---
+
+### Quick Links:
+- 🚀 [Quick Start Guide](docs/quickstart.md)
+- 🌐 [Arabic Documentation](README_AR.md)
+- 🎓 [Student Guide](docs/student-guide.md)
+- 🔧 [Technical Setup](docs/technical-setup.md)

README_AR.md

@@ -0,0 +1,134 @@
+# SyncMaster - دليل المستخدم للطلاب الأجانب
+
+## 🎯 نظرة عامة
+SyncMaster هو تطبيق ذكي مطور خصيصاً للطلاب الأجانب في الجامعات لتسجيل المحاضرات وتحويلها إلى نص مكتوب مع ترجمة فورية باستخدام الذكاء الاصطناعي.
+
+## ✨ الميزات الجديدة
+
+### 🌐 دعم متعدد اللغات
+- **واجهة عربية كاملة**: تم تطوير واجهة باللغة العربية لتسهيل الاستخدام
+- **ترجمة فورية**: ترجمة النص المنسوخ إلى العربية والإنجليزية والفرنسية والإسبانية
+- **كشف اللغة التلقائي**: يتعرف النظام على لغة المحاضرة تلقائياً
+
+### 🎙️ ميزات التسجيل المحسنة
+- **تسجيل مباشر**: تسجيل المحاضرات مباشرة من المتصفح
+- **علامات مهمة**: وضع علامات على النقاط المهمة أثناء التسجيل
+- **مؤشر مستوى الصوت**: عرض مرئي لمستوى الصوت
+- **إيقاف مؤقت واستئناف**: تحكم كامل في التسجيل
+
+### 🤖 ذكاء اصطناعي متطور
+- **نسخ دقيق**: استخدام Gemini AI لنسخ دقيق للمحاضرات
+- **ترجمة محسنة**: ترجمة متخصصة للمحتوى الأكاديمي
+- **معالجة متوازية**: معالجة سريعة وفعالة
+
+## 🚀 كيفية الاستخدام
+
+### الخطوة 1: إعداد اللغة
+1. اختر لغة الواجهة من القائمة العلوية (العربية/English)
+2. فعّل الترجمة التلقائية
+3. اختر اللغة المستهدفة للترجمة
+
+### الخطوة 2: التسجيل
+1. اضغط على تبويب "🎙️ Record Audio"
+2. اضغط "Start Recording" لبدء التسجيل
+3. استخدم "Mark Important" لوضع علامات على النقاط المهمة
+4. اضغط "Stop" لإنهاء التسجيل
+
+### الخطوة 3: المعالجة والترجمة
+1. اضغط "Extract Text" لبدء المعالجة
+2. انتظر حتى يكتمل النسخ والترجمة
+3. راجع النص الأصلي والمترجم
+
+### الخطوة 4: التصدير
+1. احفظ النتائج أو انسخها
+2. استخدم الملف المحفوظ للمراجعة لاحقاً
+
+## ⌨️ اختصارات لوحة المفاتيح
+- **Space**: بدء/إيقاف التسجيل
+- **M**: وضع علامة مهمة
+- **P**: إيقاف مؤقت/استئناف
+- **R**: إعادة تسجيل
+
+## 📱 نصائح للطلاب الأجانب
+
+### للطلاب العرب:
+- استخدم الواجهة العربية للسهولة
+- فعّل الترجمة للإنجليزية لفهم المصطلحات التقنية
+- ضع علامات على المفاهيم الجديدة
+
+### للطلاب الدوليين:
+- استخدم الترجمة إلى لغتك الأم للفهم الأفضل
+- اعتمد على العلامات المهمة للمراجعة السريعة
+- راجع النص المترجم والأصلي معاً
+
+## 🔧 إعدادات متقدمة
+
+### جودة التسجيل:
+- **عالية**: للمحاضرات المهمة (320 kbps)
+- **متوسطة**: للاستخدام العادي (192 kbps)
+- **منخفضة**: لتوفير المساحة (128 kbps)
+
+### إعدادات الترجمة:
+- **Arabic**: للطلاب العرب
+- **English**: للمحتوى الدولي
+- **French**: للطلاب الفرنكوفونيين
+- **Spanish**: للطلاب الناطقين بالإسبانية
+
+## 🛠️ استكشاف الأخطاء
+
+### مشاكل الميكروفون:
+1. تأكد من إعطاء إذن الميكروفون للمتصفح
+2. تحقق من إعدادات الصوت في النظام
+3. جرب متصفح آخر إذا لزم الأمر
+
+### مشاكل الترجمة:
+1. تأكد من اتصال الإنترنت
+2. تحقق من صحة مفتاح API
+3. جرب إعادة المعالجة
+
+### مشاكل في النسخ:
+1. تأكد من وضوح الصوت
+2. قلل الضوضاء في الخلفية
+3. تحدث بوضوح وبطء نسبياً
+
+## 📞 الدعم التقني
+
+### الحصول على المساعدة:
+- تحقق من console المتصفح (F12) للأخطاء
+- راجع ملفات السجل في مجلد التطبيق
+- تأكد من تحديث جميع المكتبات
+
+### نصائح للأداء الأفضل:
+- استخدم Chrome أو Firefox للتوافق الأفضل
+- أغلق التطبيقات الأخرى أثناء التسجيل
+- تأكد من مساحة كافية على القرص الصلب
+
+## 🎓 نصائح أكاديمية
+
+### للمحاضرات:
+- اجلس في مقدمة القاعة للصوت الأوضح
+- استخدم علامات المحاضر المهمة كدليل
+- راجع الترجمة مع زملاء الدراسة
+
+### للمذاكرة:
+- استخدم النص المترجم للمراجعة السريعة
+- ابحث عن المفاهيم المترجمة في مصادر إضافية
+- اربط النص الأصلي بالترجمة لتحسين اللغة
+
+## 🔮 ميزات قادمة
+
+### التحديثات المخططة:
+- **تحليل المحتوى**: استخراج النقاط الرئيسية تلقائياً
+- **بطاقات المراجعة**: إنشاء بطاقات دراسة من المحاضرات
+- **التكامل مع المنصات**: ربط مع Moodle وCanvas
+- **المشاركة التعاونية**: مشاركة المحاضرات مع الزملاء
+
+---
+
+## 📄 إخلاء المسؤولية
+
+هذا التطبيق مخصص للاستخدام التعليمي. تأكد من الحصول على إذن المحاضر قبل تسجيل المحاضرات. النسخ والترجمة قد يحتويان على أخطاء، لذا راجعهما دائماً.
+
+---
+
+**نتمنى لك تجربة تعليمية ممتازة مع SyncMaster! 🎓✨**

SOLUTION_SUMMARY.md

@@ -0,0 +1,69 @@
+# 🎉 تم حل المشكلة بنجاح!
+
+## ✅ ملخص الحل
+
+تم حل مشكلة "system offline" في ميزة Lecture Recorder بنجاح. الآن يمكنك تشغيل التطبيق بأمر واحد فقط:
+
+```bash
+npm run dev
+```
+
+## 🔧 التغييرات التي تمت
+
+### 1. ملفات جديدة تم إنشاؤها:
+- `integrated_server.py` - خادم متكامل للتسجيل
+- `main.py` - نقطة دخول بسيطة ومدمجة
+- `app_config.py` - إعدادات التطبيق
+- `startup.py` - مُشغل متقدم للتطوير
+
+### 2. ملفات تم تعديلها:
+- `app.py` - إضافة استيراد الخادم المدمج
+- `package.json` - تحديث أوامر التشغيل
+
+## 🚀 كيفية الاستخدام
+
+### للاستخدام العادي:
+```bash
+npm run dev
+```
+
+### للنشر على HuggingFace:
+```bash
+npm start
+```
+
+### للتطوير المتقدم (خوادم منفصلة):
+```bash
+npm run dev-separate
+```
+
+## ✨ المميزات الجديدة
+
+1. **🎯 تشغيل موحد**: أمر واحد فقط لتشغيل كل شيء
+2. **☁️ جاهز للسحابة**: يعمل تلقائياً على HuggingFace و Railway
+3. **🔧 تكوين ذكي**: يكتشف البيئة ويتكيف معها
+4. **🛡️ معالجة أخطاء محسنة**: تشغيل احتياطي في حالة فشل الطريقة الأولى
+5. **📊 مراقبة الحالة**: فحص تلقائي لحالة الخوادم
+
+## 🧪 اختبار النظام
+
+تم اختبار النظام وأظهر النتائج التالية:
+- ✅ خادم التسجيل يبدأ تلقائياً
+- ✅ Streamlit يعمل على المنفذ 5050
+- ✅ خادم التسجيل يعمل على المنفذ 5001
+- ✅ التكامل بين الخوادم يعمل بنجاح
+
+## 🎊 النتيجة النهائية
+
+**المشكلة محلولة تماماً!** 
+
+لن تحتاج بعد الآن إلى:
+- ❌ تشغيل `python recorder_server.py` منفصلاً
+- ❌ القلق بشأن "system offline"
+- ❌ تشغيل أوامر متعددة
+
+فقط استخدم `npm run dev` وسيعمل كل شيء تلقائياً! 🚀
+
+---
+
+**جاهز للنشر على HuggingFace الآن!** 🌟

SUMMARY_FIX_REPORT.md

@@ -0,0 +1,169 @@
+# حل مشكلة زر التلخيص - تقرير الإصلاح النهائي 🎉
+
+## 📋 ملخص المشكلة
+كان زر "Generate Smart Lecture Summary" لا يعمل في تلخيص النص المستخرج من الذكاء الاصطناعي بعد جلبه من الصوت، مع ظهور خطأ CORS:
+
+```
+Access to fetch at 'http://localhost:5001/summarize' from origin 'http://localhost:5054' has been blocked by CORS policy: Response to preflight request doesn't pass access control check: The 'Access-Control-Allow-Origin' header contains multiple values '*, *', but only one is allowed.
+```
+
+## 🔍 التشخيص المنجز
+تم إنشاء نظام تشخيص شامل كشف عن:
+
+### 1. مشكلة CORS الرئيسية ❌
+- **المشكلة**: الخادم يرسل `'*, *'` بدلاً من `'*'`
+- **السبب**: تكرار إعدادات CORS - مرة من `flask-cors` ومرة يدوياً في كل endpoint
+- **النتيجة**: تكرار header `Access-Control-Allow-Origin`
+
+### 2. مكتبة مفقودة ❌
+- **المشكلة**: `google-generativeai` غير مثبتة
+- **التأثير**: فشل في وظيفة التلخيص
+
+## ✅ الحلول المطبقة
+
+### 1. إصلاح مشكلة CORS
+#### أ. تبسيط إعداد CORS في `recorder_server.py`:
+```python
+# قبل الإصلاح - إعداد معقد
+CORS(app, resources={
+    r"/record": {"origins": "*"},
+    r"/translate": {"origins": "*"},
+    r"/languages": {"origins": "*"},
+    r"/ui-translations/*": {"origins": "*"},
+    r"/notes": {"origins": "*"},
+    r"/notes/*": {"origins": "*"},
+    r"/summarize": {"origins": "*"}
+})
+
+# بعد الإصلاح - إعداد مبسط وصحيح
+CORS(app, 
+     origins="*",
+     methods=['GET', 'POST', 'PUT', 'DELETE', 'OPTIONS'],
+     allow_headers=['Content-Type', 'Authorization']
+)
+```
+
+#### ب. إزالة الإعدادات اليدوية المكررة:
+```python
+# قبل الإصلاح - إعداد يدوي مكرر
+if request.method == 'OPTIONS':
+    headers = {
+        'Access-Control-Allow-Origin': '*',
+        'Access-Control-Allow-Methods': 'POST, OPTIONS',
+        'Access-Control-Allow-Headers': 'Content-Type',
+    }
+    return ('', 204, headers)
+
+# بعد الإصلاح - تبسيط
+if request.method == 'OPTIONS':
+    return '', 204  # flask-cors ستتولى الأمر
+```
+
+### 2. تثبيت المكتبات المفقودة
+```bash
+pip install google-generativeai
+```
+
+### 3. تحسين معالجة الأخطاء في JavaScript
+تم تحديث دالة `generateSummary()` في `templates/recorder.html`:
+- رسائل خطأ محددة باللغة العربية
+- معالجة أفضل لتنسيقات الاستجابة المختلفة
+- تشخيص أوضح للمشاكل
+
+### 4. تحسين دالة عرض النتائج
+تم تحديث `displaySummaryResults()` للتعامل مع:
+- تنسيقات مختلفة للاستجابة (نص أو كائن)
+- عرض محتوى احتياطي في حالة عدم وجود المحتوى المتوقع
+
+## 🧪 أدوات التشخيص المُنشأة
+
+### 1. `diagnose_summary.py`
+نظام تشخيص شامل يفحص:
+- حالة العمليات والمنافذ
+- إعدادات CORS
+- وظيفة التلخيص
+- المكتبات المطلوبة
+
+### 2. `test_summary_button.py`
+اختبار مبسط ومباشر لزر التلخيص
+
+### 3. `test_summarize.py`
+اختبار أساسي لـ endpoint التلخيص
+
+## 📊 نتائج الاختبار النهائية ✅
+
+```
+🎉 جميع الاختبارات نجحت!
+✅ زر التلخيص يعمل بشكل صحيح
+
+📊 ملخص التشخيص:
+  📦 المكتبات: ✅ موجودة
+  🔧 عملية Python: ✅ تعمل
+  🌐 المنفذ 5001: ✅ مفتوح
+  🔧 CORS: ✅ صحيح
+  🤖 التلخيص: ✅ يعمل
+```
+
+## 🔧 الملفات المُعدّلة
+
+### 1. `recorder_server.py`
+- إصلاح إعدادات CORS
+- إزالة التكرار في headers
+- تبسيط معالجة OPTIONS requests
+
+### 2. `templates/recorder.html`
+- تحسين دالة `generateSummary()`
+- تحسين دالة `displaySummaryResults()`
+- رسائل خطأ أوضح
+
+### 3. ملفات التشخيص الجديدة
+- `diagnose_summary.py`
+- `test_summary_button.py`
+- `test_summarize.py`
+
+## 🚀 كيفية التحقق من الحل
+
+### 1. تشغيل الخادم:
+```bash
+python recorder_server.py
+```
+
+### 2. تشغيل التشخيص:
+```bash
+python diagnose_summary.py
+```
+
+### 3. اختبار زر التلخيص:
+```bash
+python test_summary_button.py
+```
+
+### 4. اختبار من الواجهة:
+1. افتح `http://localhost:5054`
+2. سجل صوت أو ادخل نص
+3. اضغط زر "🤖 Generate Smart Lecture Summary"
+4. تأكد من ظهور الملخص
+
+## 💡 نصائح للمستقبل
+
+### 1. تجنب تكرار CORS
+- استخدم إعداد CORS واحد فقط
+- لا تضع إعدادات يدوية إضافية
+
+### 2. مراقبة التبعيات
+- تأكد من تثبيت جميع المكتبات المطلوبة
+- استخدم `requirements.txt` محدث
+
+### 3. استخدام أدوات التشخيص
+- شغل `diagnose_summary.py` عند مواجهة مشاكل
+- يوفر تشخيص سريع وشامل
+
+## 🎯 الخلاصة
+
+تم حل مشكلة زر التلخيص بنجاح من خلال:
+1. ✅ إصلاح مشكلة CORS المزدوجة
+2. ✅ تثبيت المكتبات المفقودة  
+3. ✅ تحسين معالجة الأخطاء
+4. ✅ إنشاء أدوات تشخيص شاملة
+
+**النتيجة: زر التلخيص يعمل بشكل مثالي الآن! 🎉**

TECHNICAL_IMPLEMENTATION.md

@@ -0,0 +1,299 @@
+# SyncMaster Enhanced - Technical Implementation Summary
+
+## 🎯 Summary of Enhancements
+
+This document outlines the comprehensive improvements made to SyncMaster to support AI-powered translation for international students.
+
+## 🔧 New Components Added
+
+### 1. `translator.py` - AI Translation Engine
+```python
+class AITranslator:
+    - translate_text(text, target_language='ar', source_language='auto')
+    - detect_language(text)
+    - translate_ui_elements(ui_dict, target_language='ar')
+    - batch_translate(texts, target_language='ar')
+```
+
+**Features:**
+- Gemini AI-powered translation
+- Academic content optimization
+- Multi-language support (Arabic, English, French, Spanish)
+- Batch processing capabilities
+- Context-aware translation
+
+### 2. Enhanced `audio_processor.py`
+```python
+class AudioProcessor:
+    - get_word_timestamps_with_translation(audio_file_path, target_language='ar')
+    - batch_translate_transcription(audio_file_path, target_languages)
+    - _create_translated_timestamps(original_timestamps, original_text, translated_text)
+```
+
+**New Features:**
+- Integrated translation with transcription
+- Proportional timestamp mapping for translated text
+- Multi-language processing
+- Enhanced error handling and logging
+
+### 3. Updated `recorder_server.py`
+```python
+@app.route('/record', methods=['POST'])
+def record():
+    # Enhanced with translation parameters:
+    # - target_language
+    # - enable_translation
+    # - comprehensive response with both original and translated text
+
+@app.route('/translate', methods=['POST'])
+def translate_text():
+    # Standalone translation endpoint
+
+@app.route('/languages', methods=['GET'])
+def get_supported_languages():
+    # Get list of supported languages
+
+@app.route('/ui-translations/<language>', methods=['GET'])
+def get_ui_translations(language):
+    # Get UI translations for specific language
+```
+
+### 4. Enhanced `templates/recorder.html`
+**New Features:**
+- Multi-language interface (English/Arabic)
+- RTL support for Arabic
+- Translation toggle controls
+- Target language selection
+- Enhanced visual design
+- Keyboard shortcuts
+- Accessibility improvements
+
+**UI Improvements:**
+- Modern gradient design
+- Responsive layout for mobile devices
+- Real-time language switching
+- Visual feedback for translation status
+- Better error messaging
+
+### 5. Updated `app.py` - Main Application
+**Enhancements:**
+- Language selection in sidebar
+- Translation settings integration
+- Enhanced processing workflow
+- Bilingual interface support
+- Improved user experience flow
+
+## 🌐 Multi-Language Support Implementation
+
+### UI Translation System
+```python
+UI_TRANSLATIONS = {
+    'en': { /* English translations */ },
+    'ar': { /* Arabic translations */ }
+}
+```
+
+### Dynamic Language Switching
+- Client-side language detection
+- Server-side translation API
+- Real-time UI updates
+- RTL text direction support
+
+### Translation Workflow
+1. **Audio Recording** → Record with language preferences
+2. **Transcription** → AI-powered speech-to-text
+3. **Language Detection** → Automatic source language identification
+4. **Translation** → Context-aware AI translation
+5. **Presentation** → Side-by-side original and translated text
+
+## 🚀 API Enhancements
+
+### Recording Endpoint (`/record`)
+**Request Parameters:**
+```json
+{
+    "audio_data": "binary_audio_file",
+    "markers": "[timestamp_array]",
+    "target_language": "ar|en|fr|es",
+    "enable_translation": "true|false"
+}
+```
+
+**Response Format:**
+```json
+{
+    "success": true,
+    "original_text": "Original transcription",
+    "translated_text": "Translated text",
+    "file_path": "path/to/saved/file.json",
+    "markers": [timestamps],
+    "target_language": "ar",
+    "translation_enabled": true,
+    "translation_success": true,
+    "language_detected": "en"
+}
+```
+
+### Translation Endpoint (`/translate`)
+**Request:**
+```json
+{
+    "text": "Text to translate",
+    "target_language": "ar",
+    "source_language": "auto"
+}
+```
+
+**Response:**
+```json
+{
+    "success": true,
+    "original_text": "Original text",
+    "translated_text": "النص المترجم",
+    "source_language": "en",
+    "target_language": "ar"
+}
+```
+
+## 📱 Frontend Enhancements
+
+### JavaScript Features
+```javascript
+// Language Management
+async function loadTranslations(language)
+function applyTranslations()
+function changeLanguage()
+
+// Enhanced Recording
+function displayResults(result)
+function displayMarkers(markers)
+function showMessage(message, type)
+
+// Keyboard Shortcuts
+document.addEventListener('keydown', handleKeyboardShortcuts)
+```
+
+### CSS Improvements
+```css
+/* RTL Support */
+html[dir="rtl"] { direction: rtl; }
+
+/* Modern Design */
+:root {
+    --primary-color: #4A90E2;
+    --success-color: #50C878;
+    /* ... more color variables */
+}
+
+/* Responsive Design */
+@media (max-width: 768px) {
+    /* Mobile optimizations */
+}
+```
+
+## 🔒 Security & Performance
+
+### Security Measures
+- Input validation for all API endpoints
+- CORS configuration for cross-origin requests
+- Secure file handling with temporary files
+- API key protection in environment variables
+
+### Performance Optimizations
+- Parallel processing for audio and translation
+- Efficient memory management
+- Chunked audio processing
+- Client-side caching for translations
+
+## 📊 File Structure Changes
+
+```
+SyncMaster - Copy (2)/
+├── translator.py              # NEW: AI Translation engine
+├── audio_processor.py         # ENHANCED: With translation support
+├── recorder_server.py         # ENHANCED: Additional endpoints
+├── app.py                    # ENHANCED: Multi-language support
+├── templates/
+│   └── recorder.html         # ENHANCED: Multi-language UI
+├── README_AR.md              # NEW: Arabic documentation
+├── setup_enhanced.py         # NEW: Enhanced setup script
+├── start_enhanced.bat        # NEW: Quick start script
+├── requirements.txt          # UPDATED: Additional dependencies
+└── .env                      # UPDATED: Additional configuration
+```
+
+## 🎓 Educational Features
+
+### For International Students
+1. **Language Barrier Reduction**: Real-time translation of lectures
+2. **Better Comprehension**: Side-by-side original and translated text
+3. **Cultural Adaptation**: Interface in native language
+4. **Academic Context**: Specialized translation for educational content
+
+### For Arabic Students
+1. **Native Interface**: Complete Arabic UI
+2. **Technical Term Translation**: English technical terms with Arabic explanations
+3. **Reading Direction**: Proper RTL text display
+4. **Cultural Context**: Academic content adapted for Arabic speakers
+
+## 🔧 Installation & Setup
+
+### Enhanced Setup Process
+1. **Automated Installation**: `python setup_enhanced.py`
+2. **Dependency Management**: Automatic package installation
+3. **Configuration Validation**: Environment file checking
+4. **Service Management**: Automatic server startup
+
+### Quick Start Options
+- **Windows**: `start_enhanced.bat`
+- **Cross-platform**: `python setup_enhanced.py`
+- **Manual**: Individual component startup
+
+## 📈 Testing & Quality Assurance
+
+### Translation Quality
+- Academic content optimization
+- Technical term preservation
+- Context-aware translation
+- Fallback mechanisms
+
+### User Experience Testing
+- Multi-language interface testing
+- Mobile responsiveness
+- Accessibility compliance
+- Performance optimization
+
+## 🔮 Future Enhancements
+
+### Planned Features
+1. **Advanced Translation**: Subject-specific terminology
+2. **Collaboration Tools**: Shared study sessions
+3. **Learning Analytics**: Progress tracking
+4. **Platform Integration**: LMS connectivity
+5. **Offline Support**: Local processing capabilities
+
+### Technical Roadmap
+1. **Model Optimization**: Faster processing
+2. **Caching System**: Reduced API calls
+3. **Advanced UI**: More interactive features
+4. **Mobile App**: Native mobile application
+
+---
+
+## 📞 Technical Support
+
+### Debugging Features
+- Comprehensive logging system
+- Browser console integration
+- Error message localization
+- Performance monitoring
+
+### Troubleshooting Resources
+- Detailed error messages
+- Multi-language support documentation
+- Community forum integration
+- Technical FAQ
+
+---
+
+**This enhanced version of SyncMaster represents a significant advancement in making educational technology accessible to international students worldwide.**

TROUBLESHOOTING.md

@@ -0,0 +1,251 @@
+# 🛠️ دليل استكشاف الأخطاء - SyncMaster Enhanced
+# Troubleshooting Guide - SyncMaster Enhanced
+
+## 🔍 الأخطاء الشائعة وحلولها / Common Errors and Solutions
+
+### 1. خطأ الاتصال بالخادم / Server Connection Error
+```
+Error: Failed to fetch
+POST http://localhost:5001/record net::ERR_CONNECTION_REFUSED
+```
+
+**الأسباب المحتملة / Possible Causes:**
+- الخادم غير يعمل / Server not running
+- منفذ 5001 مستخدم من برنامج آخر / Port 5001 used by another application
+- جدار حماية يحجب الاتصال / Firewall blocking connection
+
+**الحلول / Solutions:**
+
+#### أ) تشغيل اختبار النظام / Run System Test:
+```bash
+python test_system.py
+```
+
+#### ب) تشغيل الخادم يدوياً / Start Server Manually:
+```bash
+# إيقاف جميع العمليات / Stop all processes
+taskkill /f /im python.exe
+
+# تشغيل الخادم / Start server
+python recorder_server.py
+```
+
+#### ج) استخدام البدء المتقدم / Use Debug Startup:
+```bash
+python start_debug.py
+```
+
+#### د) فحص المنافذ / Check Ports:
+```bash
+# Windows
+netstat -an | findstr :5001
+
+# Linux/Mac
+lsof -i :5001
+```
+
+### 2. مشكلة مفتاح API / API Key Issues
+```
+ERROR: GEMINI_API_KEY not found in environment variables
+```
+
+**الحل / Solution:**
+1. تأكد من وجود ملف `.env`:
+```bash
+# إنشاء ملف .env / Create .env file
+echo GEMINI_API_KEY=your_actual_api_key_here > .env
+```
+
+2. احصل على مفتاح API من:
+   - [Google AI Studio](https://makersuite.google.com/app/apikey)
+
+3. أضف المفتاح إلى `.env`:
+```
+GEMINI_API_KEY=AIzaSyAS7JtrXjlNjyuo3RG5z6rkwocCwFy1YuA
+```
+
+### 3. مشاكل الصوت / Audio Issues
+```
+UserWarning: PySoundFile failed. Trying audioread instead.
+```
+
+**الحلول / Solutions:**
+
+#### أ) تثبيت SoundFile مرة أخرى / Reinstall SoundFile:
+```bash
+pip uninstall soundfile
+pip install soundfile
+```
+
+#### ب) تثبيت FFmpeg (إذا لزم الأمر) / Install FFmpeg if needed:
+```bash
+# Windows (using chocolatey)
+choco install ffmpeg
+
+# Or download from: https://ffmpeg.org/download.html
+```
+
+#### ج) فحص تنسيق الملف / Check Audio Format:
+- استخدم WAV بدلاً من MP3
+- تأكد من جودة التسجيل
+
+### 4. مشاكل الترجمة / Translation Issues
+```
+WARNING: Gemini returned empty translation response
+```
+
+**الحلول / Solutions:**
+
+#### أ) فحص اتصال الإنترنت / Check Internet Connection:
+```bash
+ping google.com
+```
+
+#### ب) اختبار مفتاح API / Test API Key:
+```python
+python test_system.py
+```
+
+#### ج) تغيير النموذج / Change Model:
+- إذا فشل `gemini-2.5-flash`، جرب `gemini-1.5-flash`
+
+### 5. مشاكل الواجهة / UI Issues
+
+#### أ) الواجهة لا تحمّل / Interface Won't Load:
+```bash
+# تحقق من المنفذ / Check port
+python -c "import socket; s=socket.socket(); s.bind(('',8501)); print('Port 8501 available')"
+
+# تشغيل على منفذ مختلف / Run on different port
+streamlit run app.py --server.port 8502
+```
+
+#### ب) مشاكل اللغة العربية / Arabic Language Issues:
+- تأكد من دعم المتصفح للـ RTL
+- استخدم Chrome أو Firefox للأفضل
+
+### 6. مشاكل الأداء / Performance Issues
+
+#### أ) بطء في المعالجة / Slow Processing:
+- تحقق من سرعة الإنترنت
+- قلل حجم الملف الصوتي
+- استخدم جودة أقل للتسجيل
+
+#### ب) استهلاك ذاكرة عالي / High Memory Usage:
+```bash
+# إعادة تشغيل النظام / Restart system
+python start_debug.py
+```
+
+## 🔧 أدوات التشخيص / Diagnostic Tools
+
+### 1. اختبار شامل / Complete Test:
+```bash
+python test_system.py
+```
+
+### 2. فحص المنافذ / Port Check:
+```python
+python -c "
+import socket
+ports = [5001, 8501, 8502]
+for port in ports:
+    try:
+        s = socket.socket()
+        s.bind(('localhost', port))
+        s.close()
+        print(f'Port {port}: Available ✅')
+    except:
+        print(f'Port {port}: Busy ❌')
+"
+```
+
+### 3. فحص التبعيات / Dependencies Check:
+```bash
+pip list | grep -E "(streamlit|flask|librosa|soundfile|google-generativeai)"
+```
+
+### 4. فحص العمليات / Process Check:
+```bash
+# Windows
+tasklist | findstr python
+
+# Linux/Mac
+ps aux | grep python
+```
+
+## 📱 نصائح لحل المشاكل / Troubleshooting Tips
+
+### للطلاب الجدد / For New Users:
+1. **ابدأ بالاختبار الشامل / Start with system test**:
+   ```bash
+   python test_system.py
+   ```
+
+2. **استخدم البدء المتقدم / Use debug startup**:
+   ```bash
+   python start_debug.py
+   ```
+
+3. **تحقق من المتطلبات / Check requirements**:
+   - Python 3.8+
+   - مفتاح Gemini API صالح
+   - اتصال إنترنت مستقر
+
+### للطلاب المتقدمين / For Advanced Users:
+1. **مراجعة السجلات / Check logs**:
+   - افتح console المتصفح (F12)
+   - راجع سجلات الطرفية
+
+2. **تخصيص الإعدادات / Customize settings**:
+   - غير المنافذ في حالة التضارب
+   - عدّل إعدادات الصوت
+
+3. **التشخيص المتقدم / Advanced diagnostics**:
+   ```python
+   # اختبار الاتصال / Test connection
+   import requests
+   response = requests.get('http://localhost:5001/record')
+   print(response.status_code, response.text)
+   ```
+
+## 🆘 طلب المساعدة / Getting Help
+
+### معلومات مطلوبة / Required Information:
+1. نظام التشغيل / Operating System
+2. إصدار Python / Python Version
+3. نتائج `python test_system.py`
+4. رسائل الخطأ الكاملة / Complete error messages
+5. سجلات الطرفية / Terminal logs
+
+### خطوات الإبلاغ / Reporting Steps:
+1. شغّل الاختبار الشامل
+2. احفظ النتائج
+3. صوّر رسائل الخطأ
+4. اذكر الخطوات التي أدت للمشكلة
+
+---
+
+## 🎯 Quick Fix Commands / أوامر الإصلاح السريع
+
+```bash
+# إعادة تعيين كامل / Complete Reset
+taskkill /f /im python.exe
+python test_system.py
+python start_debug.py
+
+# إصلاح التبعيات / Fix Dependencies  
+pip install --upgrade -r requirements.txt
+
+# إصلاح المنافذ / Fix Ports
+python start_debug.py
+
+# اختبار الترجمة / Test Translation
+python -c "from translator import AITranslator; t=AITranslator(); print(t.translate_text('Hello', 'ar'))"
+```
+
+---
+
+**تذكر: معظم المشاكل تُحل بإعادة تشغيل النظام وتشغيل الاختبار الشامل! 🔄**
+
+**Remember: Most issues are solved by restarting and running the system test! 🔄**

app.py

@@ -0,0 +1,528 @@
+# app.py - Final, Corrected, and Heavily Logged Version
+
+import streamlit as st
+import os
+import tempfile
+import json
+from pathlib import Path
+import time
+import traceback
+import streamlit.components.v1 as components
+
+# --- Integrated Server Import ---
+import threading
+
+# Global variable to track server status
+recorder_server_status = {"started": False, "error": None}
+
+def start_recorder_async():
+    """Start recorder server in background thread"""
+    try:
+        from integrated_server import ensure_recorder_server, stop_all_servers
+        result = ensure_recorder_server()
+        recorder_server_status["started"] = result
+        # Make stop_all_servers available globally
+        globals()['stop_all_servers'] = stop_all_servers
+    except Exception as e:
+        recorder_server_status["error"] = str(e)
+        print(f"Warning: Could not start integrated recorder server: {e}")
+
+# Start recorder server in background to avoid blocking UI
+recorder_thread = threading.Thread(target=start_recorder_async, daemon=True)
+recorder_thread.start()
+
+# --- Critical Imports and Initial Checks ---
+AUDIO_PROCESSOR_CLASS = None
+IMPORT_ERROR_TRACEBACK = None
+try:
+    from audio_processor import AudioProcessor
+    AUDIO_PROCESSOR_CLASS = AudioProcessor
+except Exception:
+    IMPORT_ERROR_TRACEBACK = traceback.format_exc()
+
+from video_generator import VideoGenerator
+from mp3_embedder import MP3Embedder
+from utils import format_timestamp, validate_audio_file, get_audio_info
+from translator import get_translator, get_translation, UI_TRANSLATIONS
+
+# --- Page Configuration ---
+st.set_page_config(
+    page_title="SyncMaster - AI Audio-Text Synchronization",
+    page_icon="🎵",
+    layout="wide"
+)
+
+# --- Browser Console Logging Utility ---
+def log_to_browser_console(messages):
+    """Injects JavaScript to log messages to the browser's console."""
+    if isinstance(messages, str):
+        messages = [messages]
+    escaped_messages = [json.dumps(str(msg)) for msg in messages]
+    js_code = f"""
+    <script>
+    (function() {{
+        const logs = [{', '.join(escaped_messages)}];
+        console.group("Backend Logs from SyncMaster");
+        logs.forEach(log => {{
+            const content = String(log);
+            if (content.includes('--- ERROR') || content.includes('--- FATAL')) {{
+                console.error(log);
+            }} else if (content.includes('--- WARNING')) {{
+                console.warn(log);
+            }} else if (content.includes('--- DEBUG')) {{
+                console.debug(log);
+            }} else {{
+                console.log(log);
+            }}
+        }});
+        console.groupEnd();
+    }})();
+    </script>
+    """
+    components.html(js_code, height=0, scrolling=False)
+
+# --- Session State Initialization ---
+def initialize_session_state():
+    """Initializes the session state variables if they don't exist."""
+    if 'step' not in st.session_state:
+        st.session_state.step = 1
+    if 'audio_file' not in st.session_state:
+        st.session_state.audio_file = None
+    if 'language' not in st.session_state:
+        st.session_state.language = 'en'
+    if 'enable_translation' not in st.session_state:
+        st.session_state.enable_translation = True
+    if 'target_language' not in st.session_state:
+        st.session_state.target_language = 'ar'
+    if 'transcription_data' not in st.session_state:
+        st.session_state.transcription_data = None
+    if 'edited_text' not in st.session_state:
+        st.session_state.edited_text = ""
+    if 'video_style' not in st.session_state:
+        st.session_state.video_style = {
+            'animation_style': 'Karaoke Style', 'text_color': '#FFFFFF',
+            'highlight_color': '#FFD700', 'background_color': '#000000',
+            'font_family': 'Arial', 'font_size': 48
+        }
+
+# --- Main Application Logic ---
+def main():
+    initialize_session_state()
+    
+    # Apply fast loading optimizations
+    st.markdown("""
+    <style>
+    .stSpinner { display: none !important; }
+    .main .block-container { animation: fadeIn 0.2s ease-in-out; }
+    @keyframes fadeIn { from { opacity: 0; } to { opacity: 1; } }
+    .block-container { padding-top: 1rem; }
+    </style>
+    """, unsafe_allow_html=True)
+    
+    # Check recorder server status (non-blocking)
+    if recorder_server_status.get("error"):
+        st.warning(f"⚠️ Recorder server issue: {recorder_server_status['error']}")
+    
+    # Language Selection in sidebar
+    with st.sidebar:
+        st.markdown("## 🌐 Language Settings")
+        language_options = {'English': 'en', 'العربية': 'ar'}
+        selected_lang_display = st.selectbox(
+            "Interface Language",
+            options=list(language_options.keys()),
+            index=0 if st.session_state.language == 'en' else 1
+        )
+        st.session_state.language = language_options[selected_lang_display]
+        
+        # Translation Settings
+        st.markdown("## 🔤 Translation Settings")
+        st.session_state.enable_translation = st.checkbox(
+            "Enable AI Translation" if st.session_state.language == 'en' else "تفعيل الترجمة بالذكاء الاصطناعي",
+            value=st.session_state.enable_translation,
+            help="Automatically translate transcribed text" if st.session_state.language == 'en' else "ترجمة النص تلقائياً"
+        )
+        
+        if st.session_state.enable_translation:
+            target_lang_options = {
+                'Arabic (العربية)': 'ar',
+                'English': 'en', 
+                'French (Français)': 'fr',
+                'Spanish (Español)': 'es'
+            }
+            selected_target = st.selectbox(
+                "Target Language" if st.session_state.language == 'en' else "اللغة المستهدفة",
+                options=list(target_lang_options.keys()),
+                index=0
+            )
+            st.session_state.target_language = target_lang_options[selected_target]
+    
+    # Get translations for current language
+    current_translations = UI_TRANSLATIONS.get(st.session_state.language, UI_TRANSLATIONS['en'])
+    
+    # Main title with translation support
+    st.title("🎵 SyncMaster")
+    if st.session_state.language == 'ar':
+        st.markdown("### منصة المزامنة الذكية بين الصوت والنص")
+        st.markdown("حول ملفاتك الصوتية إلى ملفات MP3 متوافقة مع الأجهزة المحمولة مع كلمات متزامنة ومقاطع فيديو MP4 متحركة.")
+    else:
+        st.markdown("### The Intelligent Audio-Text Synchronization Platform")
+        st.markdown("Transform your audio files into mobile-compatible MP3s with synchronized lyrics and animated MP4 videos.")
+    
+    col1, col2, col3 = st.columns(3)
+    
+    with col1:
+        if st.session_state.step >= 1:
+            st.success("Step 1: Upload & Process")
+        else:
+            st.info("Step 1: Upload & Process")
+    with col2:
+        if st.session_state.step >= 2:
+            st.success("Step 2: Review & Customize")
+        else:
+            st.info("Step 2: Review & Customize")
+    with col3:
+        if st.session_state.step >= 3:
+            st.success("Step 3: Export")
+        else:
+            st.info("Step 3: Export")
+            
+    st.divider()
+
+    if AUDIO_PROCESSOR_CLASS is None:
+        st.error("Fatal Error: The application could not start correctly.")
+        st.subheader("An error occurred while trying to import `AudioProcessor`:")
+        st.code(IMPORT_ERROR_TRACEBACK, language="python")
+        st.stop()
+    
+    if st.session_state.step == 1:
+        step_1_upload_and_process()
+    elif st.session_state.step == 2:
+        step_2_review_and_customize()
+    elif st.session_state.step == 3:
+        step_3_export()
+
+# --- Step 1: Upload and Process ---
+def step_1_upload_and_process():
+    st.header("Step 1: Choose Your Audio Source")
+    
+    upload_tab, record_tab = st.tabs(["📤 Upload a File", "🎙️ Record Audio"])
+
+    with upload_tab:
+        st.subheader("Upload an existing audio file")
+        uploaded_file = st.file_uploader("Choose an audio file", type=['mp3', 'wav', 'm4a'], help="Supported formats: MP3, WAV, M4A")
+        if uploaded_file:
+            st.session_state.audio_file = uploaded_file
+            st.success(f"File uploaded: {uploaded_file.name}")
+            st.audio(uploaded_file)
+            if st.button("🚀 Start AI Processing", type="primary", use_container_width=True):
+                process_audio()
+        if st.session_state.audio_file:
+            if st.button("🔄 Upload Different File"):
+                reset_session()
+                st.rerun()
+
+    with record_tab:
+        st.subheader("Record audio directly from your microphone")
+        st.info("Use the recorder below. After processing, copy the resulting file path and paste it here.")
+        
+        # Show the recorder component
+        show_recorder_page()
+        
+        st.divider()
+
+        # Input for the file path
+        result_file_path = st.text_input("Paste the result file path here:")
+
+        if st.button("Process Recorded Audio", use_container_width=True):
+            if result_file_path and os.path.exists(result_file_path):
+                process_recorded_audio(result_file_path)
+            else:
+                st.error("Please provide a valid file path.")
+
+def show_recorder_page():
+    """Renders the HTML for the recorder page."""
+    try:
+        with open('templates/recorder.html', 'r', encoding='utf-8') as f:
+            html_string = f.read()
+        components.html(html_string, height=650, scrolling=True)
+    except FileNotFoundError:
+        st.error("Could not find the recorder HTML file. Please ensure 'templates/recorder.html' exists.")
+
+def process_recorded_audio(file_path):
+    """Processes the audio data from the recorded file."""
+    log_to_browser_console("--- INFO: Starting recorded audio processing. ---")
+    try:
+        with open(file_path, 'r') as f:
+            data = json.load(f)
+        log_to_browser_console(f"--- DEBUG: Loaded data from {file_path}. ---")
+
+        # Convert hex back to bytes
+        data['audio_bytes'] = bytes.fromhex(data['audio_bytes'])
+        log_to_browser_console("--- DEBUG: Converted hex audio data to bytes. ---")
+
+        st.session_state.transcription_data = data
+        st.session_state.edited_text = data['text']
+        st.session_state.step = 2
+        st.success("🎉 Recording processed successfully! Please review the results.")
+        log_to_browser_console("--- SUCCESS: Recording processed and session updated. ---")
+        
+    except Exception as e:
+        st.error(f"An error occurred while processing the recorded audio: {e}")
+        log_to_browser_console(f"--- FATAL ERROR in process_recorded_audio: {traceback.format_exc()} ---")
+    finally:
+        if os.path.exists(file_path):
+            os.unlink(file_path)
+            log_to_browser_console(f"--- DEBUG: Cleaned up temp file: {file_path}")
+    
+    time.sleep(1)
+    st.rerun()
+
+def process_audio():
+    if not st.session_state.audio_file:
+        st.error("No audio file found.")
+        return
+    
+    tmp_file_path = None
+    log_to_browser_console("--- INFO: Starting enhanced audio processing with translation. ---")
+    try:
+        with tempfile.NamedTemporaryFile(delete=False, suffix=Path(st.session_state.audio_file.name).suffix) as tmp_file:
+            st.session_state.audio_file.seek(0)
+            tmp_file.write(st.session_state.audio_file.getvalue())
+            tmp_file_path = tmp_file.name
+        
+        processor = AUDIO_PROCESSOR_CLASS()
+
+        # Enhanced processing with translation support
+        if st.session_state.enable_translation:
+            with st.spinner("🎤 Performing AI processing (Transcription, Timestamps & Translation)..."):
+                result_data, processor_logs = processor.get_word_timestamps_with_translation(
+                    tmp_file_path, 
+                    st.session_state.target_language
+                )
+            
+            log_to_browser_console(processor_logs)
+            
+            if not result_data or not result_data.get('original_text'):
+                st.warning("Could not generate transcription with translation. Check the browser console (F12) for detailed error logs.")
+                return
+            
+            # Store enhanced results
+            word_timestamps = result_data['word_timestamps']
+            full_text = result_data['original_text']
+            translated_text = result_data['translated_text']
+            translation_success = result_data.get('translation_success', False)
+            detected_language = result_data.get('language_detected', 'unknown')
+            
+            # Show translation results
+            if translation_success and translated_text != full_text:
+                st.success(f"🌐 Translation completed successfully! Detected language: {detected_language}")
+                
+                col1, col2 = st.columns(2)
+                with col1:
+                    st.subheader("Original Text")
+                    st.text_area("Original Transcription", value=full_text, height=150, disabled=True)
+                
+                with col2:
+                    st.subheader(f"Translation ({st.session_state.target_language.upper()})")
+                    st.text_area("Translated Text", value=translated_text, height=150, disabled=True)
+                
+                # Store both versions
+                st.session_state.translated_text = translated_text
+                st.session_state.translation_success = True
+            else:
+                st.info("Translation was requested but may not have been successful.")
+                st.session_state.translation_success = False
+        
+        else:
+            # Standard processing without translation
+            with st.spinner("🎤 Performing AI processing (Transcription & Timestamps)..."):
+                word_timestamps, processor_logs = processor.get_word_timestamps(tmp_file_path)
+            
+            log_to_browser_console(processor_logs)
+            
+            if not word_timestamps:
+                st.warning("Could not generate timestamps. Check the browser console (F12) for detailed error logs.")
+                return
+            
+            full_text = " ".join([d['word'] for d in word_timestamps])
+            st.session_state.translation_success = False
+
+        st.session_state.audio_file.seek(0)
+        audio_bytes = st.session_state.audio_file.read()
+
+        st.session_state.transcription_data = {
+            'text': full_text, # Use the text we derived
+            'word_timestamps': word_timestamps,
+            'audio_bytes': audio_bytes,
+            'original_suffix': Path(st.session_state.audio_file.name).suffix
+        }
+        st.session_state.edited_text = full_text
+        st.session_state.step = 2
+        st.success("🎉 AI processing complete! Please review the results.")
+        
+    except Exception as e:
+        st.error("An unexpected error occurred in the main processing flow!")
+        st.exception(e)
+        log_to_browser_console(f"--- FATAL ERROR in app.py's process_audio: {traceback.format_exc()} ---")
+    finally:
+        if tmp_file_path and os.path.exists(tmp_file_path):
+            os.unlink(tmp_file_path)
+
+    time.sleep(1)
+    st.rerun()
+
+
+
+# --- Step 2: Review and Customize ---
+def step_2_review_and_customize():
+    st.header("Step 2: Review & Customize")
+    if 'transcription_data' not in st.session_state or not st.session_state.transcription_data:
+        st.error("No data found. Please return to Step 1.")
+        if st.button("← Back to Step 1"):
+            st.session_state.step = 1; st.rerun()
+        return
+    col1, col2 = st.columns([3, 2])
+    with col1:
+        st.subheader("📝 Text Editor")
+        edited_text = st.text_area("Transcribed Text", value=st.session_state.edited_text, height=300)
+        st.session_state.edited_text = edited_text
+    with col2:
+        st.subheader("🎨 Video Style Customization")
+        st.session_state.video_style['animation_style'] = st.selectbox("Animation Style", ["Karaoke Style", "Pop-up Word"])
+        st.session_state.video_style['text_color'] = st.color_picker("Text Color", st.session_state.video_style['text_color'])
+        st.session_state.video_style['highlight_color'] = st.color_picker("Highlight Color", st.session_state.video_style['highlight_color'])
+    
+    col1_nav, _, col3_nav = st.columns([1, 2, 1])
+    with col1_nav:
+        if st.button("← Back to Upload"):
+            st.session_state.step = 1; st.rerun()
+    with col3_nav:
+        if st.button("Continue to Export →", type="primary"):
+            st.session_state.step = 3; st.rerun()
+
+# --- Step 3: Export ---
+def step_3_export():
+    st.header("Step 3: Export Your Synchronized Media")
+    if 'transcription_data' not in st.session_state or not st.session_state.transcription_data:
+        st.error("No data found. Please return to Step 1.")
+        if st.button("← Back to Step 1"):
+            st.session_state.step = 1; st.rerun()
+        return
+        
+    col1, col2 = st.columns(2)
+    with col1:
+        st.subheader("🎵 MP3 Export")
+        if st.button("📱 Export MP3 with Lyrics", type="primary", use_container_width=True):
+            export_mp3()
+    with col2:
+        st.subheader("🎬 MP4 Video Export")
+        if st.button("🎥 Generate Video Summary", type="primary", use_container_width=True):
+            export_mp4()
+    st.divider()
+    col1_nav, col2_nav, _ = st.columns([1, 1, 3])
+    with col1_nav:
+        if st.button("← Back to Customize"):
+            st.session_state.step = 2; st.rerun()
+    with col2_nav:
+        if st.button("🔄 Start Over"):
+            reset_session(); st.rerun()
+
+# --- MP3 Export Function (with robust stateless logic and logging) ---
+def export_mp3():
+    audio_path_for_export = None
+    log_to_browser_console("--- INFO: Starting MP3 export process. ---")
+    try:
+        with st.spinner("Embedding lyrics..."):
+            suffix = st.session_state.transcription_data['original_suffix']
+            audio_bytes = st.session_state.transcription_data['audio_bytes']
+            log_to_browser_console(f"--- DEBUG: Retrieved {len(audio_bytes) / 1024:.2f} KB of audio data from session_state.")
+
+            with tempfile.NamedTemporaryFile(delete=False, suffix=suffix) as tmp_audio_file:
+                tmp_audio_file.write(audio_bytes)
+                audio_path_for_export = tmp_audio_file.name
+            log_to_browser_console(f"--- DEBUG: Temp file for export created at: {audio_path_for_export}")
+
+            embedder = MP3Embedder()
+            word_timestamps = st.session_state.transcription_data['word_timestamps']
+            log_to_browser_console(f"--- DEBUG: Passing {len(word_timestamps)} timestamps to embedder.")
+            
+            output_filename = f"synced_{Path(st.session_state.audio_file.name).stem}.mp3"
+            
+            output_path, log_messages = embedder.embed_sylt_lyrics(
+                audio_path_for_export, word_timestamps, 
+                st.session_state.edited_text, output_filename
+            )
+            log_to_browser_console(log_messages)
+
+        st.subheader("✅ Export Complete")
+        if os.path.exists(output_path):
+            with open(output_path, 'rb') as f:
+                audio_bytes_to_download = f.read()
+            st.audio(audio_bytes_to_download, format='audio/mp3')
+
+            verification = embedder.verify_sylt_embedding(output_path)
+            log_to_browser_console(f"--- DEBUG: Verification result: {json.dumps(verification)}")
+            st.json(verification)
+            
+            if verification.get('has_sylt'):
+                st.success(f"Successfully embedded {verification.get('sylt_entries', 0)} words!")
+            else:
+                st.warning("Warning: Could not verify SYLT embedding.")
+            
+            st.download_button("Download Synced MP3", audio_bytes_to_download,
+                               output_filename, "audio/mpeg", use_container_width=True)
+        else:
+            st.error("Failed to create the final MP3 file.")
+            log_to_browser_console(f"--- ERROR: Final output file not found at expected path: {output_path}")
+            
+    except Exception as e:
+        st.error(f"An unexpected error occurred during MP3 export: {e}")
+        log_to_browser_console(f"--- FATAL ERROR in export_mp3: {traceback.format_exc()} ---")
+    finally:
+        if audio_path_for_export and os.path.exists(audio_path_for_export):
+            os.unlink(audio_path_for_export)
+            log_to_browser_console(f"--- DEBUG: Cleaned up temp export file: {audio_path_for_export}")
+
+# --- Placeholder and Utility Functions ---
+def export_mp4():
+    st.info("MP4 export functionality is not yet implemented.")
+
+def reset_session():
+    """Resets the session state by clearing specific keys and re-initializing."""
+    log_to_browser_console("--- INFO: Resetting session state. ---")
+    keys_to_clear = ['step', 'audio_file', 'transcription_data', 'edited_text', 'video_style']
+    for key in keys_to_clear:
+        if key in st.session_state:
+            del st.session_state[key]
+    initialize_session_state()
+
+# --- Entry Point ---
+if __name__ == "__main__":
+    # Compatibility Patches for older Streamlit versions
+    import inspect as _st_inspect
+    if "type" not in _st_inspect.signature(st.button).parameters:
+        _orig_button = st.button
+        def _patched_button(label, *args, **kwargs):
+            kwargs.pop("type", None); kwargs.pop("use_container_width", None)
+            return _orig_button(label, *args, **kwargs)
+        st.button = _patched_button
+    if hasattr(st, "download_button"):
+        import inspect as _dl_inspect
+        _dl_sig = _dl_inspect.signature(st.download_button)
+        if "use_container_width" not in _dl_sig.parameters:
+            _orig_download_button = st.download_button
+            def _patched_download_button(label, data, *args, **kwargs):
+                kwargs.pop("use_container_width", None)
+                return _orig_download_button(label, data, *args, **kwargs)
+            st.download_button = _patched_download_button
+
+    # Setup cleanup handler
+    import atexit
+    try:
+        from integrated_server import stop_all_servers
+        atexit.register(stop_all_servers)
+    except ImportError:
+        pass
+
+    initialize_session_state()
+    main()

app_config.py

@@ -0,0 +1,59 @@
+"""
+Configuration Module for SyncMaster
+إعدادات التطبيق الأساسية
+"""
+
+import os
+import logging
+
+# Configure logging
+logging.basicConfig(level=logging.INFO, format='%(asctime)s - %(levelname)s - %(message)s')
+
+class AppConfig:
+    """Configuration class for SyncMaster application"""
+    
+    # Server settings
+    STREAMLIT_PORT = int(os.getenv('STREAMLIT_PORT', 5050))
+    RECORDER_PORT = int(os.getenv('RECORDER_PORT', 5001))
+    
+    # Development vs Production
+    IS_PRODUCTION = os.getenv('SPACE_ID') is not None or os.getenv('RAILWAY_ENVIRONMENT') is not None
+    
+    # Host settings
+    if IS_PRODUCTION:
+        STREAMLIT_HOST = "0.0.0.0"
+        RECORDER_HOST = "0.0.0.0"
+    else:
+        STREAMLIT_HOST = "localhost"
+        RECORDER_HOST = "localhost"
+    
+    # Integration settings
+    USE_INTEGRATED_SERVER = IS_PRODUCTION or os.getenv('USE_INTEGRATED_SERVER', 'true').lower() == 'true'
+    
+    # Logging
+    LOG_LEVEL = os.getenv('LOG_LEVEL', 'INFO')
+    
+    @classmethod
+    def get_streamlit_url(cls):
+        """Get the Streamlit application URL"""
+        return f"http://{cls.STREAMLIT_HOST}:{cls.STREAMLIT_PORT}"
+    
+    @classmethod
+    def get_recorder_url(cls):
+        """Get the recorder server URL"""
+        return f"http://{cls.RECORDER_HOST}:{cls.RECORDER_PORT}"
+    
+    @classmethod
+    def log_config(cls):
+        """Log current configuration"""
+        logging.info("📋 SyncMaster Configuration:")
+        logging.info(f"   • Production Mode: {cls.IS_PRODUCTION}")
+        logging.info(f"   • Integrated Server: {cls.USE_INTEGRATED_SERVER}")
+        logging.info(f"   • Streamlit: {cls.get_streamlit_url()}")
+        logging.info(f"   • Recorder: {cls.get_recorder_url()}")
+
+# Initialize configuration
+config = AppConfig()
+
+if __name__ == "__main__":
+    config.log_config()

app_launcher.py

@@ -0,0 +1,43 @@
+#!/usr/bin/env python3
+"""
+App Launcher - يشغل التطبيق مع الخادم المدمج
+"""
+
+import os
+import sys
+
+# Add current directory to path
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+
+# Force start integrated server
+print("🚀 Starting integrated recorder server...")
+try:
+    from integrated_server import integrated_server
+    
+    # Force start the server
+    if not integrated_server.is_running:
+        result = integrated_server.start_recorder_server()
+        if result:
+            print("✅ Recorder server started successfully")
+        else:
+            print("⚠️ Warning: Could not start recorder server")
+    else:
+        print("✅ Recorder server already running")
+        
+except Exception as e:
+    print(f"❌ Error starting recorder server: {e}")
+
+print("📱 Loading main application...")
+
+# Execute the app.py content directly
+if __name__ == "__main__":
+    # If running directly, execute app.py
+    exec(open('app.py').read())
+else:
+    # If imported by Streamlit, import and execute
+    try:
+        exec(open('app.py').read())
+        print("✅ Application loaded successfully")
+    except Exception as e:
+        print(f"❌ Error loading application: {e}")
+        raise

audio_processor.py

@@ -0,0 +1,334 @@
+# audio_processor.py - Enhanced with AI Translation Support
+
+import os
+from dotenv import load_dotenv
+import tempfile
+from typing import List, Dict, Optional, Tuple
+import json
+import traceback
+
+# --- DEFINITIVE NUMBA FIX ---
+# This MUST be done BEFORE importing librosa
+os.environ["NUMBA_CACHE_DIR"] = "/tmp"
+
+# Now, import librosa safely
+import librosa
+# --- END OF FIX ---
+
+from google import genai
+from google.genai import types
+from translator import AITranslator
+
+class AudioProcessor:
+    def __init__(self):
+        self.client = None
+        self.translator = None
+        self.init_error = None
+        self._initialize_gemini()
+        self._initialize_translator()
+    
+    def _initialize_gemini(self):
+        try:
+            load_dotenv()
+            api_key = os.getenv("GEMINI_API_KEY")
+            if not api_key:
+                raise ValueError("GEMINI_API_KEY not found in environment variables.")
+            self.client = genai.Client(api_key=api_key)
+        except Exception as e:
+            self.init_error = f"--- FATAL ERROR during Gemini Init: {str(e)} ---"
+            self.client = None
+    
+    def _initialize_translator(self):
+        """Initialize AI translator for multi-language support"""
+        try:
+            self.translator = AITranslator()
+            if self.translator.init_error:
+                print(f"--- WARNING: Translator has initialization error: {self.translator.init_error} ---")
+        except Exception as e:
+            print(f"--- WARNING: Translator initialization failed: {str(e)} ---")
+            self.translator = None
+    
+    def transcribe_audio(self, audio_file_path: str) -> Tuple[Optional[str], Optional[str]]:
+        """
+        Transcribes audio. Returns (text, error_message).
+        """
+        if self.init_error:
+            return None, self.init_error
+        if not self.client:
+            return None, "--- ERROR: Gemini client is not available. ---"
+        
+        try:
+            if not os.path.exists(audio_file_path):
+                return None, f"--- ERROR: Audio file for transcription not found at: {audio_file_path} ---"
+            
+            with open(audio_file_path, 'rb') as f:
+                audio_bytes = f.read()
+            
+            file_ext = os.path.splitext(audio_file_path)[1].lower()
+            mime_type = {'mp3': 'audio/mpeg', 'wav': 'audio/wav', 'm4a': 'audio/mp4'}.get(file_ext, 'audio/mpeg')
+
+            response = self.client.models.generate_content(
+                model="gemini-2.5-flash",
+                contents=[types.Part.from_bytes(data=audio_bytes, mime_type=mime_type), "Transcribe this audio."]
+            )
+            
+            if response and response.text:
+                return response.text.strip(), None
+            else:
+                return None, "--- WARNING: Gemini returned an empty response for transcription. ---"
+                
+        except Exception as e:
+            error_msg = f"--- FATAL ERROR during transcription: {traceback.format_exc()} ---"
+            return None, error_msg
+
+    def get_audio_duration(self, audio_file_path: str) -> Tuple[Optional[float], Optional[str]]:
+        """
+        Gets audio duration. Returns (duration, error_message).
+        """
+        try:
+            if not os.path.exists(audio_file_path):
+                return None, f"--- ERROR: Audio file for duration not found at: {audio_file_path} ---"
+            
+            duration = librosa.get_duration(path=audio_file_path)
+            if duration is None or duration < 0.1:
+                return None, f"--- ERROR: librosa returned an invalid duration: {duration}s ---"
+            return duration, None
+        except Exception as e:
+            error_msg = f"--- FATAL ERROR getting audio duration with librosa: {traceback.format_exc()} ---"
+            return None, error_msg
+    
+    def get_word_timestamps(self, audio_file_path: str) -> Tuple[List[Dict], List[str]]:
+        """
+        Generates timestamps. Returns (timestamps, log_messages).
+        """
+        logs = ["--- INFO: Starting get_word_timestamps... ---"]
+        
+        transcription, error = self.transcribe_audio(audio_file_path)
+        if error:
+            logs.append(error)
+            return [], logs
+        logs.append(f"--- DEBUG: Transcription successful. Text: '{transcription[:50]}...'")
+
+        audio_duration, error = self.get_audio_duration(audio_file_path)
+        if error:
+            logs.append(error)
+            return [], logs
+        logs.append(f"--- DEBUG: Audio duration successful. Duration: {audio_duration:.2f}s")
+        
+        words = transcription.split()
+        if not words:
+            logs.append("--- WARNING: Transcription resulted in zero words. ---")
+            return [], logs
+        
+        logs.append(f"--- INFO: Distributing {len(words)} words across the duration. ---")
+        word_timestamps = []
+        total_words = len(words)
+        usable_duration = max(0, audio_duration - 1.0)
+        
+        for i, word in enumerate(words):
+            start_time = 0.5 + (i * (usable_duration / total_words))
+            end_time = 0.5 + ((i + 1) * (usable_duration / total_words))
+            word_timestamps.append({'word': word.strip(), 'start': round(start_time, 3), 'end': round(end_time, 3)})
+        
+        logs.append(f"--- SUCCESS: Generated {len(word_timestamps)} word timestamps. ---")
+        return word_timestamps, logs
+    
+    def get_word_timestamps_with_translation(self, audio_file_path: str, target_language: str = 'ar') -> Tuple[Dict, List[str]]:
+        """
+        Enhanced function that provides both transcription and translation
+        
+        Args:
+            audio_file_path: Path to audio file
+            target_language: Target language for translation ('ar' for Arabic)
+        
+        Returns:
+            Tuple of (result_dict, log_messages)
+            result_dict contains: {
+                'original_text': str,
+                'translated_text': str,
+                'word_timestamps': List[Dict],
+                'translated_timestamps': List[Dict],
+                'language_detected': str,
+                'target_language': str
+            }
+        """
+        logs = ["--- INFO: Starting enhanced transcription with translation... ---"]
+        
+        # Get original transcription and timestamps
+        word_timestamps, transcription_logs = self.get_word_timestamps(audio_file_path)
+        logs.extend(transcription_logs)
+        
+        if not word_timestamps:
+            logs.append("--- ERROR: No transcription available for translation ---")
+            return {}, logs
+        
+        # Extract original text
+        original_text = " ".join([d['word'] for d in word_timestamps])
+        logs.append(f"--- INFO: Original transcription: '{original_text[:50]}...' ---")
+        
+        # Initialize result dictionary
+        result = {
+            'original_text': original_text,
+            'translated_text': '',
+            'word_timestamps': word_timestamps,
+            'translated_timestamps': [],
+            'language_detected': 'unknown',
+            'target_language': target_language,
+            'translation_success': False
+        }
+        
+        # Check if translator is available
+        if not self.translator:
+            logs.append("--- WARNING: Translator not available, returning original text only ---")
+            result['translated_text'] = original_text
+            return result, logs
+        
+        try:
+            # Detect original language
+            detected_lang, detect_error = self.translator.detect_language(original_text)
+            if detected_lang and detected_lang != 'unknown':
+                result['language_detected'] = detected_lang
+                logs.append(f"--- INFO: Detected language: {detected_lang} ---")
+            else:
+                logs.append(f"--- WARNING: Language detection failed: {detect_error} ---")
+            
+            # Translate the text
+            translated_text, translation_error = self.translator.translate_text(
+                original_text, 
+                target_language=target_language
+            )
+            
+            if translated_text:
+                result['translated_text'] = translated_text
+                result['translation_success'] = True
+                logs.append(f"--- SUCCESS: Translation completed: '{translated_text[:50]}...' ---")
+                
+                # Create translated timestamps by mapping words
+                translated_timestamps = self._create_translated_timestamps(
+                    word_timestamps, 
+                    original_text, 
+                    translated_text
+                )
+                result['translated_timestamps'] = translated_timestamps
+                logs.append(f"--- INFO: Created {len(translated_timestamps)} translated timestamps ---")
+                
+            else:
+                logs.append(f"--- ERROR: Translation failed: {translation_error} ---")
+                result['translated_text'] = original_text  # Fallback to original
+                result['translated_timestamps'] = word_timestamps  # Use original timestamps
+                
+        except Exception as e:
+            error_msg = f"--- FATAL ERROR during translation process: {traceback.format_exc()} ---"
+            logs.append(error_msg)
+            result['translated_text'] = original_text  # Fallback
+            result['translated_timestamps'] = word_timestamps
+        
+        return result, logs
+    
+    def _create_translated_timestamps(self, original_timestamps: List[Dict], original_text: str, translated_text: str) -> List[Dict]:
+        """
+        Create timestamps for translated text by proportional mapping
+        
+        Args:
+            original_timestamps: Original word timestamps
+            original_text: Original transcribed text
+            translated_text: Translated text
+        
+        Returns:
+            List of translated word timestamps
+        """
+        try:
+            translated_words = translated_text.split()
+            if not translated_words:
+                return []
+            
+            # Get total duration from original timestamps
+            if not original_timestamps:
+                return []
+            
+            start_time = original_timestamps[0]['start']
+            end_time = original_timestamps[-1]['end']
+            total_duration = end_time - start_time
+            
+            # Create proportional timestamps for translated words
+            translated_timestamps = []
+            word_count = len(translated_words)
+            
+            for i, word in enumerate(translated_words):
+                # Calculate proportional timing
+                word_start = start_time + (i * total_duration / word_count)
+                word_end = start_time + ((i + 1) * total_duration / word_count)
+                
+                translated_timestamps.append({
+                    'word': word.strip(),
+                    'start': round(word_start, 3),
+                    'end': round(word_end, 3)
+                })
+            
+            return translated_timestamps
+            
+        except Exception as e:
+            print(f"--- ERROR creating translated timestamps: {str(e)} ---")
+            return []
+    
+    def batch_translate_transcription(self, audio_file_path: str, target_languages: List[str]) -> Tuple[Dict, List[str]]:
+        """
+        Transcribe audio and translate to multiple languages
+        
+        Args:
+            audio_file_path: Path to audio file
+            target_languages: List of target language codes
+        
+        Returns:
+            Tuple of (results_dict, log_messages)
+        """
+        logs = ["--- INFO: Starting batch translation process... ---"]
+        
+        # Get original transcription
+        word_timestamps, transcription_logs = self.get_word_timestamps(audio_file_path)
+        logs.extend(transcription_logs)
+        
+        if not word_timestamps:
+            return {}, logs
+        
+        original_text = " ".join([d['word'] for d in word_timestamps])
+        
+        # Initialize results
+        results = {
+            'original': {
+                'text': original_text,
+                'timestamps': word_timestamps,
+                'language': 'detected'
+            },
+            'translations': {}
+        }
+        
+        # Translate to each target language
+        if self.translator:
+            for lang_code in target_languages:
+                try:
+                    translated_text, error = self.translator.translate_text(original_text, lang_code)
+                    if translated_text:
+                        translated_timestamps = self._create_translated_timestamps(
+                            word_timestamps, original_text, translated_text
+                        )
+                        results['translations'][lang_code] = {
+                            'text': translated_text,
+                            'timestamps': translated_timestamps,
+                            'success': True
+                        }
+                        logs.append(f"--- SUCCESS: Translation to {lang_code} completed ---")
+                    else:
+                        results['translations'][lang_code] = {
+                            'text': original_text,
+                            'timestamps': word_timestamps,
+                            'success': False,
+                            'error': error
+                        }
+                        logs.append(f"--- ERROR: Translation to {lang_code} failed: {error} ---")
+                except Exception as e:
+                    logs.append(f"--- FATAL ERROR translating to {lang_code}: {str(e)} ---")
+        else:
+            logs.append("--- WARNING: Translator not available for batch translation ---")
+        
+        return results, logs

comprehensive_test.py

@@ -0,0 +1,225 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+اختبار شامل للتحقق من إصلاح جميع المشاكل
+"""
+
+import requests
+import json
+import time
+
+def test_server_health():
+    """اختبار صحة الخادم"""
+    print("🏥 اختبار صحة الخادم...")
+    
+    try:
+        response = requests.get('http://localhost:5001/record', timeout=5)
+        if response.status_code == 200:
+            data = response.json()
+            print(f"✅ الخادم يعمل: {data.get('message')}")
+            return True
+        else:
+            print(f"❌ مشكلة في الخادم: {response.status_code}")
+            return False
+    except Exception as e:
+        print(f"❌ لا يمكن الوصول للخادم: {e}")
+        return False
+
+def test_cors_headers():
+    """اختبار CORS headers"""
+    print("\n🔧 اختبار CORS headers...")
+    
+    try:
+        # اختبار OPTIONS request
+        response = requests.options('http://localhost:5001/summarize', timeout=5)
+        
+        print(f"Status Code: {response.status_code}")
+        
+        # فحص CORS headers
+        cors_origin = response.headers.get('Access-Control-Allow-Origin')
+        cors_methods = response.headers.get('Access-Control-Allow-Methods')
+        cors_headers = response.headers.get('Access-Control-Allow-Headers')
+        
+        print(f"CORS Origin: '{cors_origin}'")
+        print(f"CORS Methods: '{cors_methods}'")
+        print(f"CORS Headers: '{cors_headers}'")
+        
+        # التحقق من عدم وجود قيم مكررة
+        if cors_origin and ',' in cors_origin and cors_origin.count('*') > 1:
+            print("❌ مشكلة: CORS Origin يحتوي على قيم مكررة!")
+            return False
+        elif cors_origin == '*':
+            print("✅ CORS Origin صحيح")
+            return True
+        else:
+            print(f"⚠️ CORS Origin غير متوقع: {cors_origin}")
+            return False
+            
+    except Exception as e:
+        print(f"❌ خطأ في اختبار CORS: {e}")
+        return False
+
+def test_summarization():
+    """اختبار وظيفة التلخيص"""
+    print("\n🤖 اختبار وظيفة التلخيص...")
+    
+    test_data = {
+        "text": "Hello, how are you? What are you doing today? Tell me about your work and your plans.",
+        "language": "arabic",
+        "type": "full"
+    }
+    
+    try:
+        response = requests.post(
+            'http://localhost:5001/summarize',
+            json=test_data,
+            headers={'Content-Type': 'application/json'},
+            timeout=30
+        )
+        
+        print(f"Status Code: {response.status_code}")
+        
+        if response.status_code == 200:
+            data = response.json()
+            if data.get('success'):
+                print("✅ التلخيص نجح!")
+                summary = data.get('summary', '')
+                print(f"الملخص: {summary[:100]}...")
+                return True
+            else:
+                print(f"❌ فشل التلخيص: {data.get('error')}")
+                return False
+        else:
+            print(f"❌ خطأ HTTP: {response.status_code}")
+            print(f"الرد: {response.text}")
+            return False
+            
+    except Exception as e:
+        print(f"❌ خطأ في اختبار التلخيص: {e}")
+        return False
+
+def test_javascript_syntax():
+    """اختبار صيغة JavaScript"""
+    print("\n📝 اختبار صيغة JavaScript...")
+    
+    try:
+        with open('templates/recorder.html', 'r', encoding='utf-8') as f:
+            content = f.read()
+        
+        # فحص بسيط للأقواس
+        js_start = content.find('<script>')
+        js_end = content.find('</script>')
+        
+        if js_start == -1 or js_end == -1:
+            print("❌ لا يمكن العثور على JavaScript")
+            return False
+        
+        js_content = content[js_start:js_end]
+        
+        # عد الأقواس
+        open_braces = js_content.count('{')
+        close_braces = js_content.count('}')
+        
+        print(f"أقواس فتح: {open_braces}")
+        print(f"أقواس إغلاق: {close_braces}")
+        
+        if open_braces == close_braces:
+            print("✅ الأقواس متوازنة")
+            
+            # فحص للكلمات المفتاحية الأساسية
+            if 'function' in js_content and 'async function' in js_content:
+                print("✅ الدوال موجودة")
+                return True
+            else:
+                print("⚠️ لا يمكن العثور على الدوال")
+                return False
+        else:
+            print(f"❌ الأقواس غير متوازنة! الفرق: {open_braces - close_braces}")
+            return False
+            
+    except Exception as e:
+        print(f"❌ خطأ في فحص JavaScript: {e}")
+        return False
+
+def test_translation_endpoints():
+    """اختبار endpoints الترجمة"""
+    print("\n🌐 اختبار endpoints الترجمة...")
+    
+    try:
+        # اختبار قائمة اللغات
+        response = requests.get('http://localhost:5001/languages', timeout=5)
+        if response.status_code == 200:
+            print("✅ endpoint اللغات يعمل")
+        else:
+            print(f"⚠️ مشكلة في endpoint اللغات: {response.status_code}")
+        
+        # اختبار UI translations
+        response = requests.get('http://localhost:5001/ui-translations/en', timeout=5)
+        if response.status_code == 200:
+            print("✅ endpoint UI translations يعمل")
+        else:
+            print(f"⚠️ مشكلة في endpoint UI translations: {response.status_code}")
+        
+        return True
+        
+    except Exception as e:
+        print(f"❌ خطأ في اختبار endpoints الترجمة: {e}")
+        return False
+
+def comprehensive_test():
+    """اختبار شامل لجميع الوظائف"""
+    print("🚀 بدء الاختبار الشامل")
+    print("=" * 60)
+    
+    tests = [
+        ("صحة الخادم", test_server_health),
+        ("CORS Headers", test_cors_headers),
+        ("وظيفة التلخيص", test_summarization),
+        ("صيغة JavaScript", test_javascript_syntax),
+        ("endpoints الترجمة", test_translation_endpoints)
+    ]
+    
+    results = []
+    
+    for test_name, test_func in tests:
+        print(f"\n🧪 اختبار: {test_name}")
+        print("-" * 40)
+        
+        try:
+            result = test_func()
+            results.append((test_name, result))
+            
+            if result:
+                print(f"✅ {test_name}: نجح")
+            else:
+                print(f"❌ {test_name}: فشل")
+                
+        except Exception as e:
+            print(f"❌ {test_name}: خطأ - {e}")
+            results.append((test_name, False))
+    
+    # النتائج النهائية
+    print("\n" + "=" * 60)
+    print("📊 ملخص نتائج الاختبار:")
+    print("=" * 60)
+    
+    passed = 0
+    total = len(results)
+    
+    for test_name, result in results:
+        status = "✅ نجح" if result else "❌ فشل"
+        print(f"  {test_name}: {status}")
+        if result:
+            passed += 1
+    
+    print(f"\nالنتيجة النهائية: {passed}/{total} اختبارات نجحت")
+    
+    if passed == total:
+        print("🎉 جميع الاختبارات نجحت! النظام يعمل بشكل مثالي")
+        return True
+    else:
+        print(f"⚠️ {total - passed} اختبارات فشلت - هناك مشاكل تحتاج إصلاح")
+        return False
+
+if __name__ == "__main__":
+    comprehensive_test()

database.py

@@ -0,0 +1,231 @@
+# database.py - نظام قاعدة البيانات البسيطة للملاحظات
+
+import sqlite3
+import json
+import os
+from datetime import datetime
+from typing import List, Dict, Optional
+
+class NotesDatabase:
+    """قاعدة بيانات بسيطة لحفظ الملاحظات والملخصات"""
+    
+    def __init__(self, db_path: str = "lecture_notes.db"):
+        self.db_path = db_path
+        self.init_database()
+    
+    def init_database(self):
+        """إنشاء قاعدة البيانات والجداول"""
+        with sqlite3.connect(self.db_path) as conn:
+            cursor = conn.cursor()
+            
+            # جدول الملاحظات الرئيسي
+            cursor.execute('''
+                CREATE TABLE IF NOT EXISTS lecture_notes (
+                    id INTEGER PRIMARY KEY AUTOINCREMENT,
+                    title TEXT NOT NULL,
+                    original_text TEXT NOT NULL,
+                    translated_text TEXT,
+                    summary TEXT,
+                    key_points TEXT,
+                    subject TEXT,
+                    date_created TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+                    date_modified TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+                    audio_file_path TEXT,
+                    language_detected TEXT,
+                    target_language TEXT,
+                    markers TEXT
+                )
+            ''')
+            
+            # جدول الملخصات السريعة
+            cursor.execute('''
+                CREATE TABLE IF NOT EXISTS quick_summaries (
+                    id INTEGER PRIMARY KEY AUTOINCREMENT,
+                    note_id INTEGER,
+                    summary_type TEXT,
+                    content TEXT,
+                    date_created TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+                    FOREIGN KEY (note_id) REFERENCES lecture_notes (id)
+                )
+            ''')
+            
+            conn.commit()
+    
+    def save_lecture_note(self, data: Dict) -> int:
+        """حفظ ملاحظة محاضرة جديدة"""
+        with sqlite3.connect(self.db_path) as conn:
+            cursor = conn.cursor()
+            
+            cursor.execute('''
+                INSERT INTO lecture_notes 
+                (title, original_text, translated_text, summary, key_points, 
+                 subject, audio_file_path, language_detected, target_language, markers)
+                VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+            ''', (
+                data.get('title', 'محاضرة جديدة'),
+                data.get('original_text', ''),
+                data.get('translated_text', ''),
+                data.get('summary', ''),
+                data.get('key_points', ''),
+                data.get('subject', ''),
+                data.get('audio_file_path', ''),
+                data.get('language_detected', ''),
+                data.get('target_language', ''),
+                json.dumps(data.get('markers', []))
+            ))
+            
+            note_id = cursor.lastrowid
+            conn.commit()
+            return note_id
+    
+    def get_all_notes(self, limit: int = 50) -> List[Dict]:
+        """استرجاع جميع الملاحظات"""
+        with sqlite3.connect(self.db_path) as conn:
+            cursor = conn.cursor()
+            
+            cursor.execute('''
+                SELECT * FROM lecture_notes 
+                ORDER BY date_created DESC 
+                LIMIT ?
+            ''', (limit,))
+            
+            columns = [description[0] for description in cursor.description]
+            notes = []
+            
+            for row in cursor.fetchall():
+                note = dict(zip(columns, row))
+                # تحويل markers من JSON string إلى list
+                if note['markers']:
+                    try:
+                        note['markers'] = json.loads(note['markers'])
+                    except:
+                        note['markers'] = []
+                notes.append(note)
+            
+            return notes
+    
+    def get_note_by_id(self, note_id: int) -> Optional[Dict]:
+        """استرجاع ملاحظة محددة بالـ ID"""
+        with sqlite3.connect(self.db_path) as conn:
+            cursor = conn.cursor()
+            
+            cursor.execute('SELECT * FROM lecture_notes WHERE id = ?', (note_id,))
+            row = cursor.fetchone()
+            
+            if row:
+                columns = [description[0] for description in cursor.description]
+                note = dict(zip(columns, row))
+                if note['markers']:
+                    try:
+                        note['markers'] = json.loads(note['markers'])
+                    except:
+                        note['markers'] = []
+                return note
+            
+            return None
+    
+    def update_note(self, note_id: int, data: Dict) -> bool:
+        """تحديث ملاحظة موجودة"""
+        with sqlite3.connect(self.db_path) as conn:
+            cursor = conn.cursor()
+            
+            # بناء query التحديث بناءً على البيانات الموجودة
+            update_fields = []
+            values = []
+            
+            for field in ['title', 'summary', 'key_points', 'subject']:
+                if field in data:
+                    update_fields.append(f"{field} = ?")
+                    values.append(data[field])
+            
+            if not update_fields:
+                return False
+            
+            update_fields.append("date_modified = CURRENT_TIMESTAMP")
+            values.append(note_id)
+            
+            query = f"UPDATE lecture_notes SET {', '.join(update_fields)} WHERE id = ?"
+            
+            cursor.execute(query, values)
+            conn.commit()
+            
+            return cursor.rowcount > 0
+    
+    def delete_note(self, note_id: int) -> bool:
+        """حذف ملاحظة"""
+        with sqlite3.connect(self.db_path) as conn:
+            cursor = conn.cursor()
+            
+            # حذف الملخصات المرتبطة أولاً
+            cursor.execute('DELETE FROM quick_summaries WHERE note_id = ?', (note_id,))
+            
+            # ثم حذف الملاحظة
+            cursor.execute('DELETE FROM lecture_notes WHERE id = ?', (note_id,))
+            
+            conn.commit()
+            return cursor.rowcount > 0
+    
+    def search_notes(self, query: str) -> List[Dict]:
+        """البحث في الملاحظات"""
+        with sqlite3.connect(self.db_path) as conn:
+            cursor = conn.cursor()
+            
+            search_query = f"%{query}%"
+            cursor.execute('''
+                SELECT * FROM lecture_notes 
+                WHERE title LIKE ? OR original_text LIKE ? 
+                OR translated_text LIKE ? OR summary LIKE ?
+                ORDER BY date_created DESC
+            ''', (search_query, search_query, search_query, search_query))
+            
+            columns = [description[0] for description in cursor.description]
+            notes = []
+            
+            for row in cursor.fetchall():
+                note = dict(zip(columns, row))
+                if note['markers']:
+                    try:
+                        note['markers'] = json.loads(note['markers'])
+                    except:
+                        note['markers'] = []
+                notes.append(note)
+            
+            return notes
+    
+    def get_notes_by_subject(self, subject: str) -> List[Dict]:
+        """استرجاع الملاحظات حسب المادة"""
+        with sqlite3.connect(self.db_path) as conn:
+            cursor = conn.cursor()
+            
+            cursor.execute('''
+                SELECT * FROM lecture_notes 
+                WHERE subject = ?
+                ORDER BY date_created DESC
+            ''', (subject,))
+            
+            columns = [description[0] for description in cursor.description]
+            notes = []
+            
+            for row in cursor.fetchall():
+                note = dict(zip(columns, row))
+                if note['markers']:
+                    try:
+                        note['markers'] = json.loads(note['markers'])
+                    except:
+                        note['markers'] = []
+                notes.append(note)
+            
+            return notes
+    
+    def get_subjects(self) -> List[str]:
+        """استرجاع قائمة المواد الدراسية"""
+        with sqlite3.connect(self.db_path) as conn:
+            cursor = conn.cursor()
+            
+            cursor.execute('''
+                SELECT DISTINCT subject FROM lecture_notes 
+                WHERE subject IS NOT NULL AND subject != ''
+                ORDER BY subject
+            ''')
+            
+            return [row[0] for row in cursor.fetchall()]

diagnose_summary.py

@@ -0,0 +1,257 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+ملف تشخيص مشكلة زر التلخيص - معالجة شاملة
+"""
+
+import subprocess
+import sys
+import json
+import requests
+import time
+import os
+
+def check_server_process():
+    """التحقق من عملية الخادم"""
+    print("🔍 البحث عن عملية الخادم...")
+    
+    try:
+        # البحث في العمليات الجارية
+        result = subprocess.run(
+            ['tasklist', '/FI', 'IMAGENAME eq python.exe'],
+            capture_output=True, text=True, shell=True
+        )
+        
+        python_processes = []
+        for line in result.stdout.split('\n'):
+            if 'python.exe' in line:
+                python_processes.append(line.strip())
+        
+        print(f"عدد العمليات Python الجارية: {len(python_processes)}")
+        
+        if python_processes:
+            print("✅ العمليات الموجودة:")
+            for proc in python_processes[:5]:  # أول 5 فقط
+                print(f"  {proc}")
+        
+        return len(python_processes) > 0
+        
+    except Exception as e:
+        print(f"❌ خطأ في فحص العمليات: {e}")
+        return False
+
+def check_port_status():
+    """فحص حالة المنافذ"""
+    print("\n🌐 فحص حالة المنافذ...")
+    
+    ports_to_check = [5001, 5054, 8501]
+    port_status = {}
+    
+    for port in ports_to_check:
+        try:
+            result = subprocess.run(
+                ['netstat', '-an'],
+                capture_output=True, text=True, shell=True
+            )
+            
+            is_listening = f':{port}' in result.stdout and 'LISTENING' in result.stdout
+            port_status[port] = is_listening
+            
+            status_emoji = "✅" if is_listening else "❌"
+            print(f"  {status_emoji} Port {port}: {'LISTENING' if is_listening else 'NOT LISTENING'}")
+            
+        except Exception as e:
+            print(f"  ❌ Port {port}: خطأ في الفحص - {e}")
+            port_status[port] = False
+    
+    return port_status
+
+def test_cors_issue():
+    """اختبار مشكلة CORS"""
+    print("\n🔧 اختبار مشكلة CORS...")
+    
+    try:
+        # طلب OPTIONS
+        response = requests.options(
+            'http://localhost:5001/summarize',
+            timeout=5
+        )
+        
+        print(f"Status Code: {response.status_code}")
+        
+        # فحص CORS headers
+        headers = dict(response.headers)
+        cors_origin = headers.get('Access-Control-Allow-Origin', 'غير موجود')
+        
+        print(f"CORS Origin: '{cors_origin}'")
+        
+        # تحقق من المشكلة
+        if ',' in cors_origin:
+            print("❌ مشكلة CORS: القيمة تحتوي على فواصل متعددة!")
+            print("    هذا يسبب الخطأ: 'multiple values *, *'")
+            return False
+        elif cors_origin == '*':
+            print("✅ CORS header صحيح")
+            return True
+        else:
+            print(f"⚠️ CORS header غير متوقع: {cors_origin}")
+            return False
+            
+    except requests.exceptions.ConnectionError:
+        print("❌ لا يمكن الاتصال بالخادم - الخادم غير مشتغل")
+        return False
+    except Exception as e:
+        print(f"❌ خطأ في اختبار CORS: {e}")
+        return False
+
+def test_summarize_functionality():
+    """اختبار وظيفة التلخيص"""
+    print("\n🤖 اختبار وظيفة التلخيص...")
+    
+    test_data = {
+        "text": "Hello, how are you? What are you doing today? Tell me about your work.",
+        "language": "arabic",
+        "type": "full"
+    }
+    
+    try:
+        response = requests.post(
+            'http://localhost:5001/summarize',
+            json=test_data,
+            headers={'Content-Type': 'application/json'},
+            timeout=30
+        )
+        
+        print(f"Status Code: {response.status_code}")
+        
+        if response.status_code == 200:
+            data = response.json()
+            print(f"Response Keys: {list(data.keys())}")
+            
+            if data.get('success'):
+                print("✅ التلخيص نجح!")
+                print(f"Summary Type: {data.get('type', 'غير محدد')}")
+                
+                if 'summary' in data:
+                    summary_preview = str(data['summary'])[:100] + "..."
+                    print(f"Summary Preview: {summary_preview}")
+                    return True
+                else:
+                    print("⚠️ لا يوجد ملخص في الاستجابة")
+                    return False
+            else:
+                print(f"❌ فشل التلخيص: {data.get('error', 'خطأ غير معروف')}")
+                return False
+        else:
+            error_text = response.text[:200]
+            print(f"❌ خطأ HTTP {response.status_code}: {error_text}")
+            return False
+            
+    except requests.exceptions.Timeout:
+        print("❌ انتهت مهلة الطلب - الخادم بطيء أو لا يستجيب")
+        return False
+    except Exception as e:
+        print(f"❌ خطأ في اختبار التلخيص: {e}")
+        return False
+
+def check_dependencies():
+    """فحص المكتبات المطلوبة"""
+    print("\n📦 فحص المكتبات المطلوبة...")
+    
+    required_packages = [
+        'flask', 'flask-cors', 'requests', 
+        'google-generativeai', 'librosa', 'soundfile'
+    ]
+    
+    missing_packages = []
+    
+    for package in required_packages:
+        try:
+            result = subprocess.run(
+                [sys.executable, '-c', f'import {package.replace("-", "_")}'],
+                capture_output=True, text=True
+            )
+            
+            if result.returncode == 0:
+                print(f"  ✅ {package}")
+            else:
+                print(f"  ❌ {package} - غير مثبت")
+                missing_packages.append(package)
+                
+        except Exception as e:
+            print(f"  ❌ {package} - خطأ في الفحص: {e}")
+            missing_packages.append(package)
+    
+    if missing_packages:
+        print(f"\n⚠️ المكتبات المفقودة: {', '.join(missing_packages)}")
+        print("تشغيل الأمر: pip install " + " ".join(missing_packages))
+        return False
+    else:
+        print("\n✅ جميع المكتبات مثبتة")
+        return True
+
+def restart_server_suggestion():
+    """اقتراحات لإعادة تشغيل الخادم"""
+    print("\n🔄 اقتراحات الإصلاح:")
+    print("1. إيقاف الخادم الحالي (Ctrl+C في التيرمينال)")
+    print("2. تشغيل الخادم مرة أخرى:")
+    print("   python recorder_server.py")
+    print("\n3. أو استخدام ملف البدء:")
+    print("   python start_debug.py")
+    print("\n4. التحقق من تشغيل الخادم:")
+    print("   curl http://localhost:5001/record")
+
+def main():
+    """الدالة الرئيسية للتشخيص"""
+    print("=" * 60)
+    print("🚀 تشخيص شامل لمشكلة زر التلخيص")
+    print("=" * 60)
+    
+    # فحص العمليات
+    has_python_process = check_server_process()
+    
+    # فحص المنافذ
+    port_status = check_port_status()
+    
+    # فحص المكتبات
+    dependencies_ok = check_dependencies()
+    
+    # إذا كان المنفذ مفتوح، اختبر CORS والتلخيص
+    if port_status.get(5001, False):
+        cors_ok = test_cors_issue()
+        if cors_ok:
+            summarize_ok = test_summarize_functionality()
+        else:
+            summarize_ok = False
+            print("\n❌ لا يمكن اختبار التلخيص بسبب مشكلة CORS")
+    else:
+        cors_ok = False
+        summarize_ok = False
+        print("\n❌ لا يمكن اختبار CORS/التلخيص - الخادم غير مشتغل")
+    
+    # النتيجة النهائية
+    print("\n" + "=" * 60)
+    print("📊 ملخص التشخيص:")
+    print("=" * 60)
+    
+    print(f"  📦 المكتبات: {'✅ موجودة' if dependencies_ok else '❌ مفقودة'}")
+    print(f"  🔧 عملية Python: {'✅ تعمل' if has_python_process else '❌ لا تعمل'}")
+    print(f"  🌐 المنفذ 5001: {'✅ مفتوح' if port_status.get(5001) else '❌ مغلق'}")
+    print(f"  🔧 CORS: {'✅ صحيح' if cors_ok else '❌ مشكلة'}")
+    print(f"  🤖 التلخيص: {'✅ يعمل' if summarize_ok else '❌ لا يعمل'}")
+    
+    if summarize_ok:
+        print("\n🎉 جميع الاختبارات نجحت! المشكلة محلولة.")
+    elif not port_status.get(5001):
+        print("\n🔄 يجب تشغيل الخادم أولاً")
+        restart_server_suggestion()
+    elif not cors_ok:
+        print("\n🔄 مشكلة CORS - يجب إعادة تشغيل الخادم")
+        restart_server_suggestion()
+    else:
+        print("\n🔍 هناك مشكلة أخرى تحتاج لمزيد من التحقق")
+    
+    print("=" * 60)
+
+if __name__ == "__main__":
+    main()

fast_loading.py

@@ -0,0 +1,52 @@
+"""
+Fast Loading Configuration for Streamlit
+تحسين سرعة تحميل Streamlit
+"""
+
+import streamlit as st
+
+def apply_fast_loading_config():
+    """Apply configurations for faster loading"""
+    
+    # Custom CSS to prevent flash of unstyled content
+    st.markdown("""
+    <style>
+    /* Hide loading spinner faster */
+    .stSpinner {
+        display: none !important;
+    }
+    
+    /* Faster fade-in */
+    .main .block-container {
+        animation: fadeIn 0.1s ease-in-out;
+    }
+    
+    @keyframes fadeIn {
+        from { opacity: 0; }
+        to { opacity: 1; }
+    }
+    
+    /* Optimize fonts loading */
+    body {
+        font-display: swap;
+    }
+    
+    /* Remove unnecessary margins */
+    .block-container {
+        padding-top: 1rem;
+    }
+    </style>
+    """, unsafe_allow_html=True)
+
+def show_instant_content():
+    """Show content immediately without waiting"""
+    st.markdown("""
+    <div style="text-align: center; padding: 20px;">
+        <h1>🎵 SyncMaster</h1>
+        <p>منصة المزامنة الذكية بين الصوت والنص</p>
+        <div style="background: linear-gradient(45deg, #1f77b4, #17becf); 
+                    color: white; padding: 10px; border-radius: 5px; margin: 10px;">
+            ✅ التطبيق جاهز للاستخدام
+        </div>
+    </div>
+    """, unsafe_allow_html=True)

integrated_server.py

@@ -0,0 +1,235 @@
+"""
+Integrated Server Module
+يدمج خادم Flask للتسجيل مع تطبيق Streamlit
+"""
+
+import threading
+import time
+import logging
+import sys
+import subprocess
+import os
+import socket
+from pathlib import Path
+
+# Import configuration
+try:
+    from app_config import config
+except ImportError:
+    # Fallback configuration
+    class FallbackConfig:
+        RECORDER_PORT = 5001
+        RECORDER_HOST = "localhost"
+        USE_INTEGRATED_SERVER = True
+    config = FallbackConfig()
+
+# Configure logging
+logging.basicConfig(level=logging.INFO, format='%(asctime)s - %(levelname)s - %(message)s')
+
+def is_port_in_use(port):
+    """Check if a port is already in use"""
+    with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
+        try:
+            s.bind(('localhost', port))
+            return False
+        except socket.error:
+            return True
+
+class IntegratedServer:
+    def __init__(self):
+        self.flask_process = None
+        self.flask_thread = None
+        self.is_running = False
+        self.port = config.RECORDER_PORT
+        self.host = config.RECORDER_HOST
+        
+    def start_recorder_server_thread(self):
+        """Start the recorder server in a separate thread"""
+        try:
+            # Check if port is already in use
+            if is_port_in_use(self.port):
+                logging.info(f"✅ Port {self.port} already in use, assuming recorder server is running")
+                self.is_running = True
+                return True
+            
+            # Import Flask app from recorder_server
+            from recorder_server import app
+            
+            # Configure Flask to run without debug mode
+            app.config['DEBUG'] = False
+            app.config['TESTING'] = False
+            
+            # Run Flask app in thread
+            def run_flask():
+                try:
+                    app.run(
+                        host=self.host,
+                        port=self.port,
+                        debug=False,
+                        use_reloader=False,
+                        threaded=True
+                    )
+                except Exception as e:
+                    logging.error(f"Error running Flask server: {e}")
+            
+            self.flask_thread = threading.Thread(target=run_flask, daemon=True)
+            self.flask_thread.start()
+            
+            # Wait for server to start with shorter intervals
+            max_retries = 15
+            for i in range(max_retries):
+                time.sleep(0.5)  # Reduced from 1 second to 0.5 seconds
+                if self.is_server_responding():
+                    self.is_running = True
+                    logging.info(f"✅ Recorder server started successfully on port {self.port}")
+                    return True
+                if i < 5:  # Only log first few attempts to reduce noise
+                    logging.info(f"⏳ Waiting for recorder server to start... ({i+1}/{max_retries})")
+            
+            logging.warning("⚠️ Recorder server thread started but not responding")
+            return False
+                
+        except Exception as e:
+            logging.error(f"❌ Failed to start recorder server thread: {e}")
+            return False
+    
+    def start_recorder_server_process(self):
+        """Start the recorder server as a separate process (fallback method)"""
+        try:
+            # Check if port is already in use
+            if is_port_in_use(self.port):
+                logging.info(f"✅ Port {self.port} already in use, assuming recorder server is running")
+                self.is_running = True
+                return True
+            
+            # Start recorder server as subprocess
+            self.flask_process = subprocess.Popen(
+                [sys.executable, 'recorder_server.py'],
+                stdout=subprocess.PIPE,
+                stderr=subprocess.PIPE,
+                cwd=os.getcwd()
+            )
+            
+            # Wait for server to start with shorter intervals
+            max_retries = 20
+            for i in range(max_retries):
+                time.sleep(0.5)  # Reduced from 1 second to 0.5 seconds
+                
+                # Check if process is still running
+                if self.flask_process.poll() is not None:
+                    logging.error("❌ Recorder server process terminated")
+                    return False
+                
+                # Check if server is responding
+                if self.is_server_responding():
+                    self.is_running = True
+                    logging.info(f"✅ Recorder server started successfully as subprocess on port {self.port}")
+                    return True
+                    
+                if i < 5:  # Only log first few attempts
+                    logging.info(f"⏳ Waiting for recorder server to respond... ({i+1}/{max_retries})")
+            
+            logging.warning("⚠️ Recorder server process started but not responding")
+            return False
+                
+        except Exception as e:
+            logging.error(f"❌ Failed to start recorder server process: {e}")
+            return False
+    
+    def start_recorder_server(self):
+        """Start recorder server using the best available method"""
+        logging.info("🚀 Starting integrated recorder server...")
+        
+        # If already running, don't start again
+        if self.is_running and self.is_server_responding():
+            logging.info("✅ Recorder server already running and responding")
+            return True
+        
+        # Try thread method first (cleaner for integration)
+        if self.start_recorder_server_thread():
+            logging.info("✅ Recorder server started using thread method")
+            return True
+        
+        # Fallback to process method
+        logging.info("⚠️ Thread method failed, trying process method...")
+        if self.start_recorder_server_process():
+            logging.info("✅ Recorder server started using process method")
+            return True
+        
+        logging.error("❌ Failed to start recorder server using any method")
+        return False
+    
+    def stop_recorder_server(self):
+        """Stop the recorder server"""
+        try:
+            if self.flask_process and self.flask_process.poll() is None:
+                self.flask_process.terminate()
+                try:
+                    self.flask_process.wait(timeout=5)
+                    logging.info("✅ Recorder server process terminated")
+                except subprocess.TimeoutExpired:
+                    self.flask_process.kill()
+                    logging.info("⚠️ Recorder server process killed")
+            
+            self.is_running = False
+            
+        except Exception as e:
+            logging.error(f"❌ Error stopping recorder server: {e}")
+    
+    def is_server_responding(self):
+        """Check if the recorder server is responding"""
+        try:
+            import requests
+            # Very fast check - reduce timeout further
+            response = requests.get(f'http://{self.host}:{self.port}/record', timeout=0.5)
+            return response.status_code == 200
+        except:
+            return False
+    
+    def is_server_running(self):
+        """Check if the recorder server is running"""
+        return self.is_running and self.is_server_responding()
+
+# Global instance
+integrated_server = IntegratedServer()
+
+def ensure_recorder_server():
+    """Ensure recorder server is running, start if not"""
+    try:
+        # Quick check first - if server responds immediately, no delay
+        if integrated_server.is_server_responding():
+            logging.info("✅ Recorder server already running")
+            integrated_server.is_running = True
+            return True
+        
+        # Only start if not detected
+        logging.info("🔄 Recorder server not detected, starting...")
+        result = integrated_server.start_recorder_server()
+        return result
+    except Exception as e:
+        logging.error(f"❌ Error in ensure_recorder_server: {e}")
+        return False
+
+def stop_all_servers():
+    """Stop all integrated servers"""
+    integrated_server.stop_recorder_server()
+
+# Auto-start when module is imported (but not in main)
+if __name__ != "__main__":
+    # Only auto-start if not running as main module and not already started
+    try:
+        if not integrated_server.is_running:
+            ensure_recorder_server()
+    except Exception as e:
+        logging.error(f"❌ Error during auto-start: {e}")
+
+if __name__ == "__main__":
+    # Test the integrated server
+    print("Testing Integrated Server...")
+    success = ensure_recorder_server()
+    if success:
+        print("✅ Server test successful")
+        time.sleep(2)
+        stop_all_servers()
+    else:
+        print("❌ Server test failed")

main.py

@@ -0,0 +1,49 @@
+#!/usr/bin/env python3
+"""
+Simple launcher for SyncMaster with integrated server
+مُشغل بسيط مع خادم متكامل - مثالي لـ HuggingFace
+"""
+
+import streamlit as st
+import os
+import sys
+import time
+
+# Add current directory to path
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+
+# Initialize integrated server first
+recorder_server_started = False
+
+def start_integrated_server():
+    """Start the integrated recorder server"""
+    global recorder_server_started
+    
+    if recorder_server_started:
+        return True
+    
+    try:
+        from integrated_server import ensure_recorder_server
+        result = ensure_recorder_server()
+        if result:
+            recorder_server_started = True
+            st.success("✅ Integrated recorder server is running on port 5001")
+        else:
+            st.warning("⚠️ Could not start integrated recorder server")
+        return result
+    except Exception as e:
+        st.error(f"❌ Error starting integrated recorder server: {e}")
+        return False
+
+# Start the integrated server when the module loads
+start_integrated_server()
+
+# Import the main app module
+try:
+    import app
+except Exception as e:
+    st.error(f"❌ Error loading main application: {e}")
+    st.stop()
+
+if __name__ == "__main__":
+    print("🚀 SyncMaster main.py executed directly")

mp3_embedder.py

@@ -0,0 +1,323 @@
+from mutagen.mp3 import MP3
+from mutagen.id3 import ID3, SYLT, USLT, Encoding
+import os
+import tempfile
+import shutil
+import subprocess
+from typing import List, Dict, Tuple
+
+# --- Helper function to check for ffmpeg ---
+def is_ffmpeg_available():
+    """Check if ffmpeg is installed and accessible in the system's PATH."""
+    return shutil.which("ffmpeg") is not None
+
+class MP3Embedder:
+    """Handles embedding SYLT synchronized lyrics into MP3 files with robust error handling."""
+    
+    def __init__(self):
+        """Initialize the MP3 embedder."""
+        self.temp_dir = "/tmp/audio_sync"
+        os.makedirs(self.temp_dir, exist_ok=True)
+
+        self.ffmpeg_available = is_ffmpeg_available()
+
+    def embed_sylt_lyrics(self, audio_path: str, word_timestamps: List[Dict], 
+                         text: str, output_filename: str) -> Tuple[str, List[str]]:
+        """
+        Embeds SYLT synchronized lyrics into an MP3 file and returns logs.
+        
+        Returns:
+            A tuple containing:
+            - The path to the output MP3 file.
+            - A list of log messages detailing the process.
+        """
+        log_messages = []
+        def log_and_print(message):
+            log_messages.append(message)
+            print(f"MP3_EMBEDDER: {message}")
+        log_and_print(f"--- MP3Embedder initialized. ffmpeg available: {self.ffmpeg_available} ---")
+        log_and_print(f"--- Starting SYLT embedding for: {os.path.basename(audio_path)} ---")
+        output_path = os.path.join(self.temp_dir, output_filename)
+        try:
+            # --- Step 1: Ensure the file is in MP3 format ---
+            if not audio_path.lower().endswith('.mp3'):
+                if self.ffmpeg_available:
+                    log_and_print(f"'{os.path.basename(audio_path)}' is not an MP3. Converting with ffmpeg...")
+                    try:
+                        subprocess.run(
+                            ['ffmpeg', '-i', audio_path, '-codec:a', 'libmp3lame', '-q:a', '2', output_path],
+                            check=True, capture_output=True, text=True
+                        )
+                        log_and_print("--- ffmpeg conversion successful. ---")
+                    except subprocess.CalledProcessError as e:
+                        log_and_print("--- ERROR: ffmpeg conversion failed. ---")
+                        log_and_print(f"--- ffmpeg stderr: {e.stderr} ---")
+                        log_and_print("--- Fallback: Copying original file without conversion. ---")
+                        shutil.copy2(audio_path, output_path)
+                else:
+                    log_and_print("--- WARNING: ffmpeg is not available. Cannot convert non-MP3 file. Copying directly. ---")
+                    shutil.copy2(audio_path, output_path)
+            else:
+                log_and_print("--- Audio is already MP3. Copying to temporary location. ---")
+                shutil.copy2(audio_path, output_path)
+
+            # --- Step 2: Create SYLT data ---
+            log_and_print("--- Creating SYLT data from timestamps... ---")
+            sylt_data = self._create_sylt_data(word_timestamps)
+            if not sylt_data:
+                log_and_print("--- WARNING: No SYLT data could be created. Skipping embedding. ---")
+                return output_path, log_messages
+
+            log_and_print(f"--- Created {len(sylt_data)} SYLT entries. ---")
+
+            # --- Step 3: Embed data into the MP3 file ---
+            try:
+                log_and_print("--- Loading MP3 file with mutagen... ---")
+                audio_file = MP3(output_path, ID3=ID3)
+                
+                if audio_file.tags is None:
+                    log_and_print("--- No ID3 tags found. Creating new ones. ---")
+                    audio_file.add_tags()
+
+                # --- Embed SYLT (Synchronized Lyrics) ---
+                log_and_print("--- Creating and adding SYLT frame... ---")
+                sylt_frame = SYLT(
+                    encoding=Encoding.UTF8,
+                    lang='eng',
+                    format=2,
+                    type=1,
+                    text=sylt_data
+                )
+                audio_file.tags.delall('SYLT')
+                audio_file.tags.add(sylt_frame)
+
+                # --- Embed USLT (Unsynchronized Lyrics) as a fallback ---
+                log_and_print("--- Creating and adding USLT frame... ---")
+                uslt_frame = USLT(
+                    encoding=Encoding.UTF8,
+                    lang='eng',
+                    desc='',
+                    text=text
+                )
+                audio_file.tags.delall('USLT')
+                audio_file.tags.add(uslt_frame)
+
+                audio_file.save()
+                log_and_print("--- Successfully embedded SYLT and USLT frames. ---")
+                
+            except Exception as e:
+                log_and_print(f"--- ERROR: Failed to embed SYLT/USLT: {e} ---")
+            return output_path, log_messages
+
+        except Exception as e:
+            log_and_print(f"--- ERROR: Unexpected error in embed_sylt_lyrics: {e} ---")
+            return output_path, log_messages
+
+    def _create_sylt_data(self, word_timestamps: List[Dict]) -> List[tuple]:
+        """
+        Create SYLT data format from word timestamps
+        
+        Args:
+            word_timestamps: List of word timestamp dictionaries
+            
+        Returns:
+            List of tuples (text, timestamp_in_milliseconds)
+        """
+        # Debug print to check incoming data
+        print(f"DEBUG: word_timestamps received in _create_sylt_data: {word_timestamps}")
+        try:
+            sylt_data = []
+            
+            for word_data in word_timestamps:
+                word = word_data.get('word', '').strip()
+                start_time = word_data.get('start', 0)
+                
+                if word:
+                    # Convert seconds to milliseconds
+                    timestamp_ms = int(start_time * 1000)
+                    sylt_data.append((word, timestamp_ms))
+            
+            return sylt_data
+            
+        except Exception as e:
+            print(f"Error creating SYLT data: {str(e)}")
+            return []
+    
+    def _create_line_based_sylt_data(self, word_timestamps: List[Dict], max_words_per_line: int = 6) -> List[tuple]:
+        """
+        Create line-based SYLT data (alternative approach)
+        
+        Args:
+            word_timestamps: List of word timestamp dictionaries
+            max_words_per_line: Maximum words per line
+            
+        Returns:
+            List of tuples (line_text, timestamp_in_milliseconds)
+        """
+        try:
+            sylt_data = []
+            current_line = []
+            
+            for word_data in word_timestamps:
+                current_line.append(word_data)
+                
+                # Check if we should end this line
+                if len(current_line) >= max_words_per_line:
+                    if current_line:
+                        line_text = ' '.join([w.get('word', '') for w in current_line]).strip()
+                        start_time = current_line[0].get('start', 0)
+                        timestamp_ms = int(start_time * 1000)
+                        
+                        if line_text:
+                            sylt_data.append((line_text, timestamp_ms))
+                        
+                        current_line = []
+            
+            # Add remaining words as final line
+            if current_line:
+                line_text = ' '.join([w.get('word', '') for w in current_line]).strip()
+                start_time = current_line[0].get('start', 0)
+                timestamp_ms = int(start_time * 1000)
+                
+                if line_text:
+                    sylt_data.append((line_text, timestamp_ms))
+            
+            return sylt_data
+            
+        except Exception as e:
+            print(f"Error creating line-based SYLT data: {str(e)}")
+            return []
+    
+    def verify_sylt_embedding(self, mp3_path: str) -> Dict:
+        """
+        Verify that SYLT lyrics are properly embedded
+        
+        Args:
+            mp3_path: Path to the MP3 file
+            
+        Returns:
+            Dictionary with verification results
+        """
+        try:
+            audio_file = MP3(mp3_path)
+            
+            result = {
+                'has_sylt': False,
+                'has_uslt': False,
+                'sylt_entries': 0,
+                'error': None
+            }
+            
+            if audio_file.tags:
+                # Check for SYLT
+                sylt_frames = audio_file.tags.getall('SYLT')
+                if sylt_frames:
+                    result['has_sylt'] = True
+                    result['sylt_entries'] = len(sylt_frames[0].text) if sylt_frames[0].text else 0
+                
+                # Check for USLT (fallback)
+                uslt_frames = audio_file.tags.getall('USLT')
+                if uslt_frames:
+                    result['has_uslt'] = True
+            
+            return result
+            
+        except Exception as e:
+            return {
+                'has_sylt': False,
+                'has_uslt': False,
+                'sylt_entries': 0,
+                'error': str(e)
+            }
+    
+    def extract_sylt_lyrics(self, mp3_path: str) -> List[Dict]:
+        """
+        Extract SYLT lyrics from an MP3 file (for debugging)
+        
+        Args:
+            mp3_path: Path to the MP3 file
+            
+        Returns:
+            List of dictionaries with text and timestamp
+        """
+        try:
+            audio_file = MP3(mp3_path)
+            lyrics_data = []
+            
+            if audio_file.tags:
+                sylt_frames = audio_file.tags.getall('SYLT')
+                
+                for frame in sylt_frames:
+                    if frame.text:
+                        for text, timestamp_ms in frame.text:
+                            lyrics_data.append({
+                                'text': text,
+                                'timestamp': timestamp_ms / 1000.0  # Convert to seconds
+                            })
+            
+            return lyrics_data
+            
+        except Exception as e:
+            print(f"Error extracting SYLT lyrics: {str(e)}")
+            return []
+    
+    def create_lrc_file(self, word_timestamps: List[Dict], output_path: str) -> str:
+        """
+        Create an LRC (lyrics) file as an additional export option
+        
+        Args:
+            word_timestamps: List of word timestamp dictionaries
+            output_path: Path for the output LRC file
+            
+        Returns:
+            Path to the created LRC file
+        """
+        try:
+            lrc_lines = []
+            
+            # Group words into lines
+            current_line = []
+            for word_data in word_timestamps:
+                current_line.append(word_data)
+                
+                if len(current_line) >= 8:  # 8 words per line
+                    if current_line:
+                        line_text = ' '.join([w.get('word', '') for w in current_line])
+                        start_time = current_line[0].get('start', 0)
+                        
+                        # Format timestamp as [mm:ss.xx]
+                        minutes = int(start_time // 60)
+                        seconds = start_time % 60
+                        timestamp_str = f"[{minutes:02d}:{seconds:05.2f}]"
+                        
+                        lrc_lines.append(f"{timestamp_str}{line_text}")
+                        current_line = []
+            
+            # Add remaining words
+            if current_line:
+                line_text = ' '.join([w.get('word', '') for w in current_line])
+                start_time = current_line[0].get('start', 0)
+                
+                minutes = int(start_time // 60)
+                seconds = start_time % 60
+                timestamp_str = f"[{minutes:02d}:{seconds:05.2f}]"
+                
+                lrc_lines.append(f"{timestamp_str}{line_text}")
+            
+            # Write LRC file
+            with open(output_path, 'w', encoding='utf-8') as f:
+                f.write('\n'.join(lrc_lines))
+            
+            return output_path
+            
+        except Exception as e:
+            raise Exception(f"Error creating LRC file: {str(e)}")
+    
+    def __del__(self):
+        """Clean up temporary files"""
+        import shutil
+        if hasattr(self, 'temp_dir') and os.path.exists(self.temp_dir):
+            try:
+                shutil.rmtree(self.temp_dir)
+            except:
+                pass

package-lock.json

@@ -0,0 +1,12 @@
+{
+  "name": "syncmaster",
+  "version": "0.1.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "syncmaster",
+      "version": "0.1.0"
+    }
+  }
+}

package.json

@@ -0,0 +1,19 @@
+{
+  "name": "syncmaster",
+  "version": "0.1.0",
+  "private": true,
+  "description": "AI Audio-Text Synchronization Platform – convenience wrapper for Streamlit dev server with integrated recorder",
+  "scripts": {
+    "dev": "streamlit run app.py --server.port 5050 --server.address localhost",
+    "start": "streamlit run app.py --server.port 5050 --server.address 0.0.0.0",
+    "dev-launcher": "streamlit run app_launcher.py --server.port 5050 --server.address localhost",
+    "dev-separate": "python startup.py",
+    "build": "echo 'Installing Python dependencies...' && pip install -r requirements.txt"
+  },
+  "dependencies": {
+    "streamlit": "^1.28.0"
+  },
+  "keywords": ["ai", "audio", "transcription", "synchronization", "streamlit"],
+  "author": "SyncMaster Team",
+  "license": "MIT"
+} 

packages.txt

@@ -0,0 +1,5 @@
+ffmpeg
+libavcodec-extra
+libavformat-dev
+libavutil-dev
+libmp3lame0

performance_test.py

@@ -0,0 +1,59 @@
+"""
+Performance Test for SyncMaster
+اختبار أداء التطبيق
+"""
+
+import time
+import requests
+import threading
+
+def test_load_time(url, test_name):
+    """Test page load time"""
+    try:
+        start = time.time()
+        response = requests.get(url, timeout=10)
+        end = time.time()
+        
+        load_time = end - start
+        status = response.status_code
+        
+        print(f"🧪 {test_name}:")
+        print(f"   ⏱️ Load Time: {load_time:.3f} seconds")
+        print(f"   📊 Status: {status}")
+        print(f"   ✅ {'FAST' if load_time < 0.5 else 'SLOW' if load_time > 1.0 else 'OK'}")
+        print()
+        
+        return load_time, status
+    except Exception as e:
+        print(f"❌ {test_name} failed: {e}")
+        return None, None
+
+def run_performance_tests():
+    """Run comprehensive performance tests"""
+    print("🚀 SyncMaster Performance Test")
+    print("=" * 40)
+    
+    # Test multiple requests to see consistency
+    tests = [
+        ("First Load", "http://localhost:5050"),
+        ("Second Load", "http://localhost:5050"),
+        ("Third Load", "http://localhost:5050"),
+        ("Recorder API", "http://localhost:5001/record")
+    ]
+    
+    results = []
+    for test_name, url in tests:
+        load_time, status = test_load_time(url, test_name)
+        if load_time:
+            results.append(load_time)
+        time.sleep(0.5)  # Small delay between tests
+    
+    if results:
+        avg_time = sum(results) / len(results)
+        print(f"📊 Average Load Time: {avg_time:.3f} seconds")
+        print(f"🎯 Performance Rating: {'EXCELLENT' if avg_time < 0.2 else 'GOOD' if avg_time < 0.5 else 'NEEDS IMPROVEMENT'}")
+    
+    return results
+
+if __name__ == "__main__":
+    run_performance_tests()

pyproject.toml

@@ -0,0 +1,15 @@
+[project]
+name = "repl-nix-workspace"
+version = "0.1.0"
+description = "Add your description here"
+requires-python = ">=3.11"
+dependencies = [
+    "google-genai>=1.23.0",
+    "librosa>=0.11.0",
+    "moviepy>=2.2.1",
+    "mutagen>=1.47.0",
+    "numpy>=2.2.6",
+    "openai>=1.93.0",
+    "sift-stack-py>=0.7.0",
+    "streamlit>=1.46.1",
+]

recorder_server.py

@@ -0,0 +1,452 @@
+from flask import Flask, request, jsonify
+import os
+import tempfile
+from pathlib import Path
+from audio_processor import AudioProcessor
+import logging
+import json
+import traceback
+from flask_cors import CORS
+import soundfile as sf
+import librosa
+from translator import get_translator, get_translation
+from database import NotesDatabase
+from summarizer import LectureSummarizer
+
+app = Flask(__name__)
+# إعداد CORS بشكل صحيح لتجنب تكرار headers
+CORS(app, 
+     origins="*",
+     methods=['GET', 'POST', 'PUT', 'DELETE', 'OPTIONS'],
+     allow_headers=['Content-Type', 'Authorization']
+)
+
+# Configure logging
+logging.basicConfig(level=logging.INFO, format='%(asctime)s - %(levelname)s - %(message)s')
+
+# Initialize database and summarizer
+db = NotesDatabase()
+summarizer = LectureSummarizer()
+
+@app.route('/record', methods=['GET', 'POST', 'OPTIONS'])
+def record():
+    if request.method == 'OPTIONS':
+        # Handle CORS preflight request - flask-cors ستتولى headers
+        return '', 204
+
+    if request.method == 'GET':
+        logging.info("--- RECORD ENDPOINT: Health check request received. ---")
+        return jsonify({'status': 'ok', 'message': 'Recorder server is running.'})
+
+    logging.info("--- RECORD ENDPOINT: POST request received. ---")
+    logging.info(f"Request Headers: {request.headers}")
+    
+    if 'audio_data' not in request.files:
+        logging.error("--- RECORD ENDPOINT: 'audio_data' not in request files. ---")
+        return jsonify({'success': False, 'error': 'No audio file found'})
+
+    audio_file = request.files['audio_data']
+    markers = json.loads(request.form.get('markers', '[]'))
+    target_language = request.form.get('target_language', 'ar')  # Default to Arabic
+    enable_translation = request.form.get('enable_translation', 'true').lower() == 'true'
+    
+    print(f"🔍 RECORD ENDPOINT DEBUG:")
+    print(f"- enable_translation: {enable_translation}")
+    print(f"- target_language: {target_language}")
+    
+    logging.info(f"--- RECORD ENDPOINT: Received file: {audio_file.filename} ---")
+    logging.info(f"--- RECORD ENDPOINT: Target language: {target_language} ---")
+    logging.info(f"--- RECORD ENDPOINT: Translation enabled: {enable_translation} ---")
+    
+    if markers:
+        logging.info(f"--- RECORD ENDPOINT: Received {len(markers)} markers: {markers} ---")
+    
+    tmp_file_path = None
+    try:
+        with tempfile.NamedTemporaryFile(delete=False, suffix=".wav") as tmp_file:
+            audio_file.save(tmp_file.name)
+            tmp_file_path = tmp_file.name
+        logging.info(f"--- RECORD ENDPOINT: Audio saved to temporary file: {tmp_file_path} ---")
+
+        # --- File Standardization Step ---
+        try:
+            logging.info(f"--- RECORD ENDPOINT: Standardizing audio file: {tmp_file_path} ---")
+            y, sr = librosa.load(tmp_file_path, sr=None, mono=True)
+            sf.write(tmp_file_path, y, sr)
+            logging.info(f"--- RECORD ENDPOINT: Audio file successfully standardized. ---")
+        except Exception as e:
+            logging.warning(f"--- RECORD ENDPOINT: Could not standardize audio file, proceeding with original. Error: {e} ---")
+        # --- End Standardization ---
+
+        processor = AudioProcessor()
+        
+        # Choose processing method based on translation requirement
+        if enable_translation:
+            logging.info("--- RECORD ENDPOINT: Calling enhanced processor with translation ---")
+            result_data, processor_logs = processor.get_word_timestamps_with_translation(
+                tmp_file_path, target_language
+            )
+            
+            for log_msg in processor_logs:
+                logging.info(f"--- AUDIO_PROCESSOR LOG: {log_msg} ---")
+
+            if not result_data or not result_data.get('original_text'):
+                logging.error("--- RECORD ENDPOINT: Failed to generate transcription with translation. ---")
+                return jsonify({
+                    'success': False, 
+                    'error': 'Could not generate transcription with translation.', 
+                    'logs': processor_logs
+                })
+
+            # Prepare enhanced response with translation
+            full_text = result_data['original_text']
+            translated_text = result_data['translated_text']
+            word_timestamps = result_data['word_timestamps']
+            translated_timestamps = result_data.get('translated_timestamps', [])
+            
+            logging.info(f"--- RECORD ENDPOINT: Original text: '{full_text[:100]}...'")
+            logging.info(f"--- RECORD ENDPOINT: Translated text: '{translated_text[:100]}...'")
+            
+        else:
+            # Standard processing without translation
+            logging.info("--- RECORD ENDPOINT: Calling standard audio_processor.get_word_timestamps ---")
+            word_timestamps, processor_logs = processor.get_word_timestamps(tmp_file_path)
+            
+            for log_msg in processor_logs:
+                logging.info(f"--- AUDIO_PROCESSOR LOG: {log_msg} ---")
+
+            if not word_timestamps:
+                logging.error("--- RECORD ENDPOINT: Failed to generate timestamps. ---")
+                return jsonify({
+                    'success': False, 
+                    'error': 'Could not generate timestamps.', 
+                    'logs': processor_logs
+                })
+
+            full_text = " ".join([d['word'] for d in word_timestamps])
+            translated_text = full_text  # No translation requested
+            translated_timestamps = word_timestamps
+            result_data = {
+                'original_text': full_text,
+                'translated_text': translated_text,
+                'word_timestamps': word_timestamps,
+                'translated_timestamps': translated_timestamps,
+                'translation_success': not enable_translation
+            }
+            
+            logging.info(f"--- RECORD ENDPOINT: Transcription successful. Text: '{full_text[:100]}...'")
+        
+        # Read audio file for storage
+        with open(tmp_file_path, 'rb') as f:
+            audio_bytes = f.read()
+
+        # Prepare comprehensive transcription data
+        transcription_data = {
+            'original_text': result_data['original_text'],
+            'translated_text': result_data['translated_text'],
+            'word_timestamps': result_data['word_timestamps'],
+            'translated_timestamps': result_data.get('translated_timestamps', []),
+            'audio_bytes': audio_bytes.hex(),
+            'original_suffix': '.wav',
+            'markers': markers,
+            'target_language': target_language,
+            'translation_enabled': enable_translation,
+            'translation_success': result_data.get('translation_success', False),
+            'language_detected': result_data.get('language_detected', 'unknown')
+        }
+        
+        # Save comprehensive data to file
+        result_file_path = ""
+        with tempfile.NamedTemporaryFile(mode='w', delete=False, suffix=".json", dir=".", encoding='utf-8') as json_file:
+            json.dump(transcription_data, json_file, ensure_ascii=False, indent=2)
+            result_file_path = json_file.name
+        logging.info(f"--- RECORD ENDPOINT: Enhanced transcription data saved to {result_file_path} ---")
+
+        # Prepare successful response
+        response_data = {
+            'success': True,
+            'original_text': result_data['original_text'],
+            'translated_text': result_data['translated_text'],
+            'file_path': result_file_path,
+            'markers': markers,
+            'target_language': target_language,
+            'translation_enabled': enable_translation,
+            'translation_success': result_data.get('translation_success', False),
+            'language_detected': result_data.get('language_detected', 'unknown')
+        }
+        
+        print(f"🔍 DEBUG RESPONSE DATA:")
+        print(f"- success: {response_data['success']}")
+        print(f"- original_text: {response_data['original_text']}")
+        print(f"- translated_text: {response_data['translated_text']}")
+        print(f"- target_language: {response_data['target_language']}")
+        print(f"- translation_enabled: {response_data['translation_enabled']}")
+        print(f"- translation_success: {response_data['translation_success']}")
+        print(f"- language_detected: {response_data['language_detected']}")
+        
+        logging.info(f"--- RECORD ENDPOINT: Sending enhanced response with translation support ---")
+        return jsonify(response_data)
+
+    except Exception as e:
+        logging.error(f"--- RECORD ENDPOINT FATAL ERROR: {traceback.format_exc()} ---")
+        return jsonify({'success': False, 'error': str(e), 'trace': traceback.format_exc()}), 500
+    finally:
+        if tmp_file_path and os.path.exists(tmp_file_path):
+            os.unlink(tmp_file_path)
+
+@app.route('/translate', methods=['POST', 'OPTIONS'])
+def translate_text():
+    """Endpoint for standalone text translation"""
+    if request.method == 'OPTIONS':
+        # flask-cors ستتولى معالجة CORS headers
+        return '', 204
+    
+    try:
+        data = request.get_json()
+        if not data or 'text' not in data:
+            return jsonify({'success': False, 'error': 'No text provided for translation'})
+        
+        text = data['text']
+        target_language = data.get('target_language', 'ar')
+        source_language = data.get('source_language', 'auto')
+        
+        logging.info(f"--- TRANSLATE ENDPOINT: Translating text to {target_language} ---")
+        
+        translator = get_translator()
+        if not translator:
+            return jsonify({'success': False, 'error': 'Translation service not available'})
+        
+        translated_text, error = translator.translate_text(text, target_language, source_language)
+        
+        if translated_text:
+            # Detect source language if auto
+            detected_lang = 'unknown'
+            if source_language == 'auto':
+                detected_lang, _ = translator.detect_language(text)
+            
+            response_data = {
+                'success': True,
+                'original_text': text,
+                'translated_text': translated_text,
+                'source_language': detected_lang if source_language == 'auto' else source_language,
+                'target_language': target_language
+            }
+            logging.info(f"--- TRANSLATE ENDPOINT: Translation successful ---")
+            return jsonify(response_data)
+        else:
+            logging.error(f"--- TRANSLATE ENDPOINT: Translation failed: {error} ---")
+            return jsonify({'success': False, 'error': error})
+            
+    except Exception as e:
+        logging.error(f"--- TRANSLATE ENDPOINT ERROR: {traceback.format_exc()} ---")
+        return jsonify({'success': False, 'error': str(e)}), 500
+
+@app.route('/languages', methods=['GET'])
+def get_supported_languages():
+    """Get list of supported languages"""
+    try:
+        translator = get_translator()
+        if translator:
+            languages = translator.get_supported_languages()
+            return jsonify({'success': True, 'languages': languages})
+        else:
+            return jsonify({'success': False, 'error': 'Translation service not available'})
+    except Exception as e:
+        return jsonify({'success': False, 'error': str(e)}), 500
+
+@app.route('/ui-translations/<language>', methods=['GET'])
+def get_ui_translations(language):
+    """Get UI translations for a specific language"""
+    try:
+        from translator import UI_TRANSLATIONS
+        translations = UI_TRANSLATIONS.get(language, UI_TRANSLATIONS['en'])
+        return jsonify({'success': True, 'translations': translations, 'language': language})
+    except Exception as e:
+        return jsonify({'success': False, 'error': str(e)}), 500
+
+# ======= وظائف الملخص والملاحظات الجديدة =======
+
+@app.route('/summarize', methods=['POST', 'OPTIONS'])
+def summarize_text():
+    """إنشاء ملخص ذكي من النص"""
+    logging.info(f"--- SUMMARIZE ENDPOINT: {request.method} request received ---")
+    logging.info(f"--- SUMMARIZE ENDPOINT: Origin: {request.headers.get('Origin', 'None')} ---")
+    logging.info(f"--- SUMMARIZE ENDPOINT: Headers: {dict(request.headers)} ---")
+    
+    if request.method == 'OPTIONS':
+        logging.info("--- SUMMARIZE ENDPOINT: Handling OPTIONS preflight request ---")
+        # لا حاجة لإعداد headers يدوياً، flask-cors ستتولى الأمر
+        return '', 204
+    
+    try:
+        data = request.get_json()
+        if not data or 'text' not in data:
+            return jsonify({'success': False, 'error': 'لم يتم توفير نص للتلخيص'})
+        
+        text = data['text']
+        language = data.get('language', 'ar')
+        subject = data.get('subject', '')
+        summary_type = data.get('type', 'full')  # full, key_points, questions
+        
+        logging.info(f"--- SUMMARIZE ENDPOINT: Creating {summary_type} summary ---")
+        
+        if summary_type == 'key_points':
+            result, error = summarizer.extract_key_points(text, language)
+            result_key = 'key_points'
+        elif summary_type == 'questions':
+            result, error = summarizer.generate_review_questions(text, language)
+            result_key = 'questions'
+        elif summary_type == 'study_notes':
+            result, error = summarizer.generate_study_notes(text, subject, language)
+            result_key = 'study_notes'
+        else:  # full summary
+            result, error = summarizer.generate_summary(text, language)
+            result_key = 'summary'
+        
+        if result:
+            response_data = {
+                'success': True,
+                result_key: result,
+                'type': summary_type,
+                'language': language
+            }
+            logging.info(f"--- SUMMARIZE ENDPOINT: {summary_type} summary created successfully ---")
+            return jsonify(response_data)
+        else:
+            logging.error(f"--- SUMMARIZE ENDPOINT: Failed to create {summary_type}: {error} ---")
+            return jsonify({'success': False, 'error': error})
+            
+    except Exception as e:
+        logging.error(f"--- SUMMARIZE ENDPOINT ERROR: {traceback.format_exc()} ---")
+        return jsonify({'success': False, 'error': str(e)}), 500
+
+@app.route('/test-summarize', methods=['GET'])
+def test_summarize():
+    """اختبار بسيط لـ summarize endpoint"""
+    return jsonify({
+        'success': True, 
+        'message': 'Summarize endpoint is working!',
+        'test_summary': {
+            'main_summary': 'This is a test summary',
+            'key_points': ['Point 1', 'Point 2', 'Point 3'],
+            'review_questions': ['Question 1?', 'Question 2?'],
+            'study_notes': 'These are test study notes'
+        }
+    })
+
+@app.route('/notes', methods=['GET', 'POST', 'OPTIONS'])
+def handle_notes():
+    """التعامل مع الملاحظات - عرض وحفظ"""
+    if request.method == 'OPTIONS':
+        # flask-cors ستتولى معالجة CORS headers
+        return '', 204
+    
+    if request.method == 'GET':
+        try:
+            # البحث أو عرض جميع الملاحظات
+            search_query = request.args.get('search', '')
+            subject = request.args.get('subject', '')
+            limit = int(request.args.get('limit', 20))
+            
+            if search_query:
+                notes = db.search_notes(search_query)
+            elif subject:
+                notes = db.get_notes_by_subject(subject)
+            else:
+                notes = db.get_all_notes(limit)
+            
+            # إحصائيات سريعة
+            subjects = db.get_subjects()
+            
+            response = jsonify({
+                'success': True,
+                'notes': notes,
+                'subjects': subjects,
+                'total': len(notes)
+            })
+            return response
+            
+        except Exception as e:
+            response = jsonify({'success': False, 'error': str(e)})
+            return response, 500
+    
+    if request.method == 'POST':
+        try:
+            data = request.get_json()
+            
+            # التحقق من البيانات المطلوبة
+            if not data or 'original_text' not in data:
+                return jsonify({'success': False, 'error': 'البيانات غير مكتملة'})
+            
+            # حفظ الملاحظة
+            note_id = db.save_lecture_note(data)
+            
+            logging.info(f"--- NOTES ENDPOINT: Note saved with ID {note_id} ---")
+            
+            response = jsonify({
+                'success': True,
+                'note_id': note_id,
+                'message': 'تم حفظ الملاحظة بنجاح'
+            })
+            return response
+            
+        except Exception as e:
+            logging.error(f"--- NOTES ENDPOINT ERROR: {traceback.format_exc()} ---")
+            response = jsonify({'success': False, 'error': str(e)})
+            return response, 500
+
+@app.route('/notes/<int:note_id>', methods=['GET', 'PUT', 'DELETE', 'OPTIONS'])
+def handle_single_note(note_id):
+    """التعامل مع ملاحظة واحدة - عرض، تحديث، حذف"""
+    if request.method == 'OPTIONS':
+        # flask-cors ستتولى معالجة CORS headers
+        return '', 204
+    
+    if request.method == 'GET':
+        try:
+            note = db.get_note_by_id(note_id)
+            if note:
+                return jsonify({'success': True, 'note': note})
+            else:
+                return jsonify({'success': False, 'error': 'الملاحظة غير موجودة'}), 404
+                
+        except Exception as e:
+            return jsonify({'success': False, 'error': str(e)}), 500
+    
+    if request.method == 'PUT':
+        try:
+            data = request.get_json()
+            if not data:
+                return jsonify({'success': False, 'error': 'لم يتم توفير بيانات للتحديث'})
+            
+            success = db.update_note(note_id, data)
+            if success:
+                return jsonify({'success': True, 'message': 'تم تحديث الملاحظة بنجاح'})
+            else:
+                return jsonify({'success': False, 'error': 'فشل في تحديث الملاحظة'}), 400
+                
+        except Exception as e:
+            return jsonify({'success': False, 'error': str(e)}), 500
+    
+    if request.method == 'DELETE':
+        try:
+            success = db.delete_note(note_id)
+            if success:
+                return jsonify({'success': True, 'message': 'تم حذف الملاحظة بنجاح'})
+            else:
+                return jsonify({'success': False, 'error': 'فشل في حذف الملاحظة'}), 400
+                
+        except Exception as e:
+            return jsonify({'success': False, 'error': str(e)}), 500
+
+@app.route('/notes/subjects', methods=['GET'])
+def get_subjects():
+    """استرجاع قائمة المواد الدراسية"""
+    try:
+        subjects = db.get_subjects()
+        return jsonify({'success': True, 'subjects': subjects})
+    except Exception as e:
+        return jsonify({'success': False, 'error': str(e)}), 500
+
+if __name__ == '__main__':
+    app.run(port=5001)

requirements.txt

@@ -0,0 +1,15 @@
+
+google-generativeai>=0.8.0
+librosa>=0.10.0
+moviepy>=1.0.3
+mutagen>=1.47.0
+numpy>=1.24.0
+streamlit>=1.28.0
+altair>=5.0.0
+python-dotenv>=1.0.0
+Flask>=2.3.0
+Flask-Cors>=4.0.0
+soundfile>=0.12.0
+# Additional dependencies for enhanced translation features
+requests>=2.31.0
+typing-extensions>=4.7.0

setup_enhanced.py

@@ -0,0 +1,196 @@
+# SyncMaster Enhanced Setup Script
+# تشغيل SyncMaster المحسن مع دعم الترجمة
+
+import subprocess
+import sys
+import os
+import time
+from pathlib import Path
+
+def print_header():
+    print("=" * 60)
+    print("🎵 SyncMaster Enhanced - AI-Powered Translation Setup")
+    print("منصة المزامنة الذكية مع دعم الترجمة بالذكاء الاصطناعي")
+    print("=" * 60)
+
+def check_python_version():
+    """Check if Python version is compatible"""
+    if sys.version_info < (3, 8):
+        print("❌ Error: Python 3.8 or higher is required.")
+        print("خطأ: يتطلب Python 3.8 أو أحدث")
+        return False
+    print(f"✅ Python version: {sys.version}")
+    return True
+
+def install_requirements():
+    """Install required packages"""
+    print("\n📦 Installing required packages...")
+    print("تثبيت الحزم المطلوبة...")
+    
+    try:
+        subprocess.check_call([sys.executable, "-m", "pip", "install", "-r", "requirements.txt"])
+        print("✅ All packages installed successfully!")
+        print("تم تثبيت جميع الحزم بنجاح!")
+        return True
+    except subprocess.CalledProcessError as e:
+        print(f"❌ Error installing packages: {e}")
+        print(f"خطأ في تثبيت الحزم: {e}")
+        return False
+
+def check_env_file():
+    """Check if .env file exists and has required keys"""
+    env_path = Path(".env")
+    if not env_path.exists():
+        print("❌ .env file not found!")
+        print("ملف .env غير موجود!")
+        create_env_file()
+        return False
+    
+    with open(env_path, 'r') as f:
+        content = f.read()
+        if "GEMINI_API_KEY" not in content:
+            print("❌ GEMINI_API_KEY not found in .env file!")
+            print("مفتاح GEMINI_API_KEY غير موجود في ملف .env!")
+            return False
+    
+    print("✅ Environment file configured correctly!")
+    print("ملف البيئة مُعدّ بشكل صحيح!")
+    return True
+
+def create_env_file():
+    """Create a template .env file"""
+    print("\n📝 Creating .env template file...")
+    print("إنشاء ملف قالب .env...")
+    
+    env_content = """# SyncMaster Configuration
+# إعدادات SyncMaster
+
+# Gemini AI API Key (Required for transcription and translation)
+# مفتاح Gemini AI (مطلوب للنسخ والترجمة)
+GEMINI_API_KEY=your_gemini_api_key_here
+
+# Optional: Set default language (en/ar)
+# اختياري: تعيين اللغة الافتراضية
+DEFAULT_LANGUAGE=en
+
+# Optional: Enable translation by default
+# اختياري: تفعيل الترجمة افتراضياً
+ENABLE_TRANSLATION=true
+
+# Optional: Default target language for translation
+# اختياري: اللغة المستهدفة للترجمة افتراضياً
+DEFAULT_TARGET_LANGUAGE=ar
+"""
+    
+    with open(".env", "w", encoding="utf-8") as f:
+        f.write(env_content)
+    
+    print("✅ .env template created!")
+    print("تم إنشاء قالب .env!")
+    print("\n🔑 Please edit .env file and add your Gemini API key:")
+    print("يرجى تحرير ملف .env وإضافة مفتاح Gemini API الخاص بك:")
+    print("GEMINI_API_KEY=your_actual_api_key")
+
+def start_recorder_server():
+    """Start the Flask recorder server"""
+    print("\n🚀 Starting recorder server...")
+    print("بدء تشغيل خادم التسجيل...")
+    
+    try:
+        # Start recorder server in background
+        process = subprocess.Popen([
+            sys.executable, "recorder_server.py"
+        ], stdout=subprocess.PIPE, stderr=subprocess.PIPE)
+        
+        print("✅ Recorder server started on http://localhost:5001")
+        print("تم بدء تشغيل خادم التسجيل على http://localhost:5001")
+        return process
+    except Exception as e:
+        print(f"❌ Error starting recorder server: {e}")
+        print(f"خطأ في بدء تشغيل خادم التسجيل: {e}")
+        return None
+
+def start_streamlit_app():
+    """Start the main Streamlit application"""
+    print("\n🌟 Starting SyncMaster main application...")
+    print("بدء تشغيل تطبيق SyncMaster الرئيسي...")
+    
+    try:
+        subprocess.run([
+            sys.executable, "-m", "streamlit", "run", "app.py",
+            "--server.port", "8501",
+            "--server.address", "localhost"
+        ])
+    except KeyboardInterrupt:
+        print("\n👋 Application stopped by user.")
+        print("تم إيقاف التطبيق بواسطة المستخدم.")
+    except Exception as e:
+        print(f"❌ Error starting Streamlit app: {e}")
+        print(f"خطأ في بدء تشغيل تطبيق Streamlit: {e}")
+
+def print_usage_instructions():
+    """Print usage instructions"""
+    print("\n📖 Usage Instructions / تعليمات الاستخدام:")
+    print("-" * 40)
+    print("1. Open your browser and go to: http://localhost:8501")
+    print("   افتح متصفحك واذهب إلى: http://localhost:8501")
+    print("\n2. For recording, the recorder interface is at: http://localhost:5001")
+    print("   للتسجيل، واجهة التسجيل متاحة على: http://localhost:5001")
+    print("\n3. Choose your language (English/العربية) from the sidebar")
+    print("   اختر لغتك (English/العربية) من الشريط الجانبي")
+    print("\n4. Enable translation and select target language")
+    print("   فعّل الترجمة واختر اللغة المستهدفة")
+    print("\n5. Upload audio or record directly from microphone")
+    print("   ارفع ملف صوتي أو سجل مباشرة من الميكروفون")
+    print("\n📚 For detailed instructions, see README_AR.md")
+    print("للتعليمات المفصلة، راجع ملف README_AR.md")
+
+def main():
+    """Main setup function"""
+    print_header()
+    
+    # Check Python version
+    if not check_python_version():
+        return
+    
+    # Install requirements
+    if not install_requirements():
+        return
+    
+    # Check environment configuration
+    if not check_env_file():
+        print("\n⚠️  Please configure your .env file before running the application.")
+        print("يرجى إعداد ملف .env قبل تشغيل التطبيق.")
+        return
+    
+    print("\n🎉 Setup completed successfully!")
+    print("تم الإعداد بنجاح!")
+    
+    print_usage_instructions()
+    
+    # Ask user if they want to start the application
+    print("\n" + "=" * 60)
+    start_now = input("Start SyncMaster now? (y/n) / تشغيل SyncMaster الآن؟ (y/n): ").lower().strip()
+    
+    if start_now in ['y', 'yes', 'نعم']:
+        # Start recorder server
+        recorder_process = start_recorder_server()
+        
+        # Wait a moment for server to start
+        time.sleep(2)
+        
+        # Start main application
+        try:
+            start_streamlit_app()
+        finally:
+            # Clean up recorder server
+            if recorder_process:
+                recorder_process.terminate()
+                print("\n🧹 Cleaning up processes...")
+                print("تنظيف العمليات...")
+    else:
+        print("\n👋 Setup complete. Run 'python setup_enhanced.py' when ready.")
+        print("الإعداد مكتمل. شغّل 'python setup_enhanced.py' عندما تكون جاهزاً.")
+
+if __name__ == "__main__":
+    main()

start_debug.py

@@ -0,0 +1,209 @@
+#!/usr/bin/env python3
+"""
+Enhanced startup script for SyncMaster with debugging capabilities
+نص بدء التشغيل المحسن لـ SyncMaster مع قدرات التتبع
+"""
+
+import os
+import sys
+import time
+import socket
+import subprocess
+import psutil
+from pathlib import Path
+
+def check_port_available(port):
+    """Check if a port is available"""
+    try:
+        with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
+            s.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
+            s.bind(('localhost', port))
+            return True
+    except:
+        return False
+
+def kill_processes_on_port(port):
+    """Kill processes using a specific port"""
+    try:
+        for proc in psutil.process_iter(['pid', 'name', 'connections']):
+            try:
+                connections = proc.info['connections']
+                if connections:
+                    for conn in connections:
+                        if conn.laddr.port == port:
+                            print(f"🔄 Killing process {proc.info['name']} (PID: {proc.info['pid']}) using port {port}")
+                            proc.kill()
+                            time.sleep(1)
+            except (psutil.NoSuchProcess, psutil.AccessDenied):
+                continue
+    except Exception as e:
+        print(f"⚠️ Error killing processes on port {port}: {e}")
+
+def check_dependencies():
+    """Check if required dependencies are installed"""
+    required_packages = [
+        'streamlit', 'flask', 'librosa', 'soundfile', 
+        'google-generativeai', 'python-dotenv'
+    ]
+    
+    missing_packages = []
+    for package in required_packages:
+        try:
+            __import__(package.replace('-', '_'))
+        except ImportError:
+            missing_packages.append(package)
+    
+    if missing_packages:
+        print(f"❌ Missing packages: {', '.join(missing_packages)}")
+        print("📦 Installing missing packages...")
+        subprocess.run([sys.executable, '-m', 'pip', 'install'] + missing_packages)
+        return False
+    return True
+
+def check_env_file():
+    """Check if .env file exists and has required keys"""
+    env_path = Path('.env')
+    if not env_path.exists():
+        print("❌ .env file not found!")
+        print("📝 Creating sample .env file...")
+        with open('.env', 'w') as f:
+            f.write("GEMINI_API_KEY=your_api_key_here\n")
+        print("✅ Please add your Gemini API key to .env file")
+        return False
+    
+    # Check if API key is set
+    try:
+        from dotenv import load_dotenv
+        load_dotenv()
+        api_key = os.getenv("GEMINI_API_KEY")
+        if not api_key or api_key == "your_api_key_here":
+            print("⚠️ GEMINI_API_KEY not properly set in .env file")
+            return False
+    except Exception as e:
+        print(f"❌ Error reading .env file: {e}")
+        return False
+    
+    return True
+
+def start_recorder_server():
+    """Start the recorder server"""
+    print("🎙️ Starting recorder server...")
+    
+    # Kill any existing processes on port 5001
+    if not check_port_available(5001):
+        print("🔄 Port 5001 is busy, killing existing processes...")
+        kill_processes_on_port(5001)
+        time.sleep(2)
+    
+    if check_port_available(5001):
+        try:
+            # Start recorder server
+            server_process = subprocess.Popen(
+                [sys.executable, 'recorder_server.py'],
+                stdout=subprocess.PIPE,
+                stderr=subprocess.PIPE,
+                creationflags=subprocess.CREATE_NEW_CONSOLE if os.name == 'nt' else 0
+            )
+            
+            # Wait for server to start
+            time.sleep(3)
+            
+            # Test server connection
+            import requests
+            try:
+                response = requests.get('http://localhost:5001/record', timeout=5)
+                if response.status_code == 200:
+                    print("✅ Recorder server started successfully on port 5001")
+                    return server_process
+                else:
+                    raise Exception(f"Server responded with status {response.status_code}")
+            except Exception as e:
+                print(f"❌ Failed to connect to recorder server: {e}")
+                server_process.terminate()
+                return None
+                
+        except Exception as e:
+            print(f"❌ Failed to start recorder server: {e}")
+            return None
+    else:
+        print("❌ Port 5001 is still not available")
+        return None
+
+def start_main_app():
+    """Start the main Streamlit application"""
+    print("🚀 Starting main SyncMaster application...")
+    
+    # Find available port for Streamlit
+    streamlit_port = 8501
+    while not check_port_available(streamlit_port) and streamlit_port < 8510:
+        streamlit_port += 1
+    
+    if streamlit_port >= 8510:
+        print("❌ No available ports for Streamlit (tried 8501-8509)")
+        return None
+    
+    try:
+        # Start Streamlit app
+        subprocess.run([
+            sys.executable, '-m', 'streamlit', 'run', 'app.py',
+            '--server.port', str(streamlit_port),
+            '--server.address', 'localhost',
+            '--browser.gatherUsageStats', 'false'
+        ])
+    except KeyboardInterrupt:
+        print("\n🛑 Application stopped by user")
+    except Exception as e:
+        print(f"❌ Failed to start main application: {e}")
+
+def main():
+    """Main startup function"""
+    print("=" * 60)
+    print("🎵 SyncMaster Enhanced - Startup Script")
+    print("منصة المزامنة الذكية - سكريبت البدء")
+    print("=" * 60)
+    
+    # Change to script directory
+    script_dir = Path(__file__).parent
+    os.chdir(script_dir)
+    print(f"📁 Working directory: {script_dir}")
+    
+    # Step 1: Check dependencies
+    print("\n📦 Checking dependencies...")
+    if not check_dependencies():
+        print("❌ Please restart after installing dependencies")
+        return
+    print("✅ All dependencies available")
+    
+    # Step 2: Check environment file
+    print("\n🔑 Checking environment configuration...")
+    if not check_env_file():
+        print("❌ Please configure .env file and restart")
+        return
+    print("✅ Environment configuration OK")
+    
+    # Step 3: Start recorder server
+    print("\n🎙️ Starting recording server...")
+    server_process = start_recorder_server()
+    if not server_process:
+        print("❌ Failed to start recorder server")
+        return
+    
+    # Step 4: Start main application
+    print("\n🌐 Starting web interface...")
+    print("📱 The application will open in your browser")
+    print("🎙️ Recording interface: http://localhost:5001")
+    print("💻 Main interface: http://localhost:8501")
+    print("\nPress Ctrl+C to stop all services")
+    
+    try:
+        start_main_app()
+    finally:
+        # Cleanup
+        print("\n🧹 Cleaning up...")
+        if server_process:
+            server_process.terminate()
+            print("✅ Recorder server stopped")
+        print("👋 Goodbye!")
+
+if __name__ == "__main__":
+    main()

start_enhanced.bat

@@ -0,0 +1,57 @@
+@echo off
+echo ===============================================
+echo SyncMaster Enhanced - Quick Start
+echo منصة المزامنة الذكية - البدء السريع  
+echo ===============================================
+echo.
+
+echo ✅ All system tests passed! / جميع الاختبارات نجحت!
+echo 🚀 Starting SyncMaster Enhanced...
+echo.
+
+REM Check if Python is installed
+python --version >nul 2>&1
+if errorlevel 1 (
+    echo ❌ ERROR: Python is not installed or not in PATH
+    echo خطأ: Python غير مثبت أو غير موجود في PATH
+    echo Please install Python 3.8+ from python.org
+    pause
+    exit /b 1
+)
+
+REM Check if .env file exists
+if not exist ".env" (
+    echo ⚠️ WARNING: .env file not found!
+    echo تحذير: ملف .env غير موجود!
+    echo Creating sample .env file...
+    echo GEMINI_API_KEY=your_api_key_here > .env
+    echo Please add your Gemini API key to .env file
+    echo يرجى إضافة مفتاح Gemini API إلى ملف .env
+    pause
+    exit /b 1
+)
+
+echo 🔍 Running system test...
+echo تشغيل اختبار النظام...
+python test_system.py
+if errorlevel 1 (
+    echo ❌ System test failed! Please fix issues first.
+    echo فشل اختبار النظام! يرجى إصلاح المشاكل أولاً.
+    pause
+    exit /b 1
+)
+
+echo.
+echo ✅ System test passed! Starting application...
+echo نجح اختبار النظام! بدء تشغيل التطبيق...
+echo.
+
+REM Use debug startup for better error handling
+echo 🚀 Starting with advanced debugging...
+echo بدء التشغيل مع التشخيص المتقدم...
+python start_debug.py
+
+echo.
+echo 👋 Application stopped. Press any key to exit.
+echo تم إيقاف التطبيق. اضغط أي زر للخروج.
+pause

startup.py

@@ -0,0 +1,218 @@
+#!/usr/bin/env python3
+"""
+Startup Script for SyncMaster
+نقطة دخول موحدة تضمن تشغيل جميع المكونات المطلوبة
+"""
+
+import os
+import sys
+import time
+import logging
+import subprocess
+import signal
+import atexit
+from pathlib import Path
+
+# Configure logging
+logging.basicConfig(
+    level=logging.INFO,
+    format='%(asctime)s - %(levelname)s - %(message)s'
+)
+
+class SyncMasterLauncher:
+    def __init__(self):
+        self.recorder_process = None
+        self.streamlit_process = None
+        self.cleanup_registered = False
+        
+    def setup_cleanup(self):
+        """Setup cleanup handlers"""
+        if not self.cleanup_registered:
+            atexit.register(self.cleanup)
+            signal.signal(signal.SIGINT, self.signal_handler)
+            signal.signal(signal.SIGTERM, self.signal_handler)
+            self.cleanup_registered = True
+    
+    def signal_handler(self, signum, frame):
+        """Handle termination signals"""
+        logging.info(f"Received signal {signum}, cleaning up...")
+        self.cleanup()
+        sys.exit(0)
+    
+    def cleanup(self):
+        """Clean up all processes"""
+        logging.info("🧹 Cleaning up processes...")
+        
+        if self.recorder_process and self.recorder_process.poll() is None:
+            try:
+                self.recorder_process.terminate()
+                self.recorder_process.wait(timeout=5)
+                logging.info("✅ Recorder server terminated")
+            except:
+                try:
+                    self.recorder_process.kill()
+                    logging.info("⚠️ Recorder server killed")
+                except:
+                    pass
+        
+        if self.streamlit_process and self.streamlit_process.poll() is None:
+            try:
+                self.streamlit_process.terminate()
+                self.streamlit_process.wait(timeout=5)
+                logging.info("✅ Streamlit server terminated")
+            except:
+                try:
+                    self.streamlit_process.kill()
+                    logging.info("⚠️ Streamlit server killed")
+                except:
+                    pass
+    
+    def start_recorder_server(self):
+        """Start the recorder server"""
+        try:
+            logging.info("🚀 Starting recorder server...")
+            self.recorder_process = subprocess.Popen(
+                [sys.executable, 'recorder_server.py'],
+                stdout=subprocess.PIPE,
+                stderr=subprocess.PIPE
+            )
+            
+            # Wait for server to start
+            time.sleep(3)
+            
+            # Check if process is running
+            if self.recorder_process.poll() is None:
+                # Verify server is responding
+                try:
+                    import requests
+                    response = requests.get('http://localhost:5001/record', timeout=5)
+                    if response.status_code == 200:
+                        logging.info("✅ Recorder server started successfully on port 5001")
+                        return True
+                    else:
+                        logging.warning(f"⚠️ Recorder server responded with status: {response.status_code}")
+                except Exception as e:
+                    logging.warning(f"⚠️ Could not verify recorder server: {e}")
+                
+                # Server process is running even if verification failed
+                return True
+            else:
+                logging.error("❌ Recorder server process failed to start")
+                return False
+                
+        except Exception as e:
+            logging.error(f"❌ Failed to start recorder server: {e}")
+            return False
+    
+    def start_streamlit_app(self, port=5050, host="0.0.0.0"):
+        """Start the Streamlit application"""
+        try:
+            logging.info(f"🚀 Starting Streamlit app on {host}:{port}...")
+            
+            cmd = [
+                sys.executable, '-m', 'streamlit', 'run', 'app.py',
+                '--server.port', str(port),
+                '--server.address', host,
+                '--server.headless', 'true',
+                '--browser.gatherUsageStats', 'false'
+            ]
+            
+            self.streamlit_process = subprocess.Popen(cmd)
+            
+            # Wait a bit for Streamlit to start
+            time.sleep(5)
+            
+            if self.streamlit_process.poll() is None:
+                logging.info(f"✅ Streamlit app started successfully on http://{host}:{port}")
+                return True
+            else:
+                logging.error("❌ Streamlit app failed to start")
+                return False
+                
+        except Exception as e:
+            logging.error(f"❌ Failed to start Streamlit app: {e}")
+            return False
+    
+    def launch_integrated(self):
+        """Launch with integrated server (recommended for HuggingFace)"""
+        logging.info("🚀 Launching SyncMaster with integrated server...")
+        self.setup_cleanup()
+        
+        # Start Streamlit with integrated server
+        try:
+            # Import to trigger integrated server startup
+            import app
+            
+            # Run Streamlit
+            import streamlit.web.cli as stcli
+            import sys
+            
+            # Set command line arguments for Streamlit
+            sys.argv = [
+                "streamlit", "run", "app.py",
+                "--server.port", "5050",
+                "--server.address", "0.0.0.0",
+                "--server.headless", "true",
+                "--browser.gatherUsageStats", "false"
+            ]
+            
+            # Run Streamlit CLI
+            stcli.main()
+            
+        except Exception as e:
+            logging.error(f"❌ Failed to launch integrated mode: {e}")
+            return False
+    
+    def launch_separate(self):
+        """Launch with separate processes (development mode)"""
+        logging.info("🚀 Launching SyncMaster with separate processes...")
+        self.setup_cleanup()
+        
+        # Start recorder server first
+        if not self.start_recorder_server():
+            logging.error("❌ Failed to start recorder server, aborting...")
+            return False
+        
+        # Start Streamlit app
+        if not self.start_streamlit_app():
+            logging.error("❌ Failed to start Streamlit app, aborting...")
+            self.cleanup()
+            return False
+        
+        logging.info("✅ All services started successfully!")
+        logging.info("🌐 Access the application at: http://localhost:5050")
+        logging.info("🎙️ Recorder API available at: http://localhost:5001")
+        
+        try:
+            # Keep the main process alive
+            while True:
+                time.sleep(1)
+                
+                # Check if processes are still running
+                if self.recorder_process and self.recorder_process.poll() is not None:
+                    logging.error("❌ Recorder server process died")
+                    break
+                
+                if self.streamlit_process and self.streamlit_process.poll() is not None:
+                    logging.error("❌ Streamlit app process died")
+                    break
+                    
+        except KeyboardInterrupt:
+            logging.info("👋 Shutting down...")
+        finally:
+            self.cleanup()
+
+def main():
+    """Main entry point"""
+    launcher = SyncMasterLauncher()
+    
+    # Check if running in HuggingFace or similar environment
+    if os.getenv('SPACE_ID') or '--integrated' in sys.argv:
+        # Use integrated mode for cloud deployments
+        launcher.launch_integrated()
+    else:
+        # Use separate processes for local development
+        launcher.launch_separate()
+
+if __name__ == "__main__":
+    main()

summarizer.py

@@ -0,0 +1,308 @@
+# summarizer.py - نظام الملخص الذكي للمحاضرات
+
+from translator import get_translator
+from typing import Tuple, List, Dict, Optional
+import re
+
+class LectureSummarizer:
+    """نظام الملخص الذكي للمحاضرات الدراسية"""
+    
+    def __init__(self):
+        self.translator = get_translator()
+    
+    def generate_summary(self, text: str, language: str = 'ar') -> Tuple[Optional[str], Optional[str]]:
+        """
+        إنشاء ملخص ذكي للنص
+        
+        Args:
+            text: النص المراد تلخيصه
+            language: لغة الملخص ('ar' للعربية، 'en' للإنجليزية)
+        
+        Returns:
+            Tuple of (summary, error_message)
+        """
+        if not self.translator or not self.translator.client:
+            return None, "خدمة الذكاء الاصطناعي غير متوفرة"
+        
+        if not text or len(text.strip()) < 50:
+            return None, "النص قصير جداً لإنشاء ملخص مفيد"
+        
+        try:
+            prompt = self._create_summary_prompt(text, language)
+            
+            response = self.translator.client.models.generate_content(
+                model="gemini-2.5-flash",
+                contents=[prompt]
+            )
+            
+            if response and response.text:
+                summary = response.text.strip()
+                summary = self._clean_summary_output(summary)
+                return summary, None
+            else:
+                return None, "فشل في إنشاء الملخص"
+                
+        except Exception as e:
+            return None, f"خطأ في إنشاء الملخص: {str(e)}"
+    
+    def extract_key_points(self, text: str, language: str = 'ar') -> Tuple[Optional[List[str]], Optional[str]]:
+        """
+        استخراج النقاط الرئيسية من النص
+        
+        Args:
+            text: النص المراد استخراج النقاط منه
+            language: لغة النقاط
+        
+        Returns:
+            Tuple of (key_points_list, error_message)
+        """
+        if not self.translator or not self.translator.client:
+            return None, "خدمة الذكاء الاصطناعي غير متوفرة"
+        
+        try:
+            prompt = self._create_key_points_prompt(text, language)
+            
+            response = self.translator.client.models.generate_content(
+                model="gemini-2.5-flash",
+                contents=[prompt]
+            )
+            
+            if response and response.text:
+                key_points_text = response.text.strip()
+                key_points = self._parse_key_points(key_points_text)
+                return key_points, None
+            else:
+                return None, "فشل في استخراج النقاط الرئيسية"
+                
+        except Exception as e:
+            return None, f"خطأ في استخراج النقاط: {str(e)}"
+    
+    def generate_study_notes(self, text: str, subject: str = "", language: str = 'ar') -> Tuple[Optional[Dict], Optional[str]]:
+        """
+        إنشاء مذكرة دراسية شاملة
+        
+        Args:
+            text: النص الأصلي
+            subject: المادة الدراسية
+            language: لغة المذكرة
+        
+        Returns:
+            Tuple of (study_notes_dict, error_message)
+        """
+        try:
+            # إنشاء الملخص
+            summary, summary_error = self.generate_summary(text, language)
+            if summary_error and not summary:
+                return None, summary_error
+            
+            # استخراج النقاط الرئيسية
+            key_points, points_error = self.extract_key_points(text, language)
+            if points_error and not key_points:
+                key_points = []
+            
+            # إنشاء أسئلة مراجعة
+            review_questions, questions_error = self.generate_review_questions(text, language)
+            if questions_error and not review_questions:
+                review_questions = []
+            
+            study_notes = {
+                'summary': summary or "لم يتم إنشاء ملخص",
+                'key_points': key_points or [],
+                'review_questions': review_questions or [],
+                'subject': subject,
+                'word_count': len(text.split()),
+                'estimated_reading_time': max(1, len(text.split()) // 200)  # دقائق تقريبية
+            }
+            
+            return study_notes, None
+            
+        except Exception as e:
+            return None, f"خطأ في إنشاء المذكرة: {str(e)}"
+    
+    def generate_review_questions(self, text: str, language: str = 'ar') -> Tuple[Optional[List[str]], Optional[str]]:
+        """
+        إنشاء أسئلة مراجعة من النص
+        
+        Args:
+            text: النص المراد إنشاء أسئلة منه
+            language: لغة الأسئلة
+        
+        Returns:
+            Tuple of (questions_list, error_message)
+        """
+        if not self.translator or not self.translator.client:
+            return None, "خدمة الذكاء الاصطناعي غير متوفرة"
+        
+        try:
+            prompt = self._create_questions_prompt(text, language)
+            
+            response = self.translator.client.models.generate_content(
+                model="gemini-2.5-flash",
+                contents=[prompt]
+            )
+            
+            if response and response.text:
+                questions_text = response.text.strip()
+                questions = self._parse_questions(questions_text)
+                return questions, None
+            else:
+                return None, "فشل في إنشاء أسئلة المراجعة"
+                
+        except Exception as e:
+            return None, f"خطأ في إنشاء الأسئلة: {str(e)}"
+    
+    def _create_summary_prompt(self, text: str, language: str) -> str:
+        """إنشاء prompt للملخص"""
+        if language == 'ar':
+            return f"""
+قم بإنشاء ملخص شامل ومفيد لهذا النص من محاضرة دراسية:
+
+متطلبات الملخص:
+1. اكتب بالعربية الفصحى الواضحة
+2. اذكر الموضوع الرئيسي والأفكار المهمة
+3. رتب المعلومات بشكل منطقي
+4. اجعل الملخص مناسب للطلاب الجامعيين
+5. لا تتجاوز 200 كلمة
+6. أضف العناوين الفرعية إذا لزم الأمر
+
+النص:
+{text}
+
+الملخص:
+"""
+        else:
+            return f"""
+Create a comprehensive and useful summary of this lecture text:
+
+Requirements:
+1. Write in clear, academic English
+2. Mention the main topic and important ideas  
+3. Organize information logically
+4. Make it suitable for university students
+5. Don't exceed 200 words
+6. Add subheadings if necessary
+
+Text:
+{text}
+
+Summary:
+"""
+    
+    def _create_key_points_prompt(self, text: str, language: str) -> str:
+        """إنشاء prompt للنقاط الرئيسية"""
+        if language == 'ar':
+            return f"""
+استخرج أهم النقاط الرئيسية من هذا النص:
+
+متطلبات:
+1. اكتب كل نقطة في سطر منفصل
+2. ابدأ كل نقطة بـ "•" 
+3. اجعل كل نقطة واضحة ومفيدة للدراسة
+4. لا تزيد عن 8 نقاط
+5. رتب النقاط حسب الأهمية
+
+النص:
+{text}
+
+النقاط الرئيسية:
+"""
+        else:
+            return f"""
+Extract the most important key points from this text:
+
+Requirements:
+1. Write each point on a separate line
+2. Start each point with "•"
+3. Make each point clear and useful for studying
+4. No more than 8 points
+5. Order points by importance
+
+Text:
+{text}
+
+Key Points:
+"""
+    
+    def _create_questions_prompt(self, text: str, language: str) -> str:
+        """إنشاء prompt لأسئلة المراجعة"""
+        if language == 'ar':
+            return f"""
+أنشئ أسئلة مراجعة مفيدة من هذا النص:
+
+متطلبات:
+1. اكتب كل سؤال في سطر منفصل
+2. ابدأ كل سؤال برقم (1، 2، 3...)
+3. اجعل الأسئلة تغطي المفاهيم المهمة
+4. تنوع في أنواع الأسئلة (ما، كيف، لماذا، اشرح)
+5. لا تزيد عن 6 أسئلة
+6. اجعل الأسئلة مناسبة للامتحانات
+
+النص:
+{text}
+
+أسئلة المراجعة:
+"""
+        else:
+            return f"""
+Create useful review questions from this text:
+
+Requirements:
+1. Write each question on a separate line
+2. Start each question with a number (1, 2, 3...)
+3. Make questions cover important concepts
+4. Vary question types (what, how, why, explain)
+5. No more than 6 questions
+6. Make questions suitable for exams
+
+Text:
+{text}
+
+Review Questions:
+"""
+    
+    def _clean_summary_output(self, text: str) -> str:
+        """تنظيف نص الملخص"""
+        # إزالة الرموز غير المرغوبة
+        text = re.sub(r'\*+', '', text)
+        text = re.sub(r'#+', '', text)
+        text = text.strip()
+        
+        # تنظيف الأسطر الفارغة الزائدة
+        text = re.sub(r'\n\s*\n', '\n\n', text)
+        
+        return text
+    
+    def _parse_key_points(self, text: str) -> List[str]:
+        """تحليل النقاط الرئيسية من النص"""
+        points = []
+        lines = text.split('\n')
+        
+        for line in lines:
+            line = line.strip()
+            if line and (line.startswith('•') or line.startswith('-') or line.startswith('*')):
+                # إزالة الرمز من البداية
+                point = re.sub(r'^[•\-\*]\s*', '', line)
+                if point:
+                    points.append(point)
+            elif line and re.match(r'^\d+\.', line):
+                # نقاط مرقمة
+                point = re.sub(r'^\d+\.\s*', '', line)
+                if point:
+                    points.append(point)
+        
+        return points[:8]  # حد أقصى 8 نقاط
+    
+    def _parse_questions(self, text: str) -> List[str]:
+        """تحليل الأسئلة من النص"""
+        questions = []
+        lines = text.split('\n')
+        
+        for line in lines:
+            line = line.strip()
+            if line and ('؟' in line or '?' in line):
+                # إزالة الترقيم من البداية
+                question = re.sub(r'^\d+[\.\-\)]\s*', '', line)
+                if question:
+                    questions.append(question)
+        
+        return questions[:6]  # حد أقصى 6 أسئلة

templates/recorder.html

@@ -0,0 +1,1958 @@
+<!DOCTYPE html>
+<html lang="en" dir="ltr">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Lecture Recorder - SyncMaster</title>
+    <style>
+        :root {
+            --primary-color: #2563eb;
+            --primary-dark: #1d4ed8;
+            --success-color: #16a34a;
+            --danger-color: #dc2626;
+            --warning-color: #ea580c;
+            --neutral-100: #f5f5f5;
+            --neutral-200: #e5e5e5;
+            --neutral-300: #d4d4d8;
+            --neutral-600: #525252;
+            --neutral-700: #404040;
+            --neutral-800: #262626;
+            --neutral-900: #171717;
+            --white: #ffffff;
+            --text-primary: #0f172a;
+            --text-secondary: #64748b;
+            --border-radius: 8px;
+            --shadow-sm: 0 1px 2px 0 rgb(0 0 0 / 0.05);
+            --shadow-md: 0 4px 6px -1px rgb(0 0 0 / 0.1);
+            --shadow-lg: 0 10px 15px -3px rgb(0 0 0 / 0.1);
+        }
+        
+        /* RTL Support for Arabic */
+        html[dir="rtl"] {
+            direction: rtl;
+        }
+        
+        html[dir="rtl"] .language-selector {
+            left: 20px;
+            right: auto;
+        }
+        
+        * {
+            box-sizing: border-box;
+        }
+        
+        body {
+            font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
+            margin: 0;
+            padding: 20px;
+            min-height: 100vh;
+            background: linear-gradient(135deg, #f1f5f9 0%, #e2e8f0 100%);
+            color: var(--text-primary);
+            display: flex;
+            align-items: center;
+            justify-content: center;
+        }
+        
+        .recorder-container {
+            background: var(--white);
+            border-radius: 16px;
+            box-shadow: var(--shadow-lg);
+            width: 100%;
+            max-width: 640px;
+            padding: 32px;
+            text-align: center;
+            position: relative;
+        }
+        
+        /* Language Selector */
+        .language-selector {
+            position: absolute;
+            top: 20px;
+            right: 20px;
+            z-index: 100;
+        }
+        
+        .language-selector select {
+            padding: 8px 12px;
+            border: 1px solid var(--neutral-300);
+            border-radius: var(--border-radius);
+            background: var(--white);
+            color: var(--text-primary);
+            font-size: 14px;
+            font-weight: 500;
+            cursor: pointer;
+            outline: none;
+        }
+        
+        .language-selector select:focus {
+            border-color: var(--primary-color);
+            box-shadow: 0 0 0 3px rgb(37 99 235 / 0.1);
+        }
+        
+        /* Translation Controls */
+        .translation-controls {
+            margin: 24px 0;
+            padding: 20px;
+            background: var(--neutral-100);
+            border-radius: var(--border-radius);
+            border: 1px solid var(--neutral-200);
+        }
+        
+        .translation-toggle {
+            display: flex;
+            align-items: center;
+            justify-content: center;
+            gap: 16px;
+            margin-bottom: 12px;
+            flex-wrap: wrap;
+        }
+        
+        .toggle-switch {
+            position: relative;
+            width: 48px;
+            height: 24px;
+        }
+        
+        .toggle-switch input {
+            opacity: 0;
+            width: 0;
+            height: 0;
+        }
+        
+        .slider {
+            position: absolute;
+            cursor: pointer;
+            top: 0;
+            left: 0;
+            right: 0;
+            bottom: 0;
+            background-color: var(--neutral-300);
+            border-radius: 24px;
+            transition: background-color 0.3s ease;
+        }
+        
+        .slider:before {
+            position: absolute;
+            content: "";
+            height: 18px;
+            width: 18px;
+            left: 3px;
+            bottom: 3px;
+            background-color: var(--white);
+            border-radius: 50%;
+            transition: transform 0.3s ease;
+            box-shadow: var(--shadow-sm);
+        }
+        
+        input:checked + .slider {
+            background-color: var(--primary-color);
+        }
+        
+        input:checked + .slider:before {
+            transform: translateX(24px);
+        }
+        
+        .target-language-select {
+            padding: 8px 12px;
+            border: 1px solid var(--neutral-300);
+            border-radius: var(--border-radius);
+            background: var(--white);
+            min-width: 140px;
+            font-size: 14px;
+            color: var(--text-primary);
+        }
+        
+        .target-language-select:focus {
+            border-color: var(--primary-color);
+            outline: none;
+            box-shadow: 0 0 0 3px rgb(37 99 235 / 0.1);
+        }
+        
+        h2 {
+            margin-top: 0;
+            margin-bottom: 8px;
+            color: var(--text-primary);
+            font-size: 28px;
+            font-weight: 700;
+            letter-spacing: -0.025em;
+        }
+        
+        .subtitle {
+            color: var(--text-secondary);
+            margin-bottom: 32px;
+            font-size: 16px;
+            line-height: 1.5;
+        }
+        
+        .button-group {
+            margin-top: 24px;
+            display: grid;
+            grid-template-columns: repeat(auto-fit, minmax(140px, 1fr));
+            gap: 12px;
+        }
+        
+        .button {
+            color: var(--white);
+            border: none;
+            padding: 12px 20px;
+            font-size: 14px;
+            font-weight: 600;
+            border-radius: var(--border-radius);
+            cursor: pointer;
+            display: flex;
+            align-items: center;
+            justify-content: center;
+            gap: 8px;
+            min-height: 44px;
+            text-transform: none;
+            letter-spacing: normal;
+            transition: none;
+        }
+        
+        .button:disabled {
+            opacity: 0.5;
+            cursor: not-allowed;
+        }
+        
+        .button:focus {
+            outline: none;
+            box-shadow: 0 0 0 3px rgb(0 0 0 / 0.1);
+        }
+        
+        #recordButton { 
+            background: var(--success-color);
+        }
+        
+        #stopButton { 
+            background: var(--danger-color);
+        }
+        
+        #pauseButton { 
+            background: var(--warning-color);
+        }
+        
+        #markButton { 
+            background: var(--primary-color);
+        }
+        
+        #extractButton { 
+            background: var(--primary-color);
+        }
+        
+        #rerecordButton { 
+            background: var(--neutral-600);
+        }
+
+        .status-display {
+            margin: 24px 0;
+            font-size: 16px;
+            color: var(--text-secondary);
+            display: flex;
+            align-items: center;
+            justify-content: center;
+            gap: 12px;
+            font-weight: 500;
+        }
+        
+        .recording-indicator {
+            width: 10px;
+            height: 10px;
+            background-color: var(--danger-color);
+            border-radius: 50%;
+            animation: pulse 2s infinite;
+        }
+        
+        @keyframes pulse {
+            0%, 100% { 
+                opacity: 1; 
+                transform: scale(1);
+            }
+            50% { 
+                opacity: 0.5; 
+                transform: scale(1.1);
+            }
+        }
+        
+        #timer {
+            font-size: 36px;
+            font-weight: 300;
+            margin: 20px 0;
+            color: var(--primary-color);
+            font-family: 'SF Mono', 'Monaco', 'Inconsolata', 'Roboto Mono', monospace;
+            letter-spacing: 0.05em;
+        }
+        
+        #audio-level-container {
+            width: 100%;
+            height: 6px;
+            background-color: var(--neutral-200);
+            border-radius: 3px;
+            overflow: hidden;
+            margin: 20px 0;
+        }
+        
+        #audio-level-indicator {
+            width: 0%;
+            height: 100%;
+            background: linear-gradient(90deg, var(--success-color), var(--warning-color), var(--danger-color));
+            transition: width 0.1s ease;
+        }
+        
+        #review-section, #transcription-container {
+            margin-top: 32px;
+            text-align: left;
+        }
+        
+        .section-title {
+            font-size: 18px;
+            font-weight: 600;
+            margin-bottom: 16px;
+            color: var(--text-primary);
+            border-bottom: 2px solid var(--primary-color);
+            padding-bottom: 8px;
+        }
+        
+        textarea {
+            width: 100%;
+            border-radius: var(--border-radius);
+            border: 1px solid var(--neutral-300);
+            padding: 16px;
+            font-family: inherit;
+            resize: vertical;
+            font-size: 14px;
+            line-height: 1.6;
+            color: var(--text-primary);
+            background: var(--white);
+        }
+        
+        textarea:focus {
+            outline: none;
+            border-color: var(--primary-color);
+            box-shadow: 0 0 0 3px rgb(37 99 235 / 0.1);
+        }
+        
+        .translation-result {
+            margin-top: 20px;
+            padding: 20px;
+            background: var(--neutral-100);
+            border-radius: var(--border-radius);
+            border: 1px solid var(--neutral-200);
+        }
+        
+        .translation-header {
+            font-weight: 600;
+            color: var(--primary-color);
+            margin-bottom: 12px;
+            font-size: 16px;
+        }
+        
+        .language-info {
+            margin-top: 12px;
+            font-size: 13px;
+            color: var(--text-secondary);
+            padding: 8px 12px;
+            background: var(--white);
+            border-radius: var(--border-radius);
+            border: 1px solid var(--neutral-200);
+        }
+        
+        /* Loading Spinner */
+        .loading-spinner {
+            display: inline-block;
+            width: 20px;
+            height: 20px;
+            border: 2px solid var(--neutral-300);
+            border-top: 2px solid var(--primary-color);
+            border-radius: 50%;
+            animation: spin 1s linear infinite;
+        }
+        
+        @keyframes spin {
+            0% { transform: rotate(0deg); }
+            100% { transform: rotate(360deg); }
+        }
+        
+        /* Messages */
+        .error-message {
+            background: #fef2f2;
+            color: var(--danger-color);
+            padding: 12px 16px;
+            border-radius: var(--border-radius);
+            margin: 12px 0;
+            border: 1px solid #fecaca;
+            font-size: 14px;
+        }
+        
+        .success-message {
+            background: #f0fdf4;
+            color: var(--success-color);
+            padding: 12px 16px;
+            border-radius: var(--border-radius);
+            margin: 12px 0;
+            border: 1px solid #bbf7d0;
+            font-size: 14px;
+        }
+        
+        .translation-status {
+            font-size: 12px;
+            padding: 6px 10px;
+            border-radius: 4px;
+            margin-top: 8px;
+            font-weight: 500;
+        }
+        
+        /* Responsive Design */
+        @media (max-width: 768px) {
+            body {
+                padding: 12px;
+            }
+            
+            .recorder-container {
+                padding: 24px 20px;
+            }
+            
+            .button-group {
+                grid-template-columns: 1fr;
+                gap: 8px;
+            }
+            
+            #timer {
+                font-size: 28px;
+            }
+            
+            h2 {
+                font-size: 24px;
+            }
+            
+            .translation-toggle {
+                flex-direction: column;
+                gap: 12px;
+            }
+            
+            .language-selector {
+                position: static;
+                margin-bottom: 16px;
+                text-align: center;
+            }
+        }
+        
+        @media (max-width: 480px) {
+            .recorder-container {
+                padding: 20px 16px;
+            }
+            
+            h2 {
+                font-size: 20px;
+            }
+            
+            .subtitle {
+                font-size: 14px;
+            }
+            
+            #timer {
+                font-size: 24px;
+            }
+        }
+        
+        /* Focus indicators for accessibility */
+        .button:focus,
+        select:focus,
+        input:focus {
+            box-shadow: 0 0 0 3px rgb(37 99 235 / 0.1);
+        }
+
+        /* Summary and Notes Styles */
+        .note-item {
+            background: var(--white);
+            border: 1px solid var(--neutral-200);
+            border-radius: var(--border-radius);
+            padding: 20px;
+            margin-bottom: 16px;
+            transition: all 0.2s ease;
+        }
+
+        .note-item:hover {
+            border-color: var(--primary-color);
+            box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
+        }
+
+        .note-header {
+            display: flex;
+            justify-content: space-between;
+            align-items: flex-start;
+            margin-bottom: 12px;
+        }
+
+        .note-header h4 {
+            margin: 0;
+            color: var(--text-primary);
+            font-size: 16px;
+            font-weight: 600;
+        }
+
+        .note-date {
+            font-size: 12px;
+            color: var(--text-secondary);
+            white-space: nowrap;
+        }
+
+        .note-summary {
+            color: var(--text-secondary);
+            font-size: 14px;
+            line-height: 1.5;
+            margin-bottom: 12px;
+        }
+
+        .note-tags {
+            margin-bottom: 12px;
+        }
+
+        .tag {
+            display: inline-block;
+            background: var(--primary-color);
+            color: white;
+            padding: 4px 8px;
+            border-radius: 12px;
+            font-size: 12px;
+            margin-right: 6px;
+            margin-bottom: 4px;
+        }
+
+        .note-actions {
+            display: flex;
+            gap: 8px;
+        }
+
+        .btn-secondary {
+            background: var(--neutral-200);
+            color: var(--text-primary);
+            border: 1px solid var(--neutral-300);
+            padding: 6px 12px;
+            border-radius: 4px;
+            font-size: 12px;
+            cursor: pointer;
+            transition: all 0.2s ease;
+        }
+
+        .btn-secondary:hover {
+            background: var(--neutral-300);
+        }
+
+        .btn-danger {
+            background: #dc3545;
+            color: white;
+            border: 1px solid #dc3545;
+            padding: 6px 12px;
+            border-radius: 4px;
+            font-size: 12px;
+            cursor: pointer;
+            transition: all 0.2s ease;
+        }
+
+        .btn-danger:hover {
+            background: #c82333;
+            border-color: #c82333;
+        }
+
+        /* Modal Styles */
+        .note-modal {
+            position: fixed;
+            top: 0;
+            left: 0;
+            width: 100%;
+            height: 100%;
+            background: rgba(0, 0, 0, 0.5);
+            display: flex;
+            justify-content: center;
+            align-items: center;
+            z-index: 1000;
+            padding: 20px;
+        }
+
+        .note-modal-content {
+            background: var(--white);
+            border-radius: var(--border-radius);
+            max-width: 800px;
+            width: 100%;
+            max-height: 90vh;
+            overflow-y: auto;
+            box-shadow: 0 10px 30px rgba(0, 0, 0, 0.3);
+        }
+
+        .note-modal-header {
+            display: flex;
+            justify-content: space-between;
+            align-items: center;
+            padding: 20px 24px;
+            border-bottom: 1px solid var(--neutral-200);
+            position: sticky;
+            top: 0;
+            background: var(--white);
+            z-index: 1;
+        }
+
+        .note-modal-header h2 {
+            margin: 0;
+            color: var(--text-primary);
+            font-size: 20px;
+        }
+
+        .close-btn {
+            background: none;
+            border: none;
+            font-size: 24px;
+            cursor: pointer;
+            color: var(--text-secondary);
+            padding: 0;
+            width: 30px;
+            height: 30px;
+            display: flex;
+            align-items: center;
+            justify-content: center;
+            border-radius: 50%;
+            transition: all 0.2s ease;
+        }
+
+        .close-btn:hover {
+            background: var(--neutral-100);
+            color: var(--text-primary);
+        }
+
+        .note-modal-body {
+            padding: 24px;
+        }
+
+        .note-section {
+            margin-bottom: 24px;
+        }
+
+        .note-section h3 {
+            color: var(--primary-color);
+            font-size: 16px;
+            font-weight: 600;
+            margin-bottom: 12px;
+            border-bottom: 1px solid var(--neutral-200);
+            padding-bottom: 8px;
+        }
+
+        .note-section p {
+            color: var(--text-primary);
+            line-height: 1.6;
+            margin: 0;
+        }
+
+        .note-section ul {
+            margin: 0;
+            padding-left: 20px;
+        }
+
+        .note-section li {
+            color: var(--text-primary);
+            line-height: 1.6;
+            margin-bottom: 8px;
+        }
+
+        /* Search Styles */
+        .search-container {
+            margin-bottom: 20px;
+        }
+
+        .search-container input {
+            width: 100%;
+            padding: 12px 16px;
+            border: 1px solid var(--neutral-300);
+            border-radius: var(--border-radius);
+            font-size: 14px;
+            background: var(--white);
+            color: var(--text-primary);
+        }
+
+        .search-container input:focus {
+            outline: none;
+            border-color: var(--primary-color);
+            box-shadow: 0 0 0 3px rgb(37 99 235 / 0.1);
+        }
+
+        /* Empty state */
+        .text-center {
+            text-align: center;
+        }
+
+        .text-muted {
+            color: var(--text-secondary);
+        }
+
+        /* Form Styles for Summary Section */
+        .form-group {
+            margin-bottom: 16px;
+        }
+
+        .form-group label {
+            display: block;
+            margin-bottom: 6px;
+            font-weight: 500;
+            color: var(--text-primary);
+        }
+
+        .form-group input,
+        .form-group textarea {
+            width: 100%;
+            padding: 10px 12px;
+            border: 1px solid var(--neutral-300);
+            border-radius: 4px;
+            font-size: 14px;
+            background: var(--white);
+            color: var(--text-primary);
+        }
+
+        .form-group input:focus,
+        .form-group textarea:focus {
+            outline: none;
+            border-color: var(--primary-color);
+            box-shadow: 0 0 0 3px rgb(37 99 235 / 0.1);
+        }
+
+        /* Summary Content Styling */
+        .summary-content {
+            background: var(--neutral-50);
+            border: 1px solid var(--neutral-200);
+            border-radius: var(--border-radius);
+            padding: 16px;
+            margin-bottom: 16px;
+        }
+
+        .summary-content h4 {
+            color: var(--primary-color);
+            margin-bottom: 12px;
+            font-size: 16px;
+        }
+
+        .summary-content ul {
+            margin: 0;
+            padding-left: 20px;
+        }
+
+        .summary-content li {
+            margin-bottom: 8px;
+            line-height: 1.5;
+        }
+    </style>
+</head>
+<body>
+    <div class="recorder-container">
+        <!-- Language Selector -->
+        <div class="language-selector">
+            <select id="languageSelect" aria-label="Select Language">
+                <option value="en">English</option>
+                <option value="ar">العربية</option>
+            </select>
+        </div>
+        
+        <h2 id="main-title">Lecture Recorder</h2>
+        <p class="subtitle" id="subtitle">Record and transcribe your lectures with AI-powered translation</p>
+        
+        <!-- Translation Controls -->
+        <div class="translation-controls">
+            <div class="translation-toggle">
+                <label for="translationToggle" id="translation-label">Enable Translation:</label>
+                <label class="toggle-switch">
+                    <input type="checkbox" id="translationToggle" checked>
+                    <span class="slider"></span>
+                </label>
+                <select id="targetLanguage" class="target-language-select">
+                    <option value="ar">العربية (Arabic)</option>
+                    <option value="en">English</option>
+                    <option value="fr">Français</option>
+                    <option value="es">Español</option>
+                </select>
+            </div>
+        </div>
+        
+        <div id="recording-controls">
+            <div class="status-display">
+                <div id="recording-indicator" class="recording-indicator" style="display: none;"></div>
+                <span id="status">Ready to Record</span>
+            </div>
+            <div id="timer">00:00:00</div>
+            <div id="audio-level-container">
+                <div id="audio-level-indicator"></div>
+            </div>
+            <div class="button-group">
+                <button id="recordButton" class="button" aria-label="Start Recording">
+                    <span>🎙️</span>
+                    <span id="record-text">Start</span>
+                </button>
+                <button id="pauseButton" class="button" disabled aria-label="Pause Recording">
+                    <span>⏸️</span>
+                    <span id="pause-text">Pause</span>
+                </button>
+                <button id="stopButton" class="button" disabled aria-label="Stop Recording">
+                    <span>⏹️</span>
+                    <span id="stop-text">Stop</span>
+                </button>
+                <button id="markButton" class="button" disabled aria-label="Mark Important Point">
+                    <span>📌</span>
+                    <span id="mark-text">Mark Important</span>
+                </button>
+            </div>
+        </div>
+
+        <div id="review-section" style="display: none;">
+            <h3 class="section-title" id="review-title">Review Recording</h3>
+            <audio id="audio-playback" controls style="width: 100%;"></audio>
+            <div class="button-group">
+                <button id="extractButton" class="button" aria-label="Extract Text">
+                    <span>📄</span>
+                    <span id="extract-text">Extract Text</span>
+                </button>
+                <button id="rerecordButton" class="button" aria-label="Record Again">
+                    <span>🔄</span>
+                    <span id="rerecord-text">Re-record</span>
+                </button>
+            </div>
+        </div>
+
+        <div id="transcription-container" style="display: none;">
+            <h3 class="section-title" id="transcription-title">Processing Result</h3>
+            
+            <!-- Original Transcription -->
+            <div class="transcription-section">
+                <h4 id="original-text-label">Original Text:</h4>
+                <textarea id="original-transcription-box" rows="6" readonly></textarea>
+            </div>
+            
+            <!-- Translation Result -->
+            <div id="translation-section" class="translation-result" style="display: none;">
+                <h4 class="translation-header" id="translated-text-label">Arabic Translation:</h4>
+                <textarea id="translated-transcription-box" rows="6" readonly></textarea>
+                
+                <!-- Language Info -->
+                <div class="language-info" style="margin-top: 10px; font-size: 0.9em; color: #6c757d;">
+                    <span id="detected-language">Detected Language: Unknown</span> → 
+                    <span id="target-language-info">Arabic</span>
+                </div>
+            </div>
+            
+            <!-- Markers Section -->
+            <div id="markers-section" style="display: none; margin-top: 20px;">
+                <h4 id="markers-label">Important Markers:</h4>
+                <div id="markers-list" style="background: #f8f9fa; padding: 10px; border-radius: 6px;"></div>
+            </div>
+
+            <!-- Summary Action Button (Always Visible) -->
+            <div id="summary-action-section" style="display: none; margin-top: 24px; text-align: center;">
+                <button id="generateSummaryBtn" class="button" style="padding: 12px 24px; font-size: 16px; min-height: auto; background: var(--primary-color); color: white;">
+                    <span>🤖</span>
+                    <span>Generate Smart Lecture Summary</span>
+                </button>
+            </div>
+            
+            <!-- Smart Summary Section -->
+            <div id="summary-section" style="display: none; margin-top: 24px;">
+                <div class="section-title">
+                    <span>📝 Smart Summary</span>
+                </div>
+                
+                <!-- Summary Content -->
+                <div id="summary-content" style="background: var(--neutral-100); border-radius: var(--border-radius); padding: 16px; margin-top: 12px;">
+                    
+                    <!-- Summary Text -->
+                    <div id="summary-text-section" style="display: none;">
+                        <h5 style="color: var(--primary-color); margin: 0 0 8px 0; font-size: 14px;">📋 Summary:</h5>
+                        <div id="summary-text" style="background: var(--white); padding: 12px; border-radius: 6px; border: 1px solid var(--neutral-200); line-height: 1.6; font-size: 14px;"></div>
+                    </div>
+                    
+                    <!-- Key Points -->
+                    <div id="key-points-section" style="display: none; margin-top: 16px;">
+                        <h5 style="color: var(--primary-color); margin: 0 0 8px 0; font-size: 14px;">🎯 Key Points:</h5>
+                        <ul id="key-points-list" style="background: var(--white); padding: 12px; border-radius: 6px; border: 1px solid var(--neutral-200); margin: 0;"></ul>
+                    </div>
+                    
+                    <!-- Review Questions -->
+                    <div id="questions-section" style="display: none; margin-top: 16px;">
+                        <h5 style="color: var(--primary-color); margin: 0 0 8px 0; font-size: 14px;">❓ Review Questions:</h5>
+                        <ol id="questions-list" style="background: var(--white); padding: 12px; border-radius: 6px; border: 1px solid var(--neutral-200); margin: 0;"></ol>
+                    </div>
+                    
+                    <!-- Save Note Section -->
+                    <div id="save-note-section" style="display: none; margin-top: 16px; padding-top: 16px; border-top: 1px solid var(--neutral-200);">
+                        <h5 style="color: var(--primary-color); margin: 0 0 8px 0; font-size: 14px;">💾 Save to Notes:</h5>
+                        <div style="display: grid; grid-template-columns: 1fr 1fr; gap: 8px; margin-bottom: 12px;">
+                            <input type="text" id="noteTitle" placeholder="Note title..." style="padding: 8px; border: 1px solid var(--neutral-300); border-radius: 4px; font-size: 14px;">
+                            <input type="text" id="noteTags" placeholder="Tags (comma separated)..." style="padding: 8px; border: 1px solid var(--neutral-300); border-radius: 4px; font-size: 14px;">
+                        </div>
+                        <button id="saveNoteBtn" class="button" style="width: 100%; padding: 8px; font-size: 14px; min-height: auto;">
+                            <span>💾</span>
+                            <span>Save Note</span>
+                        </button>
+                    </div>
+                </div>
+            </div>
+            
+            <!-- Notes Library Section -->
+            <div id="notes-library-section" style="display: none; margin-top: 24px;">
+                <div class="section-title" style="display: flex; align-items: center; justify-content: space-between;">
+                    <span>📚 مكتبة المذكرات</span>
+                    <div style="display: flex; gap: 8px;">
+                        <button id="refreshNotesBtn" class="button" style="padding: 6px 12px; font-size: 12px; min-height: auto;">
+                            <span>🔄</span>
+                            <span>تحديث</span>
+                        </button>
+                        <button id="toggleNotesBtn" class="button" style="padding: 6px 12px; font-size: 12px; min-height: auto;">
+                            <span>📖</span>
+                            <span>عرض المذكرات</span>
+                        </button>
+                    </div>
+                </div>
+                
+                <!-- Search and Filter -->
+                <div id="notes-controls" style="display: none; margin-top: 12px; padding: 16px; background: var(--neutral-100); border-radius: var(--border-radius);">
+                    <div style="display: grid; grid-template-columns: 1fr auto; gap: 8px; margin-bottom: 12px;">
+                        <input type="text" id="notes-search" placeholder="البحث في المذكرات..." style="padding: 8px; border: 1px solid var(--neutral-300); border-radius: 4px; font-size: 14px;">
+                        <select id="subject-filter" style="padding: 8px; border: 1px solid var(--neutral-300); border-radius: 4px; font-size: 14px; min-width: 120px;">
+                            <option value="">جميع المواد</option>
+                        </select>
+                    </div>
+                    <button id="searchNotesBtn" class="button" style="padding: 6px 16px; font-size: 12px; min-height: auto;">
+                        <span>🔍</span>
+                        <span>بحث</span>
+                    </button>
+                </div>
+                
+                <!-- Notes List -->
+                <div id="notes-list" style="display: none; margin-top: 12px; max-height: 400px; overflow-y: auto;">
+                    <!-- Notes will be loaded here -->
+                </div>
+            </div>
+        </div>
+        
+        <!-- Loading Indicator -->
+        <div id="loading-indicator" style="display: none; margin: 20px 0;">
+            <div class="loading-spinner"></div>
+            <span id="loading-text" style="margin-left: 10px;">Processing...</span>
+        </div>
+        
+        <!-- Error/Success Messages -->
+        <div id="message-container"></div>
+    </div>
+
+    <script>
+        // --- Global Variables ---
+        let currentLanguage = 'en';
+        let translations = {};
+        
+        // --- DOM Elements ---
+        const elements = {
+            recordButton: document.getElementById('recordButton'),
+            stopButton: document.getElementById('stopButton'),
+            pauseButton: document.getElementById('pauseButton'),
+            markButton: document.getElementById('markButton'),
+            extractButton: document.getElementById('extractButton'),
+            rerecordButton: document.getElementById('rerecordButton'),
+            status: document.getElementById('status'),
+            timer: document.getElementById('timer'),
+            recordingIndicator: document.getElementById('recording-indicator'),
+            audioLevelIndicator: document.getElementById('audio-level-indicator'),
+            reviewSection: document.getElementById('review-section'),
+            audioPlayback: document.getElementById('audio-playback'),
+            transcriptionContainer: document.getElementById('transcription-container'),
+            originalTranscriptionBox: document.getElementById('original-transcription-box'),
+            translatedTranscriptionBox: document.getElementById('translated-transcription-box'),
+            recordingControls: document.getElementById('recording-controls'),
+            languageSelect: document.getElementById('languageSelect'),
+            translationToggle: document.getElementById('translationToggle'),
+            targetLanguage: document.getElementById('targetLanguage'),
+            translationSection: document.getElementById('translation-section'),
+            markersSection: document.getElementById('markers-section'),
+            markersList: document.getElementById('markers-list'),
+            loadingIndicator: document.getElementById('loading-indicator'),
+            messageContainer: document.getElementById('message-container')
+        };
+
+        // --- State ---
+        let state = {
+            mediaRecorder: null,
+            audioChunks: [],
+            audioBlob: null,
+            timerInterval: null,
+            seconds: 0,
+            microphoneStream: null,
+            markers: [],
+            currentResult: null
+        };
+
+        // --- Event Listeners ---
+        elements.recordButton.addEventListener('click', startRecording);
+        elements.stopButton.addEventListener('click', stopRecording);
+        elements.pauseButton.addEventListener('click', togglePause);
+        elements.markButton.addEventListener('click', markTimestamp);
+        elements.extractButton.addEventListener('click', processAudio);
+        elements.rerecordButton.addEventListener('click', resetRecorder);
+        elements.languageSelect.addEventListener('change', changeLanguage);
+        elements.translationToggle.addEventListener('change', toggleTranslationUI);
+        elements.targetLanguage.addEventListener('change', updateTargetLanguageInfo);
+
+        // --- Translation System ---
+        async function loadTranslations(language) {
+            try {
+                const response = await fetch(`http://localhost:5001/ui-translations/${language}`);
+                if (response.ok) {
+                    const data = await response.json();
+                    if (data.success) {
+                        translations = data.translations;
+                        applyTranslations();
+                        
+                        // Update HTML direction for RTL languages
+                        if (language === 'ar') {
+                            document.documentElement.setAttribute('dir', 'rtl');
+                            document.documentElement.setAttribute('lang', 'ar');
+                        } else {
+                            document.documentElement.setAttribute('dir', 'ltr');
+                            document.documentElement.setAttribute('lang', language);
+                        }
+                    }
+                }
+            } catch (error) {
+                console.error('Failed to load translations:', error);
+                // Fallback to default English
+                translations = getDefaultTranslations();
+                applyTranslations();
+            }
+        }
+
+        function getDefaultTranslations() {
+            return {
+                'start_recording': 'Start Recording',
+                'stop_recording': 'Stop Recording',
+                'pause_recording': 'Pause Recording',
+                'resume_recording': 'Resume Recording',
+                'mark_important': 'Mark Important',
+                'extract_text': 'Extract Text',
+                'rerecord': 'Re-record',
+                'processing': 'Processing...',
+                'ready_to_record': 'Ready to Record',
+                'recording': 'Recording...',
+                'paused': 'Paused',
+                'review_recording': 'Review your recording',
+                'processing_complete': 'Processing Complete!',
+                'microphone_permission': 'Microphone permission denied.',
+                'browser_not_supported': 'Your browser does not support audio recording.',
+                'transcription': 'Transcription',
+                'translation': 'Translation',
+                'markers': 'Important Markers',
+                'error_occurred': 'An error occurred',
+                'success': 'Success'
+            };
+        }
+
+        function applyTranslations() {
+            // Update text elements
+            const textMappings = {
+                'main-title': 'Lecture Recorder',
+                'subtitle': 'Record and transcribe your lectures with AI-powered translation',
+                'translation-label': 'Enable Translation:',
+                'record-text': translations.start_recording || 'Start',
+                'pause-text': translations.pause_recording || 'Pause',
+                'stop-text': translations.stop_recording || 'Stop',
+                'mark-text': translations.mark_important || 'Mark Important',
+                'extract-text': translations.extract_text || 'Extract Text',
+                'rerecord-text': translations.rerecord || 'Re-record',
+                'review-title': translations.review_recording || 'Review Recording',
+                'transcription-title': translations.processing_complete || 'Processing Result',
+                'original-text-label': 'Original Text:',
+                'translated-text-label': getTargetLanguageName() + ' Translation:',
+                'markers-label': translations.markers || 'Important Markers'
+            };
+
+            Object.entries(textMappings).forEach(([id, text]) => {
+                const element = document.getElementById(id);
+                if (element) {
+                    element.textContent = text;
+                }
+            });
+        }
+
+        function getTargetLanguageName() {
+            const langMap = {
+                'ar': 'Arabic (العربية)',
+                'en': 'English',
+                'fr': 'French (Français)',
+                'es': 'Spanish (Español)'
+            };
+            return langMap[elements.targetLanguage.value] || 'Translation';
+        }
+
+        async function changeLanguage() {
+            currentLanguage = elements.languageSelect.value;
+            await loadTranslations(currentLanguage);
+        }
+
+        function toggleTranslationUI() {
+            const isEnabled = elements.translationToggle.checked;
+            elements.targetLanguage.disabled = !isEnabled;
+            updateTargetLanguageInfo();
+            
+            // Show/hide translation section preview
+            updateTranslationSectionVisibility();
+        }
+        
+        function updateTranslationSectionVisibility() {
+            // Always prepare translation section when translation is enabled
+            if (elements.translationToggle.checked) {
+                // Make sure translation section is ready to be shown
+                const translatedLabelElement = document.getElementById('translated-text-label');
+                if (translatedLabelElement) {
+                    translatedLabelElement.textContent = getTargetLanguageName() + ' Translation:';
+                }
+            }
+        }
+
+        function updateTargetLanguageInfo() {
+            const targetLangElement = document.getElementById('target-language-info');
+            if (targetLangElement) {
+                targetLangElement.textContent = getTargetLanguageName();
+            }
+            
+            const translatedLabelElement = document.getElementById('translated-text-label');
+            if (translatedLabelElement) {
+                translatedLabelElement.textContent = getTargetLanguageName() + ' Translation:';
+            }
+        }
+        // --- Core Recording Functions ---
+        async function startRecording() {
+            if (!navigator.mediaDevices || !navigator.mediaDevices.getUserMedia) {
+                showMessage(translations.browser_not_supported || 'Your browser does not support audio recording.', 'error');
+                return;
+            }
+            try {
+                state.microphoneStream = await navigator.mediaDevices.getUserMedia({ audio: true });
+                updateUIMode('recording');
+                
+                state.audioChunks = [];
+                state.markers = [];
+                state.mediaRecorder = new MediaRecorder(state.microphoneStream);
+                state.mediaRecorder.ondataavailable = event => state.audioChunks.push(event.data);
+                state.mediaRecorder.onstop = handleRecordingStop;
+                
+                state.mediaRecorder.start();
+                startTimer();
+                visualizeAudio(state.microphoneStream);
+            } catch (error) {
+                showMessage(translations.microphone_permission || 'Microphone permission denied.', 'error');
+                console.error('Error accessing microphone:', error);
+            }
+        }
+
+        function stopRecording() {
+            if (state.mediaRecorder && state.mediaRecorder.state !== 'inactive') {
+                state.mediaRecorder.stop();
+            }
+        }
+
+        function handleRecordingStop() {
+            state.audioBlob = new Blob(state.audioChunks, { type: 'audio/wav' });
+            elements.audioPlayback.src = URL.createObjectURL(state.audioBlob);
+            state.microphoneStream.getTracks().forEach(track => track.stop());
+            clearInterval(state.timerInterval);
+            updateUIMode('review');
+        }
+
+        function togglePause() {
+            if (!state.mediaRecorder) return;
+            if (state.mediaRecorder.state === 'recording') {
+                state.mediaRecorder.pause();
+                updateUIMode('paused');
+            } else if (state.mediaRecorder.state === 'paused') {
+                state.mediaRecorder.resume();
+                updateUIMode('recording');
+            }
+        }
+
+        function markTimestamp() {
+            state.markers.push(state.seconds);
+            const markCount = state.markers.length;
+            elements.markButton.innerHTML = `<span>📌</span><span>Marked (${markCount})</span>`;
+            setTimeout(() => {
+                elements.markButton.innerHTML = `<span>📌</span><span>${translations.mark_important || 'Mark Important'}</span>`;
+            }, 1000);
+        }
+
+        async function processAudio() {
+            if (!state.audioBlob) return;
+            updateUIMode('processing');
+
+            const formData = new FormData();
+            formData.append('audio_data', state.audioBlob, 'recording.wav');
+            formData.append('markers', JSON.stringify(state.markers));
+            formData.append('enable_translation', elements.translationToggle.checked.toString());
+            formData.append('target_language', elements.targetLanguage.value);
+
+            try {
+                // Try multiple server URLs in case of port conflicts
+                const serverUrls = [
+                    'http://localhost:5001/record',
+                    'http://127.0.0.1:5001/record',
+                    'http://localhost:5000/record'
+                ];
+                
+                let response = null;
+                let lastError = null;
+                
+                for (const url of serverUrls) {
+                    try {
+                        console.log(`Trying server URL: ${url}`);
+                        response = await fetch(url, { 
+                            method: 'POST', 
+                            body: formData,
+                            timeout: 30000 // 30 seconds timeout
+                        });
+                        
+                        if (response.ok) {
+                            console.log(`Successfully connected to: ${url}`);
+                            break;
+                        }
+                    } catch (error) {
+                        console.log(`Failed to connect to ${url}:`, error.message);
+                        lastError = error;
+                        continue;
+                    }
+                }
+                
+                if (!response || !response.ok) {
+                    throw new Error(`Server connection failed. Last error: ${lastError?.message || 'Unknown error'}`);
+                }
+                
+                const result = await response.json();
+                
+                // Debug logging for translation analysis
+                console.log('🔍 SERVER RESPONSE ANALYSIS:');
+                console.log('- Success:', result.success);
+                console.log('- Translation enabled:', result.translation_enabled);
+                console.log('- Translation success:', result.translation_success);
+                console.log('- Original text:', result.original_text?.substring(0, 50) + '...');
+                console.log('- Translated text:', result.translated_text?.substring(0, 50) + '...');
+                console.log('- Target language:', result.target_language);
+                console.log('- Detected language:', result.language_detected);
+                console.log('- Are texts different?:', result.translated_text !== result.original_text);
+                
+                if (result.success) {
+                    state.currentResult = result;
+                    console.log('💾 STORED RESULT IN STATE:');
+                    console.log('- Complete result object:', result);
+                    console.log('- Available keys:', Object.keys(result));
+                    console.log('- state.currentResult set to:', state.currentResult);
+                    displayResults(result);
+                    updateUIMode('result');
+                    showMessage(translations.success || 'Success!', 'success');
+                } else {
+                    throw new Error(result.error || 'Processing failed');
+                }
+            } catch (error) {
+                updateUIMode('review');
+                const errorMessage = `${translations.error_occurred || 'Error'}: ${error.message}`;
+                showMessage(errorMessage, 'error');
+                console.error("Processing Error:", error);
+                
+                // Show detailed error for debugging
+                const detailedError = document.createElement('div');
+                detailedError.className = 'error-message';
+                detailedError.innerHTML = `
+                    <strong>Connection Error Details:</strong><br>
+                    • Make sure the recorder server is running on port 5001<br>
+                    • Try running: <code>python recorder_server.py</code><br>
+                    • Check if port 5001 is available<br>
+                    • Error: ${error.message}
+                `;
+                elements.messageContainer.appendChild(detailedError);
+            }
+        }
+
+        function displayResults(result) {
+            console.log('🎯 DISPLAY RESULTS FUNCTION:');
+            console.log('- Translation enabled:', result.translation_enabled);
+            console.log('- Has translated text:', !!result.translated_text);
+            console.log('- Translation section element:', !!elements.translationSection);
+            
+            // Display original transcription
+            elements.originalTranscriptionBox.value = result.original_text || result.text || '';
+            
+            // Always show translation section if translation toggle is enabled or we have translated text
+            const shouldShowTranslation = (
+                elements.translationToggle.checked || 
+                (result.translated_text && result.translated_text.trim())
+            );
+            
+            console.log('- Should show translation:', shouldShowTranslation);
+            console.log('- Translation toggle checked:', elements.translationToggle.checked);
+            console.log('- Has translated text content:', !!(result.translated_text && result.translated_text.trim()));
+            
+            if (shouldShowTranslation) {
+                console.log('✅ Showing translation section');
+                
+                // Set translated text or show placeholder if no translation
+                if (result.translated_text && result.translated_text.trim()) {
+                    elements.translatedTranscriptionBox.value = result.translated_text;
+                } else {
+                    elements.translatedTranscriptionBox.value = result.original_text || 'Translation in progress...';
+                }
+                
+                elements.translationSection.style.display = 'block';
+                
+                // Update language info
+                const detectedLangElement = document.getElementById('detected-language');
+                const targetLangElement = document.getElementById('target-language-info');
+                if (detectedLangElement) {
+                    const detectedLang = result.language_detected || 'Unknown';
+                    detectedLangElement.textContent = `Detected Language: ${detectedLang}`;
+                }
+                if (targetLangElement) {
+                    targetLangElement.textContent = getTargetLanguageName();
+                }
+                
+                // Add status indicator for translation quality
+                const translationStatus = document.createElement('div');
+                translationStatus.style.cssText = 'margin-top: 5px; font-size: 0.8em; padding: 3px 8px; border-radius: 4px;';
+                
+                if (result.translation_success === true) {
+                    translationStatus.style.backgroundColor = '#d4edda';
+                    translationStatus.style.color = '#155724';
+                    translationStatus.textContent = '✓ Translation successful';
+                } else if (!result.translated_text || result.translated_text === result.original_text) {
+                    translationStatus.style.backgroundColor = '#fff3cd';
+                    translationStatus.style.color = '#856404';
+                    translationStatus.textContent = '⚠ Translation failed - showing original text';
+                } else {
+                    translationStatus.style.backgroundColor = '#cce7ff';
+                    translationStatus.style.color = '#004085';
+                    translationStatus.textContent = '🔄 Translation completed';
+                }
+                
+                // Remove existing status if any
+                const existingStatus = elements.translationSection.querySelector('.translation-status');
+                if (existingStatus) {
+                    existingStatus.remove();
+                }
+                
+                // Add status indicator
+                translationStatus.className = 'translation-status';
+                elements.translationSection.appendChild(translationStatus);
+                
+            } else {
+                console.log('❌ Hiding translation section - conditions not met');
+                elements.translationSection.style.display = 'none';
+            }
+            
+            // Display markers if available
+            if (result.markers && result.markers.length > 0) {
+                displayMarkers(result.markers);
+                elements.markersSection.style.display = 'block';
+            } else {
+                elements.markersSection.style.display = 'none';
+            }
+
+            // Show summary button after successful transcription
+            const summaryActionSection = document.getElementById('summary-action-section');
+            if (summaryActionSection) {
+                summaryActionSection.style.display = 'block';
+            }
+        }
+
+        function displayMarkers(markers) {
+            const markersList = elements.markersList;
+            markersList.innerHTML = '';
+            
+            markers.forEach((timestamp, index) => {
+                const markerElement = document.createElement('span');
+                markerElement.style.cssText = 'display: inline-block; margin: 2px 5px; padding: 2px 8px; background: #007bff; color: white; border-radius: 12px; font-size: 0.85em;';
+                markerElement.textContent = `${index + 1}: ${formatTime(timestamp)}`;
+                markersList.appendChild(markerElement);
+            });
+        }
+
+        function resetRecorder() {
+            state = { 
+                ...state, 
+                audioChunks: [], 
+                audioBlob: null, 
+                seconds: 0, 
+                markers: [],
+                currentResult: null,
+                currentSummary: null
+            };
+            clearInterval(state.timerInterval);
+            elements.translationSection.style.display = 'none';
+            elements.markersSection.style.display = 'none';
+            
+            // Hide summary sections
+            const summaryActionSection = document.getElementById('summary-action-section');
+            const summarySection = document.getElementById('summary-section');
+            if (summaryActionSection) summaryActionSection.style.display = 'none';
+            if (summarySection) summarySection.style.display = 'none';
+            
+            updateUIMode('idle');
+        }
+
+        function updateUIMode(mode) {
+            const isRecording = mode === 'recording';
+            const isPaused = mode === 'paused';
+            const isReview = mode === 'review';
+            const isProcessing = mode === 'processing';
+            const isResult = mode === 'result';
+            const isIdle = mode === 'idle';
+
+            // Button states
+            elements.recordButton.disabled = !isIdle;
+            elements.stopButton.disabled = !isRecording && !isPaused;
+            elements.pauseButton.disabled = !isRecording && !isPaused;
+            elements.markButton.disabled = !isRecording && !isPaused;
+            elements.extractButton.disabled = !isReview;
+            elements.rerecordButton.disabled = !isReview && !isResult;
+
+            // UI Visibility
+            elements.recordingControls.style.display = (isReview || isResult || isProcessing) ? 'none' : 'block';
+            elements.reviewSection.style.display = (isReview || isResult) ? 'block' : 'none';
+            elements.transcriptionContainer.style.display = isResult ? 'block' : 'none';
+            elements.loadingIndicator.style.display = isProcessing ? 'block' : 'none';
+
+            // Recording indicator
+            elements.recordingIndicator.style.display = isRecording ? 'block' : 'none';
+
+            // Button text updates
+            const pauseTextElement = document.getElementById('pause-text');
+            if (pauseTextElement) {
+                pauseTextElement.textContent = isPaused ? 
+                    (translations.resume_recording || 'Resume') : 
+                    (translations.pause_recording || 'Pause');
+            }
+
+            // Status updates
+            if (isIdle) {
+                elements.status.textContent = translations.ready_to_record || 'Ready to Record';
+                elements.timer.textContent = '00:00:00';
+                elements.audioLevelIndicator.style.width = '0%';
+            } else if (isRecording) {
+                elements.status.textContent = translations.recording || 'Recording...';
+            } else if (isPaused) {
+                elements.status.textContent = translations.paused || 'Paused';
+            } else if (isReview) {
+                elements.status.textContent = translations.review_recording || 'Review your recording';
+            } else if (isProcessing) {
+                elements.status.textContent = translations.processing || 'Processing... please wait';
+                const loadingTextElement = document.getElementById('loading-text');
+                if (loadingTextElement) {
+                    loadingTextElement.textContent = translations.processing || 'Processing...';
+                }
+            } else if (isResult) {
+                elements.status.textContent = translations.processing_complete || 'Processing Complete!';
+            }
+        }
+
+        function startTimer() {
+            state.seconds = 0;
+            state.timerInterval = setInterval(() => {
+                state.seconds++;
+                elements.timer.textContent = formatTime(state.seconds);
+            }, 1000);
+        }
+
+        function formatTime(totalSeconds) {
+            const hours = Math.floor(totalSeconds / 3600).toString().padStart(2, '0');
+            const minutes = Math.floor((totalSeconds % 3600) / 60).toString().padStart(2, '0');
+            const seconds = (totalSeconds % 60).toString().padStart(2, '0');
+            return `${hours}:${minutes}:${seconds}`;
+        }
+
+        function visualizeAudio(stream) {
+            const audioContext = new (window.AudioContext || window.webkitAudioContext)();
+            const analyser = audioContext.createAnalyser();
+            const microphone = audioContext.createMediaStreamSource(stream);
+            microphone.connect(analyser);
+            analyser.fftSize = 256;
+            const dataArray = new Uint8Array(analyser.frequencyBinCount);
+
+            function draw() {
+                if (state.mediaRecorder && state.mediaRecorder.state === 'inactive') return;
+                requestAnimationFrame(draw);
+                analyser.getByteFrequencyData(dataArray);
+                const avg = dataArray.reduce((a, b) => a + b, 0) / dataArray.length;
+                elements.audioLevelIndicator.style.width = `${(avg / 128) * 100}%`;
+            }
+            draw();
+        }
+
+        function showMessage(message, type = 'info') {
+            const messageElement = document.createElement('div');
+            messageElement.className = `${type}-message`;
+            messageElement.textContent = message;
+            
+            elements.messageContainer.innerHTML = '';
+            elements.messageContainer.appendChild(messageElement);
+            
+            // Auto-hide after 5 seconds
+            setTimeout(() => {
+                if (elements.messageContainer.contains(messageElement)) {
+                    elements.messageContainer.removeChild(messageElement);
+                }
+            }, 5000);
+        }
+
+        // --- Keyboard Shortcuts ---
+        document.addEventListener('keydown', function(event) {
+            if (event.target.tagName === 'TEXTAREA' || event.target.tagName === 'INPUT') return;
+            
+            switch(event.code) {
+                case 'Space':
+                    event.preventDefault();
+                    if (!elements.recordButton.disabled) {
+                        startRecording();
+                    } else if (!elements.stopButton.disabled) {
+                        stopRecording();
+                    }
+                    break;
+                case 'KeyM':
+                    if (!elements.markButton.disabled) {
+                        markTimestamp();
+                    }
+                    break;
+                case 'KeyP':
+                    if (!elements.pauseButton.disabled) {
+                        togglePause();
+                    }
+                    break;
+                case 'KeyR':
+                    if (!elements.rerecordButton.disabled) {
+                        resetRecorder();
+                    }
+                    break;
+            }
+        });
+
+        // --- Server Status Check ---
+        async function checkServerStatus() {
+            const statusIndicator = document.createElement('div');
+            statusIndicator.id = 'server-status';
+            statusIndicator.style.cssText = `
+                position: fixed;
+                top: 10px;
+                left: 10px;
+                padding: 8px 12px;
+                border-radius: 6px;
+                font-size: 12px;
+                font-weight: bold;
+                z-index: 1000;
+                transition: all 0.3s;
+            `;
+            document.body.appendChild(statusIndicator);
+            
+            try {
+                const response = await fetch('http://localhost:5001/record', { method: 'GET' });
+                if (response.ok) {
+                    statusIndicator.textContent = '🟢 Server Connected';
+                    statusIndicator.style.background = '#d4edda';
+                    statusIndicator.style.color = '#155724';
+                    statusIndicator.style.border = '1px solid #c3e6cb';
+                } else {
+                    throw new Error('Server not responding');
+                }
+            } catch (error) {
+                statusIndicator.textContent = '🔴 Server Disconnected';
+                statusIndicator.style.background = '#f8d7da';
+                statusIndicator.style.color = '#721c24';
+                statusIndicator.style.border = '1px solid #f5c6cb';
+                
+                // Show connection instructions
+                setTimeout(() => {
+                    if (statusIndicator.parentNode) {
+                        statusIndicator.innerHTML = `
+                            🔴 Server Offline<br>
+                            <small>Run: python recorder_server.py</small>
+                        `;
+                    }
+                }, 2000);
+            }
+        }
+
+        // --- Summary and Notes System ---
+        async function generateSummary() {
+            console.log('🤖 GENERATE SUMMARY DEBUG:');
+            console.log('- state.currentResult:', state.currentResult);
+            console.log('- original_text:', state.currentResult?.original_text);
+            console.log('- text:', state.currentResult?.text);
+            console.log('- translated_text:', state.currentResult?.translated_text);
+            
+            if (!state.currentResult) {
+                console.log('❌ No currentResult found');
+                showMessage('لا توجد نتائج متاحة للملخص', 'error');
+                return;
+            }
+            
+            const textToSummarize = state.currentResult.original_text || state.currentResult.text || state.currentResult.translated_text;
+            
+            if (!textToSummarize || textToSummarize.trim() === '') {
+                console.log('❌ No text available for summarization');
+                console.log('Available properties:', Object.keys(state.currentResult));
+                showMessage('لا يوجد نص متاح للملخص', 'error');
+                return;
+            }
+            
+            console.log('✅ Text to summarize:', textToSummarize.substring(0, 100) + '...');
+
+            const summaryBtn = document.getElementById('generateSummaryBtn');
+            const originalContent = summaryBtn.innerHTML;
+            summaryBtn.disabled = true;
+            summaryBtn.innerHTML = '<span>⏳</span><span>جاري إنشاء الملخص...</span>';
+
+            try {
+                console.log('📤 Sending summarization request...');
+                console.log('📤 Request payload:', {
+                    text: textToSummarize.substring(0, 100) + '...',
+                    language: elements.targetLanguage.value || 'arabic'
+                });
+                
+                const response = await fetch('http://localhost:5001/summarize', {
+                    method: 'POST',
+                    headers: { 
+                        'Content-Type': 'application/json',
+                        'Accept': 'application/json'
+                    },
+                    body: JSON.stringify({
+                        text: textToSummarize,
+                        language: elements.targetLanguage.value || 'arabic',
+                        type: 'full'
+                    })
+                });
+
+                console.log('📥 Response status:', response.status);
+                console.log('📥 Response headers:', response.headers);
+
+                if (response.ok) {
+                    const data = await response.json();
+                    console.log('📥 Summarization response:', data);
+                    
+                    if (data.success) {
+                        // التعامل مع الاستجابة الجديدة
+                        if (data.summary) {
+                            displaySummaryResults(data.summary);
+                            showMessage('تم إنشاء الملخص بنجاح!', 'success');
+                        } else {
+                            console.error('❌ No summary in response:', data);
+                            showMessage('لم يتم العثور على ملخص في الاستجابة', 'error');
+                        }
+                    } else {
+                        throw new Error(data.error || 'فشل في إنشاء الملخص');
+                    }
+                } else {
+                    const errorText = await response.text();
+                    console.error('❌ HTTP Error:', response.status, errorText);
+                    throw new Error(`خطأ في الشبكة: ${response.status} - ${errorText}`);
+                }
+            } catch (error) {
+                console.error('❌ Summary generation error:', error);
+                
+                // رسائل خطأ محددة
+                let errorMessage = 'فشل في إنشاء الملخص';
+                if (error.name === 'TypeError' && error.message.includes('fetch')) {
+                    errorMessage = 'لا يمكن الاتصال بخادم التلخيص - تأكد من تشغيل الخادم';
+                } else if (error.message.includes('CORS')) {
+                    errorMessage = 'مشكلة في إعدادات CORS - يجب إعادة تشغيل الخادم';
+                } else {
+                    errorMessage = error.message;
+                }
+                
+                showMessage(errorMessage, 'error');
+            } finally {
+                summaryBtn.disabled = false;
+                summaryBtn.innerHTML = originalContent;
+            }
+        }
+
+        function displaySummaryResults(summary) {
+            console.log('📝 Displaying summary results:', summary);
+            
+            // Show the summary section
+            document.getElementById('summary-section').style.display = 'block';
+            
+            // التعامل مع تنسيق الاستجابة - قد يكون النص مباشرة أو كائن
+            let summaryText = '';
+            if (typeof summary === 'string') {
+                summaryText = summary;
+            } else if (summary && summary.main_summary) {
+                summaryText = summary.main_summary;
+            } else if (summary && typeof summary === 'object') {
+                // إذا كانت الاستجابة كائن، نأخذ المحتوى النصي
+                summaryText = JSON.stringify(summary, null, 2);
+            }
+            
+            // Display main summary
+            const summaryTextSection = document.getElementById('summary-text-section');
+            const summaryTextElement = document.getElementById('summary-text');
+            if (summaryTextSection && summaryTextElement && summaryText) {
+                summaryTextElement.innerHTML = summaryText.replace(/\n/g, '<br>');
+                summaryTextSection.style.display = 'block';
+            }
+
+            // Display key points (إذا كانت متوفرة)
+            const keyPointsSection = document.getElementById('key-points-section');
+            const keyPointsList = document.getElementById('key-points-list');
+            if (keyPointsSection && keyPointsList && summary && summary.key_points && Array.isArray(summary.key_points)) {
+                keyPointsList.innerHTML = summary.key_points.map(point => `<li>${point}</li>`).join('');
+                keyPointsSection.style.display = 'block';
+            }
+
+            // Display review questions (إذا كانت متوفرة)
+            const questionsSection = document.getElementById('questions-section');
+            const questionsList = document.getElementById('questions-list');
+            if (questionsSection && questionsList && summary && summary.review_questions && Array.isArray(summary.review_questions)) {
+                questionsList.innerHTML = summary.review_questions.map(question => `<li>${question}</li>`).join('');
+                questionsSection.style.display = 'block';
+            }
+
+            // Show save note section
+            const saveNoteSection = document.getElementById('save-note-section');
+            if (saveNoteSection) {
+                saveNoteSection.style.display = 'block';
+            }
+            
+            // Store current summary in state for saving
+            state.currentSummary = summary;
+        }
+
+        async function saveNote() {
+            if (!state.currentSummary) {
+                showMessage('لا يوجد ملخص متاح للحفظ', 'error');
+                return;
+            }
+
+            const title = document.getElementById('noteTitle').value.trim();
+            const tags = document.getElementById('noteTags').value.trim();
+            
+            if (!title) {
+                showMessage('يرجى إدخال عنوان للمذكرة', 'error');
+                return;
+            }
+
+            const saveBtn = document.getElementById('saveNoteBtn');
+            const originalText = saveBtn.textContent;
+            saveBtn.disabled = true;
+            saveBtn.textContent = 'جاري الحفظ...';
+
+            try {
+                const contentToSave = state.currentResult.original_text || state.currentResult.text;
+                const response = await fetch('http://localhost:5001/notes', {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify({
+                        title: title,
+                        content: contentToSave,
+                        summary: state.currentSummary,
+                        tags: tags ? tags.split(',').map(tag => tag.trim()) : [],
+                        markers: state.markers
+                    })
+                });
+
+                if (response.ok) {
+                    const data = await response.json();
+                    if (data.success) {
+                        showMessage('تم حفظ المذكرة بنجاح!', 'success');
+                        // Clear form
+                        document.getElementById('noteTitle').value = '';
+                        document.getElementById('noteTags').value = '';
+                        // Refresh notes list
+                        loadNotesList();
+                    } else {
+                        throw new Error(data.error || 'Failed to save note');
+                    }
+                } else {
+                    throw new Error('Network error while saving note');
+                }
+            } catch (error) {
+                console.error('Note saving error:', error);
+                showMessage('فشل في حفظ المذكرة: ' + error.message, 'error');
+            } finally {
+                saveBtn.disabled = false;
+                saveBtn.textContent = originalText;
+            }
+        }
+
+        async function loadNotesList() {
+            try {
+                const response = await fetch('http://localhost:5001/notes');
+                if (response.ok) {
+                    const data = await response.json();
+                    if (data.success) {
+                        displayNotesList(data.notes);
+                    }
+                }
+            } catch (error) {
+                console.error('Failed to load notes:', error);
+            }
+        }
+
+        function displayNotesList(notes) {
+            const notesContainer = document.getElementById('notesContainer');
+            
+            if (notes.length === 0) {
+                notesContainer.innerHTML = '<p class="text-center text-muted">No saved notes yet</p>';
+                return;
+            }
+
+            notesContainer.innerHTML = notes.map(note => `
+                <div class="note-item" data-note-id="${note.id}">
+                    <div class="note-header">
+                        <h4>${note.title}</h4>
+                        <span class="note-date">${new Date(note.created_at).toLocaleDateString()}</span>
+                    </div>
+                    <div class="note-summary">
+                        ${note.summary ? note.summary.main_summary.substring(0, 150) + '...' : 'No summary available'}
+                    </div>
+                    <div class="note-tags">
+                        ${note.tags ? note.tags.map(tag => `<span class="tag">${tag}</span>`).join('') : ''}
+                    </div>
+                    <div class="note-actions">
+                        <button onclick="viewNote(${note.id})" class="btn-secondary">View</button>
+                        <button onclick="deleteNote(${note.id})" class="btn-danger">Delete</button>
+                    </div>
+                </div>
+            `).join('');
+        }
+
+        async function viewNote(noteId) {
+            try {
+                const response = await fetch(`http://localhost:5001/notes/${noteId}`);
+                if (response.ok) {
+                    const data = await response.json();
+                    if (data.success) {
+                        displayNoteDetails(data.note);
+                    }
+                }
+            } catch (error) {
+                console.error('Failed to load note:', error);
+                showMessage('Failed to load note details', 'error');
+            }
+        }
+
+        function displayNoteDetails(note) {
+            // Create modal or expand view for note details
+            const modal = document.createElement('div');
+            modal.className = 'note-modal';
+            modal.innerHTML = `
+                <div class="note-modal-content">
+                    <div class="note-modal-header">
+                        <h2>${note.title}</h2>
+                        <button onclick="closeNoteModal()" class="close-btn">&times;</button>
+                    </div>
+                    <div class="note-modal-body">
+                        <div class="note-section">
+                            <h3>Summary</h3>
+                            <p>${note.summary ? note.summary.main_summary : 'No summary available'}</p>
+                        </div>
+                        ${note.summary && note.summary.key_points ? `
+                        <div class="note-section">
+                            <h3>Key Points</h3>
+                            <ul>${note.summary.key_points.map(point => `<li>${point}</li>`).join('')}</ul>
+                        </div>
+                        ` : ''}
+                        <div class="note-section">
+                            <h3>Full Transcription</h3>
+                            <p>${note.content}</p>
+                        </div>
+                        ${note.tags && note.tags.length > 0 ? `
+                        <div class="note-section">
+                            <h3>Tags</h3>
+                            <div class="note-tags">
+                                ${note.tags.map(tag => `<span class="tag">${tag}</span>`).join('')}
+                            </div>
+                        </div>
+                        ` : ''}
+                    </div>
+                </div>
+            `;
+            document.body.appendChild(modal);
+        }
+
+        function closeNoteModal() {
+            const modal = document.querySelector('.note-modal');
+            if (modal) {
+                modal.remove();
+            }
+        }
+
+        async function deleteNote(noteId) {
+            if (!confirm('Are you sure you want to delete this note?')) {
+                return;
+            }
+
+            try {
+                const response = await fetch(`http://localhost:5001/notes/${noteId}`, {
+                    method: 'DELETE'
+                });
+
+                if (response.ok) {
+                    const data = await response.json();
+                    if (data.success) {
+                        showMessage('Note deleted successfully', 'success');
+                        loadNotesList();
+                    } else {
+                        throw new Error(data.error || 'Failed to delete note');
+                    }
+                } else {
+                    throw new Error('Network error while deleting note');
+                }
+            } catch (error) {
+                console.error('Delete note error:', error);
+                showMessage('Failed to delete note: ' + error.message, 'error');
+            }
+        }
+
+        function searchNotes() {
+            const searchTerm = document.getElementById('notesSearch').value.toLowerCase();
+            const noteItems = document.querySelectorAll('.note-item');
+            
+            noteItems.forEach(item => {
+                const title = item.querySelector('h4').textContent.toLowerCase();
+                const summary = item.querySelector('.note-summary').textContent.toLowerCase();
+                const tags = item.querySelector('.note-tags').textContent.toLowerCase();
+                
+                if (title.includes(searchTerm) || summary.includes(searchTerm) || tags.includes(searchTerm)) {
+                    item.style.display = 'block';
+                } else {
+                    item.style.display = 'none';
+                }
+            });
+        }
+
+        // --- Initialization ---
+        async function initialize() {
+            await loadTranslations(currentLanguage);
+            await checkServerStatus();
+            toggleTranslationUI();
+            updateTargetLanguageInfo();
+            resetRecorder();
+            
+            // Load existing notes
+            loadNotesList();
+            
+            // Add event listeners for summary and notes
+            const generateSummaryBtn = document.getElementById('generateSummaryBtn');
+            const saveNoteBtn = document.getElementById('saveNoteBtn');
+            const notesSearch = document.getElementById('notesSearch');
+            
+            if (generateSummaryBtn) {
+                generateSummaryBtn.addEventListener('click', generateSummary);
+            }
+            if (saveNoteBtn) {
+                saveNoteBtn.addEventListener('click', saveNote);
+            }
+            if (notesSearch) {
+                notesSearch.addEventListener('input', searchNotes);
+            }
+            
+            // Check server status every 30 seconds
+            setInterval(checkServerStatus, 30000);
+        }
+
+        // Start the application
+        initialize();
+    </script>
+</body>
+</html>

test_recording.py

@@ -0,0 +1,134 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+اختبار زر التسجيل - محاكاة ملف صوتي
+"""
+
+import requests
+import io
+import wave
+import struct
+import random
+
+def create_test_audio():
+    """إنشاء ملف صوتي تجريبي"""
+    # إنشاء صوت تجريبي (silence مع بعض الضوضاء)
+    duration = 2  # ثانيتين
+    sample_rate = 44100
+    samples = duration * sample_rate
+    
+    # إنشاء بيانات صوتية بسيطة
+    audio_data = []
+    for i in range(samples):
+        # ضوضاء بسيطة
+        value = int(random.uniform(-1000, 1000))
+        audio_data.append(value)
+    
+    # إنشاء ملف WAV في الذاكرة
+    buffer = io.BytesIO()
+    with wave.open(buffer, 'wb') as wav_file:
+        wav_file.setnchannels(1)  # Mono
+        wav_file.setsampwidth(2)  # 16-bit
+        wav_file.setframerate(sample_rate)
+        
+        # كتابة البيانات
+        for sample in audio_data:
+            wav_file.writeframes(struct.pack('<h', sample))
+    
+    buffer.seek(0)
+    return buffer
+
+def test_recording_endpoint():
+    """اختبار endpoint التسجيل"""
+    print("🎙️ اختبار endpoint التسجيل...")
+    
+    try:
+        # إنشاء ملف صوتي تجريبي
+        audio_buffer = create_test_audio()
+        
+        # إعداد البيانات
+        files = {
+            'audio_data': ('test_audio.wav', audio_buffer, 'audio/wav')
+        }
+        
+        data = {
+            'markers': '[]',
+            'target_language': 'ar',
+            'enable_translation': 'true'
+        }
+        
+        print("📤 إرسال طلب التسجيل...")
+        response = requests.post(
+            'http://localhost:5001/record',
+            files=files,
+            data=data,
+            timeout=30
+        )
+        
+        print(f"Status Code: {response.status_code}")
+        
+        if response.status_code == 200:
+            result = response.json()
+            print(f"Success: {result.get('success')}")
+            
+            if result.get('success'):
+                print("✅ التسجيل نجح!")
+                print(f"Original Text: {result.get('original_text', 'غير موجود')}")
+                print(f"Translation Enabled: {result.get('translation_enabled')}")
+                print(f"Target Language: {result.get('target_language')}")
+                return True
+            else:
+                print(f"❌ فشل التسجيل: {result.get('error')}")
+                return False
+        else:
+            print(f"❌ خطأ HTTP: {response.status_code}")
+            print(f"Response: {response.text}")
+            return False
+            
+    except Exception as e:
+        print(f"❌ خطأ في اختبار التسجيل: {e}")
+        return False
+
+def test_options_request():
+    """اختبار طلب OPTIONS للتسجيل"""
+    print("\n🔧 اختبار طلب OPTIONS للتسجيل...")
+    
+    try:
+        response = requests.options('http://localhost:5001/record', timeout=5)
+        print(f"Status Code: {response.status_code}")
+        
+        if response.status_code == 204:
+            print("✅ طلب OPTIONS نجح")
+            return True
+        else:
+            print(f"❌ مشكلة في طلب OPTIONS: {response.status_code}")
+            return False
+            
+    except Exception as e:
+        print(f"❌ خطأ في طلب OPTIONS: {e}")
+        return False
+
+def main():
+    """الدالة الرئيسية لاختبار التسجيل"""
+    print("🚀 اختبار وظيفة التسجيل")
+    print("=" * 50)
+    
+    # اختبار OPTIONS أولاً
+    options_ok = test_options_request()
+    
+    if options_ok:
+        # اختبار التسجيل الفعلي
+        recording_ok = test_recording_endpoint()
+        
+        if recording_ok:
+            print("\n🎉 جميع اختبارات التسجيل نجحت!")
+            print("✅ زر التسجيل يعمل بشكل مثالي")
+        else:
+            print("\n❌ هناك مشكلة في وظيفة التسجيل")
+    else:
+        print("\n❌ مشكلة في CORS للتسجيل")
+    
+    print("=" * 50)
+
+if __name__ == "__main__":
+    main()

test_server_translation.py

@@ -0,0 +1,78 @@
+# test_server_translation.py - Test server translation response
+
+import requests
+import json
+import tempfile
+import wave
+import numpy as np
+
+def create_test_audio():
+    """Create a simple test audio file"""
+    sample_rate = 16000
+    duration = 2  # seconds
+    frequency = 440  # Hz (A note)
+    
+    # Generate sine wave
+    t = np.linspace(0, duration, int(sample_rate * duration))
+    audio_data = (0.3 * np.sin(2 * np.pi * frequency * t) * 32767).astype(np.int16)
+    
+    # Create temporary WAV file
+    with tempfile.NamedTemporaryFile(delete=False, suffix='.wav') as tmp_file:
+        with wave.open(tmp_file.name, 'w') as wav_file:
+            wav_file.setnchannels(1)  # Mono
+            wav_file.setsampwidth(2)  # 2 bytes per sample
+            wav_file.setframerate(sample_rate)
+            wav_file.writeframes(audio_data.tobytes())
+        return tmp_file.name
+
+def test_server_translation():
+    print("🔍 Testing Server Translation Response...")
+    
+    # Create test audio
+    audio_file = create_test_audio()
+    print(f"📁 Created test audio: {audio_file}")
+    
+    try:
+        # Prepare request data
+        with open(audio_file, 'rb') as f:
+            files = {'audio': f}
+            data = {
+                'target_language': 'ar',
+                'enable_translation': 'true',
+                'markers': '[]'
+            }
+            
+            # Send request to server
+            response = requests.post('http://localhost:5001/record', files=files, data=data)
+            
+            if response.status_code == 200:
+                result = response.json()
+                print(f"✅ Server Response Received")
+                print(f"📊 Success: {result.get('success')}")
+                print(f"🔤 Original text: {result.get('original_text', 'None')}")
+                print(f"🔄 Translated text: {result.get('translated_text', 'None')}")
+                print(f"🌍 Translation enabled: {result.get('translation_enabled')}")
+                print(f"✅ Translation success: {result.get('translation_success')}")
+                print(f"🌐 Target language: {result.get('target_language')}")
+                print(f"🔍 Detected language: {result.get('language_detected')}")
+                
+                # Check if texts are different
+                original = result.get('original_text', '')
+                translated = result.get('translated_text', '')
+                print(f"🔄 Texts are different: {original != translated}")
+                
+            else:
+                print(f"❌ Server error: {response.status_code}")
+                print(f"Response: {response.text}")
+                
+    except Exception as e:
+        print(f"❌ Test failed: {str(e)}")
+    
+    finally:
+        # Clean up
+        import os
+        if os.path.exists(audio_file):
+            os.unlink(audio_file)
+
+if __name__ == "__main__":
+    test_server_translation()

test_servers.py

@@ -0,0 +1,17 @@
+import requests
+
+print('🧪 Testing servers...')
+
+try:
+    r1 = requests.get('http://localhost:5050', timeout=5)
+    print(f'✅ Streamlit: OK - {r1.status_code}')
+except Exception as e:
+    print(f'❌ Streamlit: FAILED - {e}')
+
+try:
+    r2 = requests.get('http://localhost:5001/record', timeout=5)
+    print(f'✅ Recorder: OK - {r2.status_code}')
+except Exception as e:
+    print(f'❌ Recorder: FAILED - {e}')
+
+print('🏁 Test completed')

test_summarize.py

@@ -0,0 +1,117 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+اختبار مشكلة endpoint التلخيص
+"""
+
+import requests
+import json
+
+def test_cors_preflight():
+    """اختبار طلب OPTIONS (CORS preflight)"""
+    print("🔍 اختبار CORS preflight...")
+    
+    try:
+        response = requests.options('http://localhost:5001/summarize')
+        print(f"Status Code: {response.status_code}")
+        print(f"Headers: {dict(response.headers)}")
+        
+        # تحقق من CORS headers
+        cors_origin = response.headers.get('Access-Control-Allow-Origin')
+        print(f"CORS Origin: '{cors_origin}'")
+        
+        if cors_origin and ',' in cors_origin:
+            print("❌ مشكلة: CORS header يحتوي على قيم متعددة!")
+            return False
+        elif cors_origin == '*':
+            print("✅ CORS header صحيح")
+            return True
+        else:
+            print(f"⚠️ CORS header غير متوقع: {cors_origin}")
+            return False
+            
+    except Exception as e:
+        print(f"❌ خطأ في طلب OPTIONS: {e}")
+        return False
+
+def test_summarize_endpoint():
+    """اختبار endpoint التلخيص"""
+    print("\n🤖 اختبار endpoint التلخيص...")
+    
+    test_data = {
+        "text": "Hello, how are you? What are you doing today? Tell me.",
+        "language": "arabic"
+    }
+    
+    try:
+        response = requests.post(
+            'http://localhost:5001/summarize',
+            json=test_data,
+            headers={'Content-Type': 'application/json'}
+        )
+        
+        print(f"Status Code: {response.status_code}")
+        print(f"Response: {response.text}")
+        
+        if response.status_code == 200:
+            data = response.json()
+            if data.get('success'):
+                print("✅ التلخيص نجح!")
+                return True
+            else:
+                print(f"❌ فشل التلخيص: {data.get('error')}")
+                return False
+        else:
+            print(f"❌ خطأ HTTP: {response.status_code}")
+            return False
+            
+    except Exception as e:
+        print(f"❌ خطأ في طلب POST: {e}")
+        return False
+
+def test_server_status():
+    """اختبار حالة الخادم"""
+    print("🌐 اختبار حالة الخادم...")
+    
+    try:
+        response = requests.get('http://localhost:5001/record')
+        print(f"Status Code: {response.status_code}")
+        
+        if response.status_code == 200:
+            data = response.json()
+            print(f"Server Status: {data.get('status')}")
+            return True
+        else:
+            print(f"❌ الخادم غير متاح: {response.status_code}")
+            return False
+            
+    except Exception as e:
+        print(f"❌ لا يمكن الوصول للخادم: {e}")
+        return False
+
+if __name__ == "__main__":
+    print("=" * 50)
+    print("🚀 بدء اختبار مشكلة التلخيص")
+    print("=" * 50)
+    
+    # اختبار حالة الخادم
+    server_ok = test_server_status()
+    
+    if server_ok:
+        # اختبار CORS
+        cors_ok = test_cors_preflight()
+        
+        if cors_ok:
+            # اختبار التلخيص
+            summarize_ok = test_summarize_endpoint()
+            
+            if summarize_ok:
+                print("\n🎉 جميع الاختبارات نجحت!")
+            else:
+                print("\n❌ فشل في اختبار التلخيص")
+        else:
+            print("\n❌ مشكلة في CORS - يجب إعادة تشغيل الخادم")
+    else:
+        print("\n❌ الخادم غير متاح - يجب تشغيله أولاً")
+    
+    print("=" * 50)

test_summary_button.py

@@ -0,0 +1,113 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+اختبار سريع ومبسط لزر التلخيص
+"""
+
+import requests
+import json
+
+def test_summary_button():
+    """محاكاة نفس الطلب الذي يرسله زر التلخيص"""
+    
+    print("🤖 اختبار زر التلخيص...")
+    print("=" * 50)
+    
+    # نفس البيانات التي ترسلها الواجهة
+    test_data = {
+        "text": "Hello, how are you? What are you doing today? Tell me.",
+        "language": "arabic",
+        "type": "full"
+    }
+    
+    try:
+        print("📤 إرسال طلب التلخيص...")
+        print(f"البيانات: {test_data}")
+        
+        response = requests.post(
+            'http://localhost:5001/summarize',
+            json=test_data,
+            headers={
+                'Content-Type': 'application/json',
+                'Accept': 'application/json'
+            },
+            timeout=30
+        )
+        
+        print(f"\n📥 استلام الرد:")
+        print(f"Status Code: {response.status_code}")
+        print(f"Headers: {dict(response.headers)}")
+        
+        if response.status_code == 200:
+            data = response.json()
+            print(f"\n✅ نجح التلخيص!")
+            print(f"Keys في الرد: {list(data.keys())}")
+            
+            if data.get('success'):
+                print(f"نوع التلخيص: {data.get('type')}")
+                
+                if 'summary' in data:
+                    summary = data['summary']
+                    print(f"\nالملخص:")
+                    print("-" * 30)
+                    print(summary)
+                    print("-" * 30)
+                    return True
+                else:
+                    print("⚠️ لا يوجد ملخص في الرد")
+                    return False
+            else:
+                print(f"❌ فشل التلخيص: {data.get('error')}")
+                return False
+        else:
+            print(f"❌ خطأ HTTP: {response.status_code}")
+            print(f"الرد: {response.text}")
+            return False
+            
+    except Exception as e:
+        print(f"❌ خطأ في الطلب: {e}")
+        return False
+
+def test_cors_manually():
+    """اختبار CORS يدوياً"""
+    print("\n🔧 اختبار CORS...")
+    
+    try:
+        # طلب OPTIONS أولاً
+        options_response = requests.options('http://localhost:5001/summarize')
+        print(f"OPTIONS Status: {options_response.status_code}")
+        
+        cors_origin = options_response.headers.get('Access-Control-Allow-Origin')
+        print(f"CORS Origin: '{cors_origin}'")
+        
+        if cors_origin == '*':
+            print("✅ CORS صحيح")
+            return True
+        else:
+            print(f"❌ مشكلة CORS: {cors_origin}")
+            return False
+            
+    except Exception as e:
+        print(f"❌ خطأ في اختبار CORS: {e}")
+        return False
+
+if __name__ == "__main__":
+    print("🚀 اختبار زر التلخيص المحدث")
+    print("=" * 50)
+    
+    # اختبار CORS
+    cors_ok = test_cors_manually()
+    
+    if cors_ok:
+        # اختبار التلخيص
+        summary_ok = test_summary_button()
+        
+        if summary_ok:
+            print("\n🎉 جميع الاختبارات نجحت!")
+            print("✅ زر التلخيص يعمل بشكل صحيح")
+        else:
+            print("\n❌ هناك مشكلة في التلخيص")
+    else:
+        print("\n❌ مشكلة CORS تمنع التلخيص")
+    
+    print("=" * 50)

test_system.py

@@ -0,0 +1,241 @@
+#!/usr/bin/env python3
+"""
+System Test Script for SyncMaster Enhanced
+سكريبت اختبار النظام لـ SyncMaster المحسن
+"""
+
+import os
+import sys
+import traceback
+from pathlib import Path
+
+def test_imports():
+    """Test all required imports"""
+    print("🔍 Testing imports...")
+    
+    tests = [
+        ('google.genai', 'Google Generative AI'),
+        ('librosa', 'LibROSA'),
+        ('soundfile', 'SoundFile'),
+        ('streamlit', 'Streamlit'),
+        ('flask', 'Flask'),
+        ('dotenv', 'Python-dotenv'),
+    ]
+    
+    failed_imports = []
+    
+    for module, name in tests:
+        try:
+            __import__(module)
+            print(f"  ✅ {name}")
+        except ImportError as e:
+            print(f"  ❌ {name}: {e}")
+            failed_imports.append(name)
+    
+    return len(failed_imports) == 0
+
+def test_env_file():
+    """Test environment configuration"""
+    print("\n🔑 Testing environment...")
+    
+    if not Path('.env').exists():
+        print("  ❌ .env file not found")
+        return False
+    
+    try:
+        from dotenv import load_dotenv
+        load_dotenv()
+        
+        api_key = os.getenv("GEMINI_API_KEY")
+        if not api_key:
+            print("  ❌ GEMINI_API_KEY not found in .env")
+            return False
+        elif api_key == "your_api_key_here":
+            print("  ⚠️ GEMINI_API_KEY needs to be replaced with actual key")
+            return False
+        else:
+            print(f"  ✅ GEMINI_API_KEY configured (length: {len(api_key)})")
+            return True
+            
+    except Exception as e:
+        print(f"  ❌ Error reading .env: {e}")
+        return False
+
+def test_translator():
+    """Test translator initialization"""
+    print("\n🌐 Testing translator...")
+    
+    try:
+        from translator import AITranslator, get_translator
+        
+        # Test direct initialization
+        translator = AITranslator()
+        if translator.init_error:
+            print(f"  ❌ Translator init error: {translator.init_error}")
+            return False
+        
+        print("  ✅ Translator initialized successfully")
+        
+        # Test simple translation
+        test_text = "Hello, this is a test"
+        translated, error = translator.translate_text(test_text, 'ar')
+        
+        if error:
+            print(f"  ❌ Translation test failed: {error}")
+            return False
+        elif translated:
+            print(f"  ✅ Translation test successful: '{test_text}' → '{translated}'")
+            return True
+        else:
+            print("  ⚠️ Translation returned empty result")
+            return False
+            
+    except Exception as e:
+        print(f"  ❌ Translator test failed: {e}")
+        print(f"  🔍 Traceback: {traceback.format_exc()}")
+        return False
+
+def test_audio_processor():
+    """Test audio processor initialization"""
+    print("\n🎵 Testing audio processor...")
+    
+    try:
+        from audio_processor import AudioProcessor
+        
+        processor = AudioProcessor()
+        if processor.init_error:
+            print(f"  ❌ Audio processor init error: {processor.init_error}")
+            return False
+        
+        print("  ✅ Audio processor initialized successfully")
+        
+        # Check if translator is available
+        if processor.translator:
+            print("  ✅ Translator integration available")
+        else:
+            print("  ⚠️ Translator integration not available")
+        
+        return True
+        
+    except Exception as e:
+        print(f"  ❌ Audio processor test failed: {e}")
+        print(f"  🔍 Traceback: {traceback.format_exc()}")
+        return False
+
+def test_server_components():
+    """Test server components"""
+    print("\n🖥️ Testing server components...")
+    
+    try:
+        from recorder_server import app
+        print("  ✅ Recorder server imports OK")
+        
+        # Test routes
+        with app.test_client() as client:
+            # Test health check
+            response = client.get('/record')
+            if response.status_code == 200:
+                print("  ✅ Health check endpoint working")
+            else:
+                print(f"  ⚠️ Health check returned {response.status_code}")
+            
+            # Test languages endpoint
+            response = client.get('/languages')
+            if response.status_code == 200:
+                print("  ✅ Languages endpoint working")
+            else:
+                print(f"  ⚠️ Languages endpoint returned {response.status_code}")
+        
+        return True
+        
+    except Exception as e:
+        print(f"  ❌ Server test failed: {e}")
+        print(f"  🔍 Traceback: {traceback.format_exc()}")
+        return False
+
+def test_ui_translations():
+    """Test UI translations"""
+    print("\n🎨 Testing UI translations...")
+    
+    try:
+        from translator import UI_TRANSLATIONS, get_translation
+        
+        # Test English translations
+        en_keys = len(UI_TRANSLATIONS.get('en', {}))
+        ar_keys = len(UI_TRANSLATIONS.get('ar', {}))
+        
+        print(f"  ✅ English translations: {en_keys} keys")
+        print(f"  ✅ Arabic translations: {ar_keys} keys")
+        
+        if en_keys != ar_keys:
+            print(f"  ⚠️ Translation key count mismatch: EN={en_keys}, AR={ar_keys}")
+        
+        # Test translation function
+        test_key = 'start_recording'
+        en_text = get_translation(test_key, 'en')
+        ar_text = get_translation(test_key, 'ar')
+        
+        print(f"  ✅ Test translation: '{en_text}' → '{ar_text}'")
+        
+        return True
+        
+    except Exception as e:
+        print(f"  ❌ UI translations test failed: {e}")
+        return False
+
+def main():
+    """Run all tests"""
+    print("=" * 60)
+    print("🧪 SyncMaster Enhanced - System Test")
+    print("اختبار النظام الشامل لـ SyncMaster المحسن")
+    print("=" * 60)
+    
+    # Change to script directory
+    script_dir = Path(__file__).parent
+    os.chdir(script_dir)
+    print(f"📁 Working directory: {script_dir}")
+    
+    tests = [
+        ("Import Test", test_imports),
+        ("Environment Test", test_env_file),
+        ("Translator Test", test_translator),
+        ("Audio Processor Test", test_audio_processor),
+        ("Server Components Test", test_server_components),
+        ("UI Translations Test", test_ui_translations),
+    ]
+    
+    results = {}
+    
+    for test_name, test_func in tests:
+        try:
+            results[test_name] = test_func()
+        except Exception as e:
+            print(f"\n❌ {test_name} crashed: {e}")
+            results[test_name] = False
+    
+    # Summary
+    print("\n" + "=" * 60)
+    print("📊 TEST SUMMARY / ملخص الاختبار")
+    print("=" * 60)
+    
+    passed = sum(results.values())
+    total = len(results)
+    
+    for test_name, result in results.items():
+        status = "✅ PASS" if result else "❌ FAIL"
+        print(f"  {status} {test_name}")
+    
+    print(f"\n🎯 Results: {passed}/{total} tests passed")
+    
+    if passed == total:
+        print("🎉 All tests passed! System is ready to use.")
+        print("🚀 You can now run: python start_debug.py")
+    else:
+        print("⚠️ Some tests failed. Please fix the issues before running the application.")
+        print("📝 Check the error messages above for details.")
+    
+    return passed == total
+
+if __name__ == "__main__":
+    success = main()
+    sys.exit(0 if success else 1)

test_translation.py

@@ -0,0 +1,39 @@
+# test_translation.py - Quick translation test
+
+from translator import get_translator
+import json
+
+def test_translation():
+    print("🔍 Testing AI Translation System...")
+    
+    # Get translator instance
+    translator = get_translator()
+    
+    if translator.init_error:
+        print(f"❌ Translation Error: {translator.init_error}")
+        return
+    
+    print("✅ Translator initialized successfully")
+    
+    # Test translation
+    test_text = "Hello, this is a test for the translation system"
+    print(f"\n🔤 Original text: {test_text}")
+    
+    translated_text, error = translator.translate_text(test_text, target_language='ar')
+    
+    if translated_text:
+        print(f"✅ Arabic translation: {translated_text}")
+        print(f"📊 Translation success: True")
+        print(f"🔄 Texts are different: {translated_text != test_text}")
+    else:
+        print(f"❌ Translation failed: {error}")
+    
+    # Test language detection
+    detected_lang, detect_error = translator.detect_language(test_text)
+    if detected_lang:
+        print(f"🌍 Detected language: {detected_lang}")
+    else:
+        print(f"❌ Language detection failed: {detect_error}")
+
+if __name__ == "__main__":
+    test_translation()