https://github.com/np4abdou1/ani-cli-arabic
A cli tool to browse and play anime - IN ARABIC!
https://github.com/np4abdou1/ani-cli-arabic
anime anime-arabic arabic arabic-anime automation cli cli-app cli-tool cli-tools cool-stuff python tui
Last synced: 9 days ago
JSON representation
A cli tool to browse and play anime - IN ARABIC!
- Host: GitHub
- URL: https://github.com/np4abdou1/ani-cli-arabic
- Owner: np4abdou1
- License: gpl-3.0
- Created: 2025-11-25T20:29:34.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-03-18T18:55:17.000Z (18 days ago)
- Last Synced: 2026-03-19T08:05:47.796Z (17 days ago)
- Topics: anime, anime-arabic, arabic, arabic-anime, automation, cli, cli-app, cli-tool, cli-tools, cool-stuff, python, tui
- Language: Python
- Homepage: https://ani-cli-arabic.pages.dev/
- Size: 8.12 MB
- Stars: 29
- Watchers: 1
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.ar.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Security: .github/SECURITY.md
Awesome Lists containing this project
README
To select English language click the button:
https://github.com/user-attachments/assets/a6c6882a-7c50-4a8d-aa9c-e56a6d4ff7eb
---
## 📦 ��لتثبيت
### المتطلبات
قبل التثبيت، تأكد من توفر:
- **بايثون 3.8 أو أحدث** (يُنصح ببايثون 3.12، تجنب 3.13+ بسبب مشاكل ترجمة numpy)
- **مشغل الوسائط MPV** (للبث)
- **ffmpeg** (لمعالجة الفيديو)
- **fzf** (للبحث الضبابي)
> **⚠️ ملاحظة مهمة:** إذا كنت تستخدم نظام ماك، قم بالبناء من المصدر.
### الطريقة الأولى: التثبيت عبر pip (مُستحسن)
أسهل طريقة للبدء:
```bash
pip install ani-cli-arabic
```
تشغيل التطبيق:
```bash
ani-cli-arabic
# أو استخدم الأمر المختصر
ani-cli-ar
```
للتحديث إلى أحدث إصدار:
```bash
pip install --upgrade ani-cli-arabic
```
### الطريقة الثانية: آرتش لينكس (AUR)
لمستخدمي آرتش لينكس، التثبيت عبر AUR:
```bash
# باستخدام yay
yay -S ani-cli-arabic
# باستخدام paru
paru -S ani-cli-arabic
```
### الطريقة الثالثة: من المصدر
تريد تشغيل نسخة التطوير؟
**على ويندوز:**
```powershell
# ثبت MPV أولاً
scoop install mpv
# استنسخ المستودع وثبت المتطلبات
git clone https://github.com/np4abdou1/ani-cli-arabic.git
cd ani-cli-arabic
pip install -r requirements. txt
python main.py
```
**على لينكس (Debian/Ubuntu):**
```bash
# احصل على المتطلبات
sudo apt update && sudo apt install mpv git python3-pip ffmpeg
# استنسخ وشغّل
git clone https://github.com/np4abdou1/ani-cli-arabic.git
cd ani-cli-arabic
pip install -r requirements.txt
python3 main.py
```
---
## 🎯 ماذا يمكنك أن تفعل؟
إليك كل ما تقدمه هذه الأداة:
### البث والتشغيل
- **خيارات جودة متعددة**: شاهد بدقة 1080p أو 720p أو 480p حسب سرعة الإنترنت لديك
- **التنزيل الجماعي**: نزّل عدة حلقات دفعة واحدة للمشاهدة بلا اتصال
- **دعم الإعلانات التشويقية**: شاهد إعلانات يوتيوب التشويقية قبل البدء بالأنمي
- **الاستئناف من السجل**: تابع من حيث توقفت بالضبط (به بعض الأخطاء)
### الاكتشاف والتصفح
- **بحث عن الأنمي**: ابحث عن أي أنمي أو فيلم أنمي بالاسم (يدعم العناوين الإنجليزية واليابانية والعربية)
- **الرائج الآن**: شاهد ما هو شائع حالياً
- **الأعلى تقييماً**: تصفح أعلى الأنمي تقييماً على الإطلاق
- **التصفح حسب الفئة**: صنف حسب الأكشن، الرومانسية، الإيسيكاي، و12 فئة أخرى
- **التصفح حسب الاستوديو**: ابحث عن أنمي من استوديوهات Toei Animation، MAPPA، Ufotable، وأكثر من 20 استوديو آخر
- **أحدث الإصدارات**: ابقَ على اطلاع بأحدث الأنمي
### المكتبة الشخصية
- **سجل المشاهدة**: تتبع كل ما شاهدته مع الطوابع الزمنية
- **نظام المفضلة**: ضع إشارة مرجعية على أنميك المفضل للوصول السريع
- **تتبع الحلقات**: التطبيق يتذكر في أي حلقة أنت
### الواجهة والتجربة
- **واجهة طرفية غنية (TUI)**: واجهة طرفية جميلة مبنية بمكتبة Rich
- **17 سمة لونية**: اختر من بين الأزرق، الأحمر، البنفسجي، الغروب، النعناع، الخزامى، والمزيد
- **حضور Discord الغني**: أظهر ما تشاهده على Discord مع ملصقات الأنمي
- **تنقل سلس**: أزرار تحكم بديهية
### المميزات التقنية
- **بلا إعلانات**: تجربة بث نظيفة
- **تحديثات تلقائية**: فاحص إصدارات مدمج يخطرك بالإصدارات الجديدة، ونعم يمكن إيقاف هذا
- **دعم MPV/VLC**: اختر مشغل الوسائط المفضل لديك
- **مُثبت تلقائي للمتطلبات**: يفحص ويثبت المتطلبات المفقودة تلقائياً، للكسالى...
- **وضع سطر الأوامر**: وضع سطر أوامر بسيط للبحث السريع (`ani-cli-ar -i "ناروتو"`) _الوضع التفاعلي يعمل أيضاً إذا كانت الطرفية ضيقة جداً_
- **متعدد المنصات**: يعمل على ويندوز ولينكس
---
## 🎮 كيفية الاستخدام
1. **شغّل التطبيق**: نفذ `ani-cli-arabic` أو `ani-cli-ar`
2. **تصفح أو ابحث**: استخدم القائمة الرئيسية للبحث، أو عرض الرائج، أو تصفح الفئات
3. **اختر أنمي**: تنقل بأزرار الأسهم واضغط Enter
4. **اختر حلقة**: اختر أي حلقة تريد مشاهدتها
5. **اختر الجودة**: اختر جودة الفيديو المفضلة لديك
6. **استمتع**: سيُشغَّل MPV ويبدأ البث
يمكنك أيضاً استخدام الوضع التفاعلي للبحث السريع:
```bash
ani-cli-ar -i "ون بيس"
```
---
## ⌨️ اختصارات لوحة المفاتيح
| المفتاح | الوظيفة |
|---------|----------|
| **↑ / ↓** | التنقل عبر القوائم |
| **Enter** | اختيار/تأكيد الخيار |
| **G** | الانتقال مباشرة إلى رقم حلقة |
| **B** | العودة إلى الشاشة السابقة |
| **Q / Esc** | الخروج من التطبيق |
| **Space** | إيقاف/استئناف الفيديو (في المشغل) |
| **← / →** | الترجيع/التقديم 5 ثوان |
| **F** | تبديل ملء الشاشة |
---
## ⚙️ الإعدادات
يتم حفظ الإعدادات محلياً في `~/.ani-cli-arabic/database/config.json`
### الإعدادات المتاحة
ادخل قائمة الإعدادات من الشاشة الرئيسية للتخصيص:
- **الجودة الافتراضية**: حدد الجودة المفضلة لديك (1080p، 720p، أو 480p)
- **مشغل الوسائط**: اختر بين MPV أو VLC
- **الحلقة التالية تلقائياً**: تبديل الانتقال التلقائي للحلقة
- **حضور Discord الغني**: إظهار أو إخفاء نشاط Discord
- **سمة اللون**: اختر من بين 17 مخطط لوني جميل:
- أزرق، أحمر، أخضر، بنفسجي، سماوي، أصفر، وردي، برتقالي، أزرق مخضر، أرجواني
- ليموني، مرجاني، خزامى، ذهبي، نعناعي، زهري، الغروب
- **التحليلات**: الاشتراك/إلغاء الاشتراك في إحصائيات الاستخدام المجهولة - مفعّل افتراضياً
- **فحص التحديثات**: تبديل إشعارات التحديث التلقائية
يمكنك أيضاً تعديل ملف الإعدادات يدوياً إذا أردت.
---
## 👥 المساهمون
شكر خاص لكل من ساعد في إنجاح هذا المشروع:
[](https://github.com/np4abdou1/ani-cli-arabic/graphs/contributors)
**المساهم��ن الرئيسيون:**
- [@np4abdou1](https://github.com/np4abdou1) - المنشئ والمطور الرئيسي
- [@Anas-Tou](https://github.com/Anas-Tou) - مساهم
تريد المساهمة؟ لا تتردد في فتح قضية أو تقديم طلب سحب!
---
## 📄 الرخصة
هذا المشروع مرخص بموجب **رخصة جنو العمومية الإصدار 3.0**.
يمكنك استخدام وتعديل وتوزيع هذا البرنامج بحرية تحت شروط رخصة GPL-3.0. راجع ملف [LICENSE](LICENSE) للنص القانوني الكامل.
**ببساطة:**
- ✅ استخدمه لأغراض شخصية أو تجارية
- ✅ عدّل الكود المصدري
- ✅ وزّعه على الآخرين
- ⚠️ أي تعديلات يجب أن تكون مفتوحة المصدر أيضاً تحت GPL-3.0
- ⚠️ قم بتضمين إشعار حقوق النشر الأصلي
---
### ⚠️ إشعار مهم
> [! CAUTION]
> **باستخدامك لهذا البرنامج أنت تفهم:**
>
> - يتم جمع إحصائيات استخدام مجهولة لشعار إحصائيات صفحة GitHub (يمكن تعطيلها في الإعدادات)
> - المشروع مرخص بموجب GPL-3.0 - راجع [LICENSE](LICENSE) للتفاصيل
> - نحن لا نستضيف أي محتوى؛ جميع البث من مصادر خارجية
> - هذه الأداة للاستخدام الشخصي والأغراض التعليمية فقط
---
صُنع بـ ❤️ من مجتمع الأنمي
[⭐ ضع نجمة لهذا المستودع](https://github.com/np4abdou1/ani-cli-arabic) | [🐛 أبلغ عن الأخطاء](https://github.com/np4abdou1/ani-cli-arabic/issues) | [💬 النقاشات](https://github.com/np4abdou1/ani-cli-arabic/discussions)