thegame_1980/revkit

mirror of https://github.com/qtmleap/revkit.git synced 2026-10-05 01:11:50 +02:00

Files

T

tkgstrator 097711b971 feat(devcontainer): Theos統合とAppDelegateフック修正、関連ドキュメント更新

Theosビルド環境をappコンテナに統合し、サイドカーtheosコンテナやdocker関連設定を削除。
AppDelegateのフックを正しいクラス名/継承関係で実装し直し、ログ出力で動作確認。
起動時のシェル初期化・バックグラウンドログ収集を追加。
各種ドキュメント、タスク、パッケージ名も新構成に合わせて更新。

2026-04-07 09:37:44 +00:00

3.1 KiB

Raw Blame History

Project Overview

Netflix の通信プロトコル (MSL: Message Security Layer) と認証フロー (Cookie, ESN, Widevine DRM) を解析するプロジェクト。 Chrome, iOS, Android の各プラットフォームにおける Netflix アプリの内部動作を Frida フックやトラフィックキャプチャで調査し、MSL クライアントの Python 実装に知見を還元する。

解析対象プラットフォーム

プラットフォーム	手法	主要パッケージ
Chrome (macOS)	Frida で Widevine CDM (L3) の vtable をフック + Chrome 拡張で EME/Web Crypto/HTTP を監視	`packages/chrome-extension/`, `packages/frida/hook_chrome_cdm.js`
Android	Frida で Cronet HTTP スタック・MSL CBOR・ESN 生成をフック。Cookie + PRV ESN をキャプチャ	`packages/frida/hook_netflix_android.js`, `packages/frida/hook_cronet.js`, `packages/frida/hook_msl.js`
iOS	Frida で Netflix iOS アプリの FairPlay DRM・MSL 通信をフック	`packages/frida/hook_netflix_ios.js`
HTTP プロキシ	Proxyman で MSL トラフィックをキャプチャ・デコード (CLEAR スキームのみ)	`packages/proxyman/`

リポジトリ構成

src/netflix_msl/          # Python MSL クライアント実装
packages/
  chrome-extension/       # Chrome 拡張 (EME/Web Crypto/HTTP フック + 浮動パネル UI)
  frida/                  # Frida フックスクリプト (TypeScript → JS ビルド)
  proxyman/               # Proxyman スクリプト + アドオン
docs/
  instructions/           # プラットフォーム別の解析結果・リファレンス
  netflix/                # Netflix 固有の仕様書

開発環境

Python 3.12+ (uv で管理)
Frida 17.x + frida-tools
Node.js (Chrome 拡張ビルド用)

Tweak 開発 (Theos/Orion)

Theos ビルド環境は app コンテナに統合されている。

ビルド

make -C packages/tweak/<tweak名>

クリーン

make -C packages/tweak/<tweak名> clean

パッケージ (.deb 生成)

make -C packages/tweak/<tweak名> package

デバイスへのインストール

# 初回のみ: SSH 公開鍵をデバイスに登録 (パスワード: alpine)
ssh-copy-id -o PubkeyAuthentication=no root@<デバイスIP>

# 以降はパスワード不要
make -C packages/tweak/<tweak名> package install THEOS_DEVICE_IP=<デバイスIP>

Tweak 開発担当はコード変更後に必ずビルドが通ることを確認する
ビルド成功後、対象デバイスへのインストールまで行う
VS Code タスク (theos: build, theos: clean, theos: package) も利用可能

構成

Tweak ソース: packages/tweak/<tweak名>/
Dockerfile: .devcontainer/theos/Dockerfile
ターゲット: iOS 15.0–16.5 (arm64, rootless)
対応フレームワーク: Logos (.x), Orion (.x.swift)

コード規約

Python: uv run ruff format でフォーマット
不明な点を推測で説明しない。分からないなら分からないと言う
変更前に影響範囲を全て確認してから回答する

3.1 KiB Raw Blame History Unescape Escape