PAGASUS-PRO

**الخطوة 2 — تثبيت Python 3**```bash
sudo apt install python3 python3-pip -y

**الخطوة 4 — تثبيت scrcpy** *(اختياري — لانعكاس الشاشة)*```bash
sudo apt install scrcpy -y

**الخطوة 6 — استنساخ المستودع**```bash
git clone https://github.com/thakur2309/PAGASUS-PRO.git
cd PAGASUS-PRO

> هل تريد تشغيل إصدار أقدم؟
> ```bash
> python3 pegasusV-1.2.py   # Run v1.2
> python3 pegasus_v1.1.py   # Run v1.1
> ```

---

### 🔷 Linux — Arch / Manjaro / BlackArch

**الخطوة 1 — تحديث النظام**```bash
sudo pacman -Syu

**الخطوة 3 — تثبيت scrcpy** *(اختياري)*```bash
sudo pacman -S scrcpy

**الخطوة 5 — استنساخ المستودع**```bash
git clone https://github.com/thakur2309/PAGASUS-PRO.git
cd PAGASUS-PRO

> هل تريد تشغيل إصدار أقدم؟
> ```bash
> python3 pegasusV-1.2.py   # Run v1.2
> python3 pegasus_v1.1.py   # Run v1.1
> ```

---

### 🪟 Windows 10 / 11

**الخطوة 1 — تثبيت Python 3**

1. قم بالتنزيل من: https://www.python.org/downloads/
2. قم بتشغيل برنامج التثبيت
3. ✅ **حدد "Add Python to PATH"** قبل النقر على Install

تحقق في Command Prompt أو PowerShell:```cmd
python --version

> يتم إضافة ADB تلقائيًا إلى PATH — لا حاجة لإعداد يدوي.

تحقق:```cmd
adb version

تحقق:```powershell
scrcpy --version

تحقق:```powershell
git --version

> ✅ يقوم هذا بتثبيت Python و ADB و scrcpy و Git دفعة واحدة. أعد تشغيل PowerShell بعد ذلك.

---

**الخطوة 6 — استنساخ المستودع**

افتح **Command Prompt** أو **PowerShell**:```powershell
git clone https://github.com/thakur2309/PAGASUS-PRO.git
cd PAGASUS-PRO

**الخطوة 8 — تشغيل Pegasus v1.3**```powershell
python pegasus_v_1.3.py

**الخطوة 2 — تثبيت Python 3**```bash
brew install python

**الخطوة 3 — تثبيت ADB**```bash
brew install android-platform-tools

**الخطوة 4 — تثبيت scrcpy** *(اختياري)*```bash
brew install scrcpy

**الخطوة 6 — استنساخ المستودع**```bash
git clone https://github.com/thakur2309/PAGASUS-PRO.git
cd PAGASUS-PRO

> هل تريد تشغيل إصدار أقدم؟
> ```bash
> python3 pegasusV-1.2.py   # Run v1.2
> python3 pegasus_v1.1.py   # Run v1.1
> ```

---

### 📱 Termux (التشغيل مباشرة من هاتفك الأندرويد)

> **ما هو Termux؟** Termux هو محاكي طرفية أندرويد يوفر بيئة Linux كاملة على هاتفك — دون الحاجة إلى root. يمكنك تشغيل Pegasus مباشرة من جهاز الأندرويد الخاص بك باستخدام Termux.

> ⚠️ **ملاحظة:** `scrcpy` (Screen Mirror — الخيار 5) **لا يعمل** في Termux لأنه يتطلب خادم عرض غير متوفر على أندرويد. جميع الميزات الأخرى تعمل بشكل طبيعي.

#### تثبيت Termux

1. **ثبّت Termux من F-Droid** *(موصى به)*  
   👉 https://f-droid.org/packages/com.termux/  
   > ⚠️ نسخة Termux على Google Play Store قديمة — استخدم دائمًا نسخة F-Droid.

2. افتح Termux واتبع الخطوات أدناه:

**الخطوة 1 — تحديث الحزم**```bash
pkg update && pkg upgrade -y

**الخطوة 3 — تثبيت Git**```bash
pkg install git -y

تحقق من التثبيت:```bash
adb version

**الخطوة 6 — استنساخ المستودع**```bash
git clone https://github.com/thakur2309/PAGASUS-PRO.git
cd PAGASUS-PRO

**الخطوة 8 — تشغيل Pegasus v1.3**```bash
python pegasus_v_1.3.py

4. افصل كابل USB، ثم ابحث عن عنوان IP للجهاز الهدف:  
   → الإعدادات → Wi-Fi → اضغط على الشبكة المتصلة → عنوان IP
5. شغّل Pegasus واختر **`[2] Connect a Device`**
6. أدخل عنوان IP — الاتصال اللاسلكي نشط الآن ✅

**الطريقة 2 — إدارة نفس الجهاز (localhost)**

إذا كنت تريد إدارة هاتفك الخاص مباشرة:```bash
adb connect localhost:5555

### التبديل إلى الوضع اللاسلكي (Wi-Fi ADB)

> مطلوب إعداد USB لمرة واحدة. بعد ذلك، انتقل إلى الوضع اللاسلكي بالكامل.

1. قم بتوصيل الجهاز عبر كابل USB
2. شغّل Pegasus → اختر **`[2] Connect a Device`**
3. أدخل `y` عند طلب تمكين وضع TCP/IP
4. ابحث عن عنوان IP لجهازك: **الإعدادات → Wi-Fi → اضغط على الشبكة المتصلة → عنوان IP**
5. أدخل عنوان IP في Pegasus عند المطالبة
6. افصل كابل USB — الاتصال الآن لاسلكي ✅

---

## 🚀 الاستخدام```bash
# Linux / macOS — Latest Version
python3 pegasus_v_1.3.py

# Windows — Latest Version
python pegasus_v_1.3.py

# Run older versions
python3 pegasusV-1.2.py    # v1.2
python3 pegasus_v1.1.py    # v1.1

---

## 📂 ملفات الإخراج

تُحفظ جميع الملفات المُنشأة في **نفس الدليل** الذي تشغّل فيه السكربت.

| اسم الملف | يُنشأ بواسطة |
|----------|-------------|
| `screen.png` | Take Screenshot |
| `record.mp4` | Screen Recording |
| `apk_list.txt` | Show APK List |
| `contacts.txt` | Dump Contacts |
| `device_log.txt` | Get Device Logs |
| `storage_info.txt` | Check Storage |
| `sms_logs.txt` | Dump SMS (Security Tools) |
| `call_logs.txt` | Dump Call Logs (Security Tools) |
| `connection_log.txt` | Auto-generated connection session log |

---

## 📋 ملخّص الاعتماديات

| الاعتمادية | مطلوبة | الغرض | التثبيت (Linux/macOS) | التثبيت (Termux) |
|-----------|----------|---------|-----------------------|-----------------|
| Python 3.7+ | ✅ نعم | تشغيل الأداة | `sudo apt install python3` | `pkg install python` |
| colorama | ✅ نعم | إخراج ملوّن في الطرفية | `pip3 install colorama` | `pip install colorama` |
| ADB | ✅ نعم | التواصل مع الجهاز | `sudo apt install adb` | `pkg install android-tools` |
| scrcpy | ⚪ اختيارية | ميزة Screen Mirror | `sudo apt install scrcpy` | ❌ Termux mein kaam nahi |
| nmap | ⚪ اختيارية | فحص الشبكة في Security Tools | `sudo apt install nmap` | `pkg install nmap` |
| Git | ⚪ مُوصى بها | استنساخ المستودع | `sudo apt install git` | `pkg install git` |

> 💡 **اختصار:** `pip install -r requirements.txt` se sab Python dependencies ek baar mein install ho jaati hain.

---

## 📁 مرجع الملفات

| الملف | الإصدار | أمر التشغيل |
|------|---------|-------------|
| `pegasus_v_1.3.py` | v1.3 *(الأحدث)* | `python3 pegasus_v_1.3.py` |
| `pegasusV-1.2.py` | v1.2 | `python3 pegasusV-1.2.py` |
| `pegasus_v1.1.py` | v1.1 | `python3 pegasus_v1.1.py` |
| `requirements.txt` | — | `pip install -r requirements.txt` |

---

## 📝 سجل التغييرات

### v1.3 — الإصدار الأحدث
- ✅ **إضافة قائمة فرعية Advanced Security Tools** (الخيار 22) — 10 ميزات:
  - Root Detection (multi-method)، APK Permissions Audit، Full Security Audit
  - Debuggable Apps Scanner، Interactive Shell، Network Security Check
  - SMS/Call Log Dump، Security Log Filter، Vulnerability Scanner، Network Monitor
- ✅ **سجل اتصال الجهاز** مع الطوابع الزمنية ومدة الجلسة (الخيار 23)
- ✅ **دعم أجهزة متعددة** — عرض القائمة والاختيار عند اكتشاف عدة أجهزة
- ✅ **قطع اتصال لاسلكي انتقائي** — اختيار جهاز محدد أو قطع اتصال الكل
- ✅ **ADB Troubleshoot** — إيقاف/إعادة تشغيل خادم ADB لإصلاح الاتصالات العالقة (الخيار 21)
- ✅ **تحسين استخراج جهات الاتصال** — تحليل نظيف بتنسيق `Name: Number`
- ✅ **قائمة APK أنظف** — تعرض أسماء الحزم فقط، دون فوضى المسارات الخام
- ✅ **تخزين مقروء للبشر** — `df -h` لقراءة سهلة
- ✅ **تسجيل اتصال تلقائي** — يُكتب سجل الجلسة عند البدء والخروج

### v1.2 — `pegasusV-1.2.py`
- ✅ توسيع إلى قائمة رئيسية كاملة من 20 خيارًا
- ✅ إيقاف تشغيل الجهاز وإعادة تشغيله عن بُعد
- ✅ تثبيت APK (sideload) وإلغاء التثبيت
- ✅ دفع وسحب الملفات (نقل ثنائي الاتجاه)
- ✅ إرسال SMS عبر Android intent
- ✅ استخراج جهات اتصال الجهاز
- ✅ استخراج سجل الجهاز عبر Logcat
- ✅ تبديل حالة Wi-Fi على الجهاز
- ✅ فحص معلومات التخزين
- ✅ تشغيل الكاميرا عن بُعد وسحب الصورة
- ✅ إضافة وحدة `re` لتحليل جهات الاتصال

### v1.1 — `pegasus_v1.1.py`
- ✅ فحص معلومات الجهاز (الطراز، إصدار Android، البطارية)
- ✅ اتصال وفصل ADB عبر USB و Wi-Fi
- ✅ تسجيل الشاشة بمدة مخصصة
- ✅ عكس الشاشة المباشر عبر scrcpy
- ✅ عرض الحزم المثبّتة وحفظها في ملف
- ✅ التقاط لقطة شاشة وسحبها

### v1.0
- ✅ الإصدار الأولي — غلاف ADB أساسي
- ✅ واجهة قائمة طرفية تفاعلية
- ✅ فاحص الاعتماديات عند بدء التشغيل
- ✅ إخراج طرفي مرمّز بالألوان

---

## 📜 الترخيص

هذا المشروع مرخّص بموجب **MIT License**.```
MIT License

Copyright (c) 2024 thakur2309

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.