BBOT のスキャン結果を閲覧・分析するための自己完結型ターミナル UI です。
# Copy to server and run (auto-installs on first run)
./bbot-ui
# Or specify custom path
./bbot-ui /path/to/scans
初回実行時に .bbot_ui_venv/ が作成され、依存関係がインストールされます。以降の実行は即座に起動します。
./bbot-ui # Default: ~/.bbot/scans
./bbot-ui /path/to/scans # Browse all scans in directory
./bbot-ui ~/.bbot/scans/scan-name # View specific scan
./bbot-ui --help # Show all options
./bbot-ui --scan-interval 5 # Refresh scan view every 5 seconds
./bbot-ui --list-interval 10 # Refresh scan list every 10 seconds
利用可能なオプション:
--scan-interval SECONDS - スキャン詳細ビューの更新間隔（デフォルト: 2.0）--list-interval SECONDS - スキャン一覧ビューの更新間隔（デフォルト: 3.0）設定は自動的に ~/.bbot_ui_config.json に保存され、今後のセッションのデフォルトとして使用されます。
↑/↓ または j/k で移動、Enter で開く、r で手動更新、a でアーカイブ、d で削除Tab キーでアーカイブ済みスキャンを表示u でアーカイブ解除（復元）、d で完全削除Tab、q、Escape キーでスキャン一覧に戻る古いスキャンをZIPアーカイブに圧縮してディスク容量を節約します:
スキャンのアーカイブ:
a を押してアーカイブTab キーで表示）アーカイブの復元:
Tab キーでアーカイブ一覧を表示u を押してアーカイブを解除q を押してスキャン一覧に戻り、復元されたスキャンを確認安全機能:
スキャン/アーカイブの削除:
d を押すとスキャンフォルダを完全削除d を押すとアーカイブファイルを完全削除脆弱性とフィンディングにステータス、優先度、メモを注釈付けして、セキュリティワークフローを追跡します。
仕組み:
.bbot_ui_annotations.json に保存されますoutput.json を変更することはありません脆弱性/フィンディングへの注釈付け:
t を押して注釈ダイアログを開くクイックショートカット:
x を押すと選択した項目を False Positive にマークi を押すと選択した項目を Accepted Risk にマークステータスオプション:
優先度レベル（任意）:
機能:
ステータスフィルタリング:
r を押すと手動更新し、新しいイベント数とともに通知を表示1. Vulnerabilities - 深刻度順（CRITICAL→HIGH→MEDIUM→LOW→INFO→UNKNOWN）にソートされた VULNERABILITY イベント。ステータス、優先度、注釈付き（ライブ更新） 2. Findings - ステータス、優先度、注釈付きの FINDING イベント（ライブ更新） 3. Events - タイプフィルター、スコープ距離フィルター、複数語検索、JSON詳細付きのすべてのイベント（ライブ更新） 4. Tree - 2つの表示モード（ライブ更新）:
subdomains.txt が存在する場合のみ表示。通常は subdomain-enum プリセットから生成）
7. Configuration - シンタックスハイライト付き preset.ymlEvents タブは強力な複数語検索をサポートしています:
httpx in-scope）例:
httpx in-scope - in-scope タグが付いた httpx モジュールのイベントk11h HIGH - k11h.de 関連の HIGH 深刻度イベントnuclei VULNERABILITY - nuclei モジュールが発見した脆弱性subdomain-enum プリセット（または subdomains.txt を生成するスキャン）で BBOT を実行すると、スキャンビューアに Subdomains タブが自動的に表示され、発見されたサブドメインの階層ツリーが表示されます。
機能:
example.com の下の api.example.com）subdomains.txt が存在する場合のみ表示階層の例:
example.com
├─ api.example.com
├─ dev.example.com
└─ www.example.com
ナビゲーション: ↑/↓ または j/k | 注釈付け: t（Vulns/Findings のみ） | False Positive: x（Vulns/Findings のみ） | Accepted Risk: i（Vulns/Findings のみ） | アーカイブ表示: Tab（スキャン一覧から） | 検索: f | 更新: r | アーカイブ: a（スキャン一覧） | アーカイブ解除: u（アーカイブ一覧） | 削除: d | 分割サイズ調整: ←/→ | 戻る/終了: q または Escape
注意: 注釈ショートカット (t, x, i) は、Vulnerabilities タブまたは Findings タブを表示しているときのみフッターに表示されます。
bbot-ui は実行中のスキャンからの更新を自動的に検出し、リアルタイムで表示します:
UI は マルチメソッド検出チェーン を使用してスキャンステータスを正確に判定します:
SCAN イベント分析: output.json から最後の SCAN イベントの status フィールドを読み取ります
"FINISHED" → スキャン完了（finished_at と duration フィールドあり）"RUNNING" → 実際に実行中かどうかを検証（ステップ2へ）アクティブプロセス検出（RUNNING ステータスの場合）:
output.json を開いているかどうかを確認最終ステータス:
output.json から新しいイベントのみを効率的に読み取りライブ更新の動作をカスタマイズできます:
コマンドライン経由:
./bbot-ui --scan-interval 5 --list-interval 10
デフォルト:
使用例:
--scan-interval 1）--scan-interval 5）設定は ~/.bbot_ui_config.json に保存され、セッション間で維持されます。
セットアップが正しく完了しませんでしたか?
rm -rf ~/.bbot_ui_venv && ./bbot-ui
psutil がインストールされていないという警告は? psutil が不足しているという警告が表示された場合、venv が古いバージョンです。再インストールしてください:
rm -rf ~/.bbot_ui_venv && ./bbot-ui
output.json が見つからない場合?
スキャンディレクトリに output.json が含まれていることを確認してください（BBOT が自動生成します）
Python が見つからない場合?
# Ubuntu/Debian
sudo apt install python3 python3-venv
# macOS
brew install python3
注記: psutil は、いずれかのプロセスがスキャンファイルを開いているかを確認して、スキャンステータスを正確に検出するために使用されます。
UI は大規模なスキャンや多数のディレクトリ向けに最適化されています:
起動パフォーマンス:
表示制限:
ファイル読み取り:
自動更新:
initial_load_phase フラグにより起動中の更新競合を防止~/.bbot_ui_venv/ を削除してクリーンな再インストールを強制MIT