وثائق المطورين
خريطة تقنية مختصرة لفهم بنية المشروع وكيفية توسعته.
المعمارية العامة
- واجهة QML عبر Quickshell.
- Hyprland للتعامل مع النوافذ والشاشات والأحداث.
- خدمات خلفية في `config/quickshell/services`.
- سكربتات Python/Bash في `config/quickshell/scripts` و `scripts`.
نقطة البداية
المكوّن الرئيسي في:
config/quickshell/shell.qml
هذا الملف يجمع الطبقات الأساسية مثل الشريط العلوي والقائمة الجانبية والكبسولة الذكية.
إدارة الإعدادات
- قراءة الإعدادات من `~/.nibrasshell.json` عبر `ConfigStore.qml`.
- الواجهة تستخدم `App.qml` لتوحيد المسارات والأوامر.
- الكاش في `~/.cache/nibrasshell`.
إدارة الثيمات والخلفيات
- `ThemeManager.qml` مسؤول عن تحميل الثيمات وتطبيقها.
- `WallpaperController.qml` لإدارة الخلفيات الثابتة والديناميكية.
- `DepthEffectController.qml` لتوليد طبقات العمق.
الخدمات الأساسية
| الخدمة | الدور |
|---|---|
| SystemService | مراقبة الموارد وتحليل الإقلاع وارتفاعات الأداء |
| Weather | جلب الطقس والتحليل الذكي والتنبيهات |
| MusicService | تكامل MPRIS والتعليق الذكي |
| NotifManager | إدارة الإشعارات ووضع عدم الإزعاج |
| ClipboardService | مراقبة الحافظة وإدارتها |
السكربتات المهمة
Python
- monitoring: `top_cpu_usage.py`, `top_ram_usage.py`
- wallpapers: `scan_wallpapers.py`, `dynamic-m3.py`
- depth: `create_depth_image_rembg.py`
- network: `list_wifi.py`, `connect_wifi.py`
Bash
- `cpu_usage.sh` و `ram_usage.sh`
- `internet.sh` و `temp.sh`
- `playerctl.sh`
تشغيل Quickshell
config/quickshell/run.fish
هذا السكربت يضبط log rules لتقليل الضوضاء أثناء التشغيل.
ملاحظات تطوير
- الكبسولة الذكية في `config/quickshell/windows/smart_capsule`.
- القائمة الجانبية في `config/quickshell/windows/leftwindow`.
- الإعدادات في `config/quickshell/windows/settings`.