الخطوات الأولى

لقد قمت بتثبيت تسوميكي وطبقت خطوات ما بعد التثبيت. إليك كيفية الحصول على لوحة عاملة بسرعة.

1. تشغيل اللوحة

من مجلد مشروع تسوميكي، شغّل:

./init.sh -start

إذا كان هيبرلاند يعمل، يجب أن يظهر الشريط في أعلى شاشتك. إذا لم يظهر الشريط، تحقق من مخرجات الأخطاء في الطرفية وراجع استكشاف الأخطاء وإصلاحها.

نصيحة

يمكنك إيقاف تسوميكي في أي وقت باستخدام:

pkill tsumiki

2. إعداد التشغيل التلقائي

أضف تسوميكي إلى إعدادات هيبرلاند الخاصة بك لبدء التشغيل تلقائياً عند تسجيل الدخول:

افتح ~/.config/hypr/hyprland.conf وأضف:

exec-once = sleep 5; ~/.config/tsumiki/init.sh -start

التأخير sleep 5 يعطي هيبرلاند وقتاً للتهيئة الكاملة. اضبط المسار إذا قمت باستنساخ تسوميكي في مجلد مختلف.

3. نسخ الإعدادات النموذجية

يأتي تسوميكي مع إعدادات نموذجية كاملة. انسخها للحصول على نقطة بداية صالحة:

cp example/config.toml config.toml

نصيحة

افتح example/config.toml في محرر نصوص لرؤية جميع الخيارات المتاحة مع التوثيق.

4. تخصيص التخطيط

عدّل config.toml واضبط قسم [layout]. كل قسم (left_section, middle_section, right_section) هو مصفوفة من أسماء الأدوات:

[layout]
left_section = ["workspaces", "window_title"]
middle_section = ["date_time"]
right_section = ["volume", "battery", "system_tray", "power"]

هذا ينشئ شريطاً مع:

القسم	الأدوات
اليسار	مبدل مساحات العمل، عنوان النافذة النشطة
الوسط	التاريخ والوقت الحاليين
اليمين	التحكم في الصوت، حالة البطارية، علبة النظام، قائمة الطاقة

5. إعادة التحميل لتطبيق التغييرات

بعد حفظ تعديلاتك، أعد تشغيل تسوميكي:

pkill tsumiki
./init.sh -start

إذا كانت الإعدادات صالحة، يجب أن يظهر الشريط مرة أخرى مع تخطيطك الجديد.

6. اختبار الأدوات الشائعة

حاول التفاعل مع أدواتك:

• مساحات العمل — انقر للتبديل، مرر للتنقل بين أسطح المكتب.
• الصوت — انقر لكتم الصوت/إلغاء كتمه، مرر للضبط.
• البطارية — مرر لرؤية الوقت المتبقي وحالة الشحن.
• التاريخ/الوقت — انقر لفتح التقويم ولوحة الإشعارات.
• علبة النظام — يجب أن تظهر أيقونات العلبة تلقائياً.

7. اجعلها خاصة بك

• غيّر الألوان — راجع صنع الثيمات لتخصيص SCSS أو Matugen للثيمات التلقائية القائمة على خلفية الشاشة.
• أضف المزيد من الأدوات — تصفح مرجع الأدوات لأكثر من 45 أداة متاحة.
• فعّل الوحدات — جرب الإرساء أو مشغل التطبيقات أو OSD.
• هيئ السلوك — راجع مرجع الإعدادات الكامل لكل خيار.

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

إذا كان هناك خطأ ما:

• الشريط لا يظهر — تحقق من أن هيبرلاند يعمل وأنه لا توجد أشرطة أخرى قيد التشغيل (pkill waybar).
• لا توجد أيقونات — تحقق من تثبيت JetBrains Nerd Font وتكوينه كخط للطرفية/الواجهة.
• وظائف مفقودة — بعض الأدوات تتطلب أدوات خارجية (مثل playerctl للوسائط، brightnessctl للسطوع). شغّل ./init.sh -setup للتأكد من تثبيت جميع التبعيات.
• أخطاء SASS — قد يكون ملف config.toml غير صالح. قارنه مع example/config.toml.

لمزيد من المساعدة، راجع صفحات الأسئلة الشائعة أو استكشاف الأخطاء وإصلاحها.