# 🎙️ Soniox Mobile to Mac (v1.0 Stable)

سیستم پیشرفته و فوق‌سریع تایپ صوتی بیسیم از گوشی اندروید و هدست به مکینتاش (macOS) با هوش مصنوعی سانی‌اوکس (Soniox AI).

---

## 🌟 ویژگی‌های کلیدی (Key Features)

1. **تایپ صوتی بیسیم از اندروید به مک (Android ➡️ Mac):**
   - پشتیبانی از حالت **Hold-to-Talk** و **کلید سخت‌افزاری کم کردن صدا (Volume Down)** گوشی.
   - ویرایشگر زنده متن روی گوشی با امکان تایپ دستی، اصلاح کلمات و دکمه اختصاصی **«🚀 درج متن در مک» (`Cmd + V`)**.
   - حذف کامل لاگ‌های حجیم از صفحه اصلی و انتقال آن به پنجره هوشمند دیباگ (BottomSheet).

2. **معماری فوق‌سریع استریم زنده (Pipelined Real-time Streaming v3.0):**
   - **اتصال دائمی دوطرفه (Persistent Duplex WebSocket):** صفر میلی‌ثانیه تأخیر شروع در صحبت مجدد.
   - **استخر اتصالات گرم (Pre-Warmed Upstream Pool):** اتصال همیشه آماده به سانی‌اوکس روی سرور لینوکس.
   - **تایپ فوری در مک:** تأخیر کلی رها کردن دکمه تا تایپ در مک کمتر از **۲۵۰ میلی‌ثانیه**.

3. **جلوگیری قطعی از شکستن خط و تکرار متن (Zero Newlines & Strict Dedup):**
   * پالایش خودکار کلمات زائد و جلوگیری از ارسال کاراکترهای `\r\n` (بدون ارسال اینتر ناخواسته).
   * کش هوشمند `Session ID` برای جلوگیری از تایپ تکراری جملات.

4. **اپلیکیشن اختصاصی مک (macOS Native MenuBar App):**
   - پشتیبانی از کلید میانبر سیستمی **`Option` (⌥)** به صورت Hold-to-Talk و **`Caps Lock`** به صورت Toggle.
   - درج مستقیم متن در فیلد متنی فعال بدون نیاز به فوکوس دستی.

---

## 📁 ساختار پروژه (Repository Structure)

```
soniox-mobile-to-mac/
├── android/          # اپلیکیشن نیتیو اندروید (Kotlin, OkHttp, Material 3)
│   ├── app/src/main/ # سورس کدها و لایه‌بندی UI
│   └── build.gradle  # تنظیمات بیلد اندروید
├── mac/              # اپلیکیشن نیتیو مک‌او‌اس (Swift, AppKit, CoreAudio)
│   ├── src/          # سورس کدهای کلاینت مک و سرویس Paste
│   ├── package.sh    # اسکریپت بیلد .app و پکیج‌بندی .dmg
│   └── Info.plist    # دسترسی‌ها و تنظیمات امنیتی مک
├── server/           # گیت‌وی پرسرعت رله سرور (Python aiohttp/websockets)
│   ├── relay_server.py
│   └── soniox-relay.service
└── README.md
```

---

## 🚀 راهنمای راه‌اندازی و اجرا

### ۱. اجرای سرور گیت‌وی (Linux Server):
```bash
python3 -m venv .venv
source .venv/bin/activate
pip install aiohttp websockets
python3 server/relay_server.py
```
*(سرویس روی پورت `0.0.0.0:8999` آماده پاسخگویی می‌شود).*

### ۲. بیلد و اجرای کلاینت مک (macOS):
```bash
cd mac
chmod +x package.sh
./package.sh
open "/Applications/Soniox Voice.app"
```

### ۳. بیلد و نصب اپلیکیشن اندروید:
```bash
cd android
./gradlew assembleDebug
# فایل APK خروجی در app/build/outputs/apk/debug/app-debug.apk ساخته می‌شود
```

---

## 📜 لایسنس
توسعه یافته برای شرکت NewHorizon.