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. ✅ **Install をクリックする前に「Add Python to PATH」にチェックを入れる**

コマンドプロンプトまたは PowerShell で確認する:```cmd
python --version

> ADB は自動的に PATH に追加されます — 手動での設定は不要です。

確認:```cmd
adb version

検証:```powershell
scrcpy --version

検証:```powershell
git --version

> ✅ これにより、Python、ADB、scrcpy、Git が一度にインストールされます。この後、PowerShell を再起動してください。

---

**ステップ 6 — リポジトリをクローンする**

**コマンドプロンプト** または **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（Android スマートフォンから直接実行）

> **Termux とは？** Termux は、スマートフォン上に完全な Linux 環境を提供する Android ターミナルエミュレータです — root は不要です。Termux を使用して、Android デバイスから直接 Pegasus を実行できます。

> ⚠️ **注意:** `scrcpy`（画面ミラー — オプション 5）は Termux では**動作しません**。Android では利用できないディスプレイサーバーが必要なためです。その他のすべての機能は通常どおり動作します。

#### Termux のインストール

1. **F-Droid から Termux をインストール** *(推奨)*  
   👉 https://f-droid.org/packages/com.termux/  
   > ⚠️ Google Play ストア版の Termux は古いため、常に 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. TCP/IPモードを有効にするか尋ねられたら `y` を入力
4. デバイスのIPを確認: **設定 → Wi-Fi → 接続中のネットワークをタップ → IPアドレス**
5. プロンプトが表示されたらPegasusにIPを入力
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` で全てのPython依存関係が一度にインストールされます。

---

## 📁 ファイルリファレンス

| ファイル | バージョン | 実行コマンド |
|------|---------|-------------|
| `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トラブルシュート** — スタックした接続を修正するためにADBサーバーを強制終了/再起動（オプション21）
- ✅ **連絡先ダンプの改善** — クリーンな `Name: Number` 形式のパース
- ✅ **よりクリーンなAPKリスト** — パッケージ名のみを表示し、生のパスクラッターを排除
- ✅ **人間が読みやすいストレージ** — 読みやすくするための `df -h`
- ✅ **自動接続ログ** — 開始時と終了時にセッションログを書き込み

### v1.2 — `pegasusV-1.2.py`
- ✅ 完全な20オプションのメインメニューに拡張
- ✅ デバイスのリモート電源オフと再起動
- ✅ APKインストール（サイドロード）とアンインストール
- ✅ ファイルのプッシュとプル（双方向転送）
- ✅ Androidインテント経由でSMSを送信
- ✅ デバイスの連絡先をダンプ
- ✅ Logcatデバイスログダンプ
- ✅ デバイス上のWi-Fi状態を切り替え
- ✅ ストレージ情報の確認
- ✅ リモートカメラトリガーと写真のプル
- ✅ 連絡先パース用に `re` モジュールを追加

### v1.1 — `pegasus_v1.1.py`
- ✅ デバイス情報の確認（モデル、Androidバージョン、バッテリー）
- ✅ USBとWi-FiのADB接続と切断
- ✅ カスタム期間での画面録画
- ✅ scrcpyによるライブ画面ミラーリング
- ✅ インストール済みパッケージの一覧表示とファイルへの保存
- ✅ スクリーンショットの撮影とプル

### v1.0
- ✅ 初回リリース — 基本的なADBラッパー
- ✅ インタラクティブな端末メニューUI
- ✅ 起動時の依存関係チェッカー
- ✅ 色分けされた端末出力

---

## 📜 ライセンス

このプロジェクトは **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.