عن المشروع

Miraru (anime-tracker) هو تطبيق سطح مكتب، بواجهة خلفية Python/FastAPI وSQLite، مخصص لإدارة مكتبة شخصية من الأنمي والمسلسلات والأفلام. الواجهة الأمامية مبنية بـ HTML/CSS/JS بدون أطر عمل، وتُحزَّم باستخدام PyInstaller لتوفير ملف تنفيذي محمول أو مثبّت على Windows. البحث والمصادر: يدمج ثمانية مصادر للأنمي (AniList، Jikan v4، Kitsu، Crunchyroll، AnimeFLV، AnimePlanet، AnimeAV1 وMAL)، ويمكن الاستعلام عنها بشكل منفصل أو جميعها معًا. للأفلام والمسلسلات غير الأنمي يستخدم بيانات TMDB. يعرض محرك البحث معاينة قبل إضافة بطاقة. التنظيم: يتيح قوائم مخصصة، مفضلات، الموسم، التقييم والملاحظات؛ عرض شبكي أو جدول مضغوط؛ تقييم سريع بالنجوم من البطاقة؛ السحب والإفلات بين القوائم؛ التحديد المتعدد لإجراءات جماعية (الحالة، القائمة، المفضلة، الحذف). الواجهة والإنتاجية: لوحة أوامر بـ Ctrl+K، اختصارات لوحة المفاتيح (/، Esc، N)، معاملات بحث مثل genre:، score:، eps:، year: أو fav:، وشريط تراجع عند الحذف لمدة خمس ثوانٍ. الاستكشاف: تتضمن كل بطاقة مقطعًا دعائيًا، المنصات التي يمكن المشاهدة عليها، وعناوين مشابهة (AniList). توجد إحصائيات مع مخطط دائري، حبوب الأنواع والوقت حتى الإكمال؛ قسم المستجدات مع الحلقات القادمة والأنمي المعروض حاليًا؛ تقويم أسبوعي مع تذكير بحلقات اليوم؛ أداة «متابعة المشاهدة» ووضع الماراثون؛ توصيات تلقائية حسب الأنواع المفضلة؛ وإشعارات ويب للحلقات الجديدة. المزامنة والجوّال: يوفر مزامنة اختيارية مع Google Sheets ووصولًا جوّالًا عبر WiFi المحلي من خلال PWA قابل للتثبيت، يُفعَّل برمز PIN من الحاسوب. الواجهة متاحة بالإسبانية والإنجليزية والفرنسية والألمانية، مع وضعين فاتح وداكن. التثبيت: للمستخدمين ملف تنفيذي محمول (Miraru-Portable.exe) لا يتطلب Python ويحفظ البيانات بجانب الملف، أو مثبّت (Miraru-Setup.exe) مع اختصارات. توجد أيضًا ملفات تعريف للنشر على Scoop أو winget. لتشغيله من الكود المصدري يكفي Miraru.vbs، الذي يحدد موقع Python، يثبّت التبعيات ويفتح المتصفح؛ كما يمكن تشغيله يدويًا عبر launcher.py أو main.py. تُنشأ الملفات التنفيذية تلقائيًا عند دفع وسم عبر GitHub Actions، أو محليًا باستخدام compilar.bat وbuild.py --portable. رخصة MIT.