← العودة الى التوثيق

دليل تثبيت Linux

سيرشدك هذا الدليل خلال تثبيت Sokuji على انظمة Linux. يتوفر Sokuji كحزمة .deb لتوزيعات Debian/Ubuntu وكـ AppImage للتوافق الشامل.

تحميل لنظام Linux

متطلبات النظام

Ubuntu 20.04 او احدث، Debian 10 او احدث، او توزيعة مكافئة
معالج 64 بت
4 جيجابايت رام كحد ادنى (8 جيجابايت موصى بها)
100 ميجابايت مساحة قرص متاحة
PulseAudio او PipeWire لدعم الصوت
اتصال بالانترنت لخدمات الذكاء الاصطناعي

خطوات التثبيت

الخطوة 1: تحميل Sokuji

قم بزيارة صفحة الاصدارات الرسمية على GitHub لتحميل احدث اصدار من Sokuji لنظام Linux.

الحزم المتاحة

حزمة .deb - لتوزيعات Debian/Ubuntu
.AppImage - حزمة شاملة لجميع توزيعات Linux
حزمة .rpm - لتوزيعات Fedora/RHEL (اذا كانت متاحة)

الخطوة 2: تثبيت حزمة .deb (Ubuntu/Debian)

اذا كنت تستخدم Ubuntu او Debian او مشتقاتها، يوصى بحزمة .deb.

الطريقة 1: باستخدام الواجهة الرسومية

افتح مدير الملفات وانتقل الى مجلد التنزيلات
انقر نقرا مزدوجا على ملف sokuji_*.deb
انقر على "تثبيت" في مركز البرامج الذي يفتح
ادخل كلمة المرور عند المطالبة

الطريقة 2: باستخدام الطرفية

افتح الطرفية وقم بتشغيل الاوامر التالية:

cd ~/Downloads
sudo dpkg -i sokuji_*.deb

اذا واجهت مشاكل في التبعيات، اصلحها بـ:

sudo apt-get install -f

الخطوة 3: تثبيت AppImage (شامل)

يعمل AppImage على جميع توزيعات Linux ولا يتطلب تثبيتا.

اعداد AppImage

حمل ملف AppImage من صفحة الاصدارات
اجعله قابلا للتنفيذ:
```
chmod +x sokuji-*.AppImage
```
شغل التطبيق:
```
./sokuji-*.AppImage
```

اختياري: التكامل مع النظام

لدمج AppImage مع نظامك:

mkdir -p ~/.local/bin
cp sokuji-*.AppImage ~/.local/bin/sokuji
chmod +x ~/.local/bin/sokuji

الآن يمكنك تشغيل Sokuji من اي مكان بكتابة sokuji في الطرفية.

الخطوة 4: تكوين التشغيل الاول

عند تشغيل Sokuji لاول مرة، ستحتاج الى تكوينه:

الاعداد الاولي

شغل Sokuji من قائمة التطبيقات او الطرفية
حدد لغة الواجهة المفضلة
قم بتكوين مزود الذكاء الاصطناعي (OpenAI، Google Gemini، الخ.)
ادخل مفتاح API للمزود المحدد
حدد اجهزة الميكروفون ومكبرات الصوت
اختبر الصوت للتاكد من ان كل شيء يعمل

Sokuji جاهز الآن للاستخدام! يمكنك بدء الترجمة في الوقت الفعلي بالنقر على زر بدء الجلسة.

استكشاف الاخطاء واصلاحها

مشاكل الصوت

اذا واجهت مشاكل في الصوت:

تاكد من ان PulseAudio او PipeWire يعمل: systemctl --user status pipewire
تحقق من اذونات الصوت: groups $USER يجب ان يتضمن 'audio'
اعد تشغيل خدمة الصوت: systemctl --user restart pipewire

رفض الاذن

اذا حصلت على اخطاء "Permission denied":

sudo usermod -a -G audio $USER

ثم سجل الخروج واعد تسجيل الدخول لتطبيق التغييرات.

تبعيات مفقودة

ثبت المكتبات المطلوبة:

sudo apt-get update
sudo apt-get install libgtk-3-0 libnotify4 libnss3 libxss1 \
    libxtst6 xdg-utils libatspi2.0-0 libdrm2 libgbm1

AppImage لا يعمل

اذا فشل AppImage في التشغيل، ثبت FUSE:

sudo apt-get install fuse libfuse2

للانظمة الاحدث (Ubuntu 22.04+)، قد تحتاج الى:

sudo apt-get install libfuse2t64