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   # Запустить v1.2
> python3 pegasus_v1.1.py   # Запустить 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   # Запустить v1.2
> python3 pegasus_v1.1.py   # Запустить v1.1
> ```

---

### 📱 Termux (запуск прямо с вашего Android-телефона)

> **Что такое Termux?** Termux — это эмулятор терминала для Android, предоставляющий полноценное окружение Linux на вашем телефоне — root не требуется. Вы можете запускать Pegasus прямо с вашего Android-устройства, используя Termux.

> ⚠️ **Примечание:** `scrcpy` (Зеркалирование экрана — Опция 5) **не работает** в Termux, так как для него требуется сервер отображения, недоступный на Android. Все остальные функции работают нормально.

#### Установка 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` | Сделать скриншот |
| `record.mp4` | Запись экрана |
| `apk_list.txt` | Показать список APK |
| `contacts.txt` | Выгрузить контакты |
| `device_log.txt` | Получить логи устройства |
| `storage_info.txt` | Проверить хранилище |
| `sms_logs.txt` | Выгрузить SMS (Инструменты безопасности) |
| `call_logs.txt` | Выгрузить журнал вызовов (Инструменты безопасности) |
| `connection_log.txt` | Автоматически создаваемый журнал сессий подключения |

---

## 📋 Сводка зависимостей

| Зависимость | Обязательна | Назначение | Установка (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 | ⚪ Опционально | Функция зеркалирования экрана | `sudo apt install scrcpy` | ❌ Termux mein kaam nahi |
| nmap | ⚪ Опционально | Сканирование сети в Инструментах безопасности | `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 — Последний выпуск
- ✅ Добавлено **подменю «Продвинутые инструменты безопасности»** (Опция 22) — 10 функций:
  - Обнаружение root (несколько методов), аудит разрешений APK, полный аудит безопасности
  - Сканер отлаживаемых приложений, интерактивная оболочка, проверка сетевой безопасности
  - Выгрузка SMS/журнала вызовов, фильтр логов безопасности, сканер уязвимостей, монитор сети
- ✅ **История подключений устройств** с временными метками и длительностью сессии (Опция 23)
- ✅ **Поддержка нескольких устройств** — список и выбор при обнаружении нескольких устройств
- ✅ **Выборочное беспроводное отключение** — выбор конкретного устройства или отключение всех
- ✅ **Диагностика ADB** — kill/restart ADB server для исправления зависших подключений (Опция 21)
- ✅ **Улучшенная выгрузка контактов** — чистый формат `Name: Number`
- ✅ **Более чистый список APK** — отображаются только имена пакетов, без лишних путей
- ✅ **Читаемый размер хранилища** — `df -h` для удобного чтения
- ✅ **Автоматическое логирование подключений** — журнал сессии записывается при запуске и выходе

### v1.2 — `pegasusV-1.2.py`
- ✅ Расширено до полного главного меню из 20 опций
- ✅ Удалённое выключение и перезагрузка устройства
- ✅ Установка (sideload) и удаление APK
- ✅ Отправка и получение файлов (двусторонняя передача)
- ✅ Отправка 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.