README.md

metadata

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
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:

   # Clone or download the project
   # Install Python 3.8+
   python setup_enhanced.py
   

2. Run:

   # 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
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 - دليل باللغة العربية
• API Documentation - Technical API reference
• Troubleshooting - 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 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
• 🌐 Arabic Documentation
• 🎓 Student Guide
• 🔧 Technical Setup