AltScribo

أداة إملاء صوتي مخصصة للغة العربية على نظام Windows. تعمل بصمت من أيقونة في شريط المهام، وتحوّل كلامك إلى نص مكتوب في أي برنامج: المتصفح، Word، برامج المحادثة، أو أي حقل نصي.

الإصدار الحالي: 1.3.2

كيف تعمل

1. ضع المؤشر في أي مكان تريد الكتابة فيه.
2. اضغط Alt+S، فتسمع نغمة حادة وتتحول الأيقونة إلى أيقونة بنقطة حمراء: بدأ التسجيل.
3. تكلّم بالعربية دون أي حد زمني.
4. اضغط Alt+S مرة ثانية، فتسمع نغمة منخفضة، ثم يظهر النص في مكان المؤشر خلال لحظات.

المزايا

• اختصار عام: يعمل في أي برنامج، ولا يمرّر الضغطة إلى النافذة المفتوحة.
• لصق ذكي: يُلصق النص عبر الحافظة، ثم تعود الحافظة القديمة كما كانت إن كانت نصًا. وإن كانت صورة أو ملفات فلا تُمسح.
• تسجيل مفتوح المدة: لا حد لطول الكلام.
• تضخيم الصوت الخافت: يرفع مستوى الصوت المنخفض تلقائيًا (حتى 4 أضعاف، وقابل للتعديل).
• محركان للتعرف: Google عبر الإنترنت، أو Whisper محليًا على جهازك بلا إنترنت (انظر أدناه). تختار بينهما من قائمة الأيقونة.
• ترقيم تلقائي: يضيف نقطة أو علامة استفهام في آخر الكلام، وفاصلة قبل أدوات مثل "لكن" و"لذلك"، لأن Google لا يرقّم العربية. ويحوّل الأرقام إلى أرقام غربية (0-9).
• أوامر ترقيم منطوقة: قل "فاصلة" أو "علامة استفهام" أو "سطر جديد"... (انظر الجدول أدناه).
• التشغيل مع Windows: خيار في القائمة يضيف اختصارًا في مجلد بدء التشغيل أو يزيله.
• أيقونة الشريط: تتغير أثناء التسجيل، وقائمتها فيها بدء/إيقاف التسجيل، واختيار المحرك، وخيارات الترقيم، والتشغيل مع Windows، وفتح الإعدادات، وفتح السجلّ، والخروج.
• إشعارات واضحة: تنبيه عند فشل الميكروفون، أو انقطاع الإنترنت، أو عدم فهم الكلام، بدل الفشل الصامت.
• نسخة واحدة فقط: لا يمكن تشغيل نسختين معًا فيتكرر التسجيل.
• مهلة للشبكة: لا تتجمد الأداة إن تعطّلت خدمة Google (15 ثانية افتراضيًا).
• ملف إعدادات بسيط: يُنشأ تلقائيًا، وإن تلف تعمل الأداة بالقيم الافتراضية.

التنزيل والتشغيل

نزّل الملف AltScribo-v1.3.2-windows.zip من صفحة الإصدارات، وفكّ ضغطه في أي مجلد، ثم شغّل AltScribo.exe. ستظهر الأيقونة في شريط المهام (قد تكون داخل السهم الصغير).

للتشغيل مع Windows تلقائيًا: اختر "التشغيل مع Windows" من قائمة الأيقونة، واختره مرة أخرى للإلغاء.

التعرف المحلي (Whisper)

اختر "Whisper محلي بلا إنترنت" من قائمة الأيقونة. في أول استخدام يُنزَّل النموذج (نحو 480 ميغابايت لنموذج small) إلى %APPDATA%\AltScribo\models، ثم يعمل التعرف كاملًا على جهازك دون إنترنت ودون إرسال صوتك لأي جهة. يضع Whisper علامات الترقيم بنفسه.

• أبطأ من Google قليلًا: بضع ثوانٍ لكل جملة على المعالج.
• يمكن تغيير النموذج عبر whisper_model: base أسرع وأقل دقة، وmedium أدق وأبطأ بكثير.
• إن لم تكن مكتبة faster-whisper مثبّتة يظهر الخيار معطّلًا بعبارة "غير مثبّت".

أوامر الترقيم المنطوقة

تقول	يُكتب
فاصلة	،
فاصلة منقوطة	؛
علامة استفهام	؟
علامة تعجب	!
نقطتان رأسيتان	:
نقطة	. (في آخر الكلام فقط، لأنها كلمة شائعة)
سطر جديد	سطر جديد
فقرة جديدة	سطر فارغ ثم سطر جديد

يمكن إيقاف هذه الأوامر من القائمة إن كانت تتعارض مع ما تكتبه.

الإعدادات

من قائمة الأيقونة اختر "فتح الإعدادات"، أو افتح %APPDATA%\AltScribo\settings.json:

الإعداد	الوصف	الافتراضي
hotkey	الاختصار العام	alt+s
language	لغة التعرف على الكلام	ar-SA
timeout_seconds	مهلة انتظار الخدمة بالثواني	15
max_gain	أقصى تضخيم للصوت الخافت	4.0
sample_rate	معدل أخذ العينات	16000
engine	محرك التعرف: google أو whisper	google
whisper_model	نموذج Whisper: tiny أو base أو small أو medium أو large-v3	small
auto_punctuation	الترقيم التلقائي لنص Google	true
spoken_punctuation	تفعيل أوامر الترقيم المنطوقة	true

أعد تشغيل الأداة بعد أي تعديل يدوي على الملف (ما تغيّره من القائمة يُحفظ ويعمل فورًا). ويمكنك تغيير language إلى لهجة أخرى مثل ar-EG أو ar-AE.

الخصوصية

مع محرك Google يُرسل الصوت المسجَّل إلى خدمة Google للتعرف على الكلام، ولذلك يحتاج إلى اتصال بالإنترنت. ومع محرك Whisper لا يغادر الصوت جهازك. لا تُحفظ التسجيلات ولا النصوص المُملاة على جهازك؛ سجلّ التشغيل في %APPDATA%\AltScribo\altscribo.log يحوي أحداث التشغيل والأخطاء فقط.

التشغيل من المصدر

python -m venv venv
venv\Scripts\pip install -r requirements.txt
venv\Scripts\python main.py

لتفعيل التعرف المحلي ثبّت requirements-whisper.txt بدل requirements.txt. يتطلب ذلك Python من 3.12 إلى 3.14، لأن حزم ctranslate2 وonnxruntime غير متوفرة لـ Python 3.15 بعد.

بناء ملف EXE

venv\Scripts\pyinstaller AltScribo.spec --noconfirm

يظهر الناتج في dist\AltScribo\AltScribo.exe. إن كانت faster-whisper مثبّتة في بيئة البناء يُضمَّن التعرف المحلي تلقائيًا (ويزيد حجم البرنامج)، وإلا يُبنى بمحرك Google فقط.

بنية الكود

• altscribo/config.py: المسارات والإعدادات والسجلّ.
• altscribo/recorder.py: التسجيل من الميكروفون.
• altscribo/transcriber.py: تحويل الصوت إلى نص بمحرك Google أو Whisper.
• altscribo/punctuation.py: الترقيم التلقائي وأوامر الترقيم المنطوقة.
• altscribo/startup.py: اختصار التشغيل مع Windows.
• altscribo/menu.py: قائمة الأيقونة المخصصة.
• altscribo/injector.py: اللصق عبر الحافظة مع حفظها وإعادتها.
• altscribo/app.py: أيقونة الشريط والاختصار والإشعارات.

المتطلبات

Windows 10 أو أحدث، وميكروفون، واتصال بالإنترنت (لمحرك Google، أو لتنزيل نموذج Whisper أول مرة فقط).