
Android ログ、イベント、Protobuf パーサー

貢献したい方はこちらから連絡してください: https://abrignoni.github.io
ブログ記事はこちら: https://leapps.org/blog
ビルド済みリリースはPythonのインストールが不要です: ALEAPP GitHub Releases、 またはLEAPPファミリー全体についてはLEAPPs Releasesをご覧ください。
| プラットフォーム | ダウンロード |
|---|---|
| Windows (Intel/AMD) | ALEAPP-*-windows-x64-portable.zip |
| Windows (ARM) | ALEAPP-*-windows-arm64-portable.zip |
| macOS (Apple Silicon) | ALEAPP-*-macos-arm64.dmg |
| macOS (Intel) | ALEAPP-*-macos-x64.dmg |
| Linux (Intel/AMD) | ALEAPP-*-linux-x64.AppImage |
| Linux (ARM) | ALEAPP-*-linux-arm64.AppImage |
| Debian, Ubuntu (Intel/AMD, ARM) | ALEAPP-*-linux-x64.deb, ALEAPP-*-linux-arm64.deb |
| Fedora およびその他の RPM ベース Linux (Intel/AMD, ARM) | ALEAPP-*-linux-x64.rpm, ALEAPP-*-linux-arm64.rpm |
各ダウンロードには1つのプログラム aleapp が含まれています。各リリースの SHA256SUMS.txt でダウンロードを検証できます。
.deb と .rpm はAppImageと同じビルドを含み、aleapp をPATHに配置し、
メニューエントリも追加します。ダウンロードしたフォルダからパッケージマネージャーを使ってインストールしてください:
sudo apt install ./ALEAPP-<version>-linux-x64.deb
sudo dnf install ./ALEAPP-<version>-linux-x64.rpm
GUI: 通常の方法でALEAPPを起動します。Windowsではzip内のaleapp.exeをダブルクリックし、macOSではApplications内のALEAPPを、LinuxではAppImageを起動します。引数なしで起動すると、ウィンドウが開きます。
CLI: ターミナルでaleappに引数を渡すと、代わりにコマンドラインとして実行されます。出力フォルダはあらかじめ存在している必要があります。Windowsでは、zip内のaleapp.exeを使用してください。
aleapp.exe -t zip -i C:\path\to\extraction.zip -o C:\path\to\output\
Linux では、同じ引数を付けて AppImage を実行するか、.deb または .rpm をインストールした後は aleapp 自体を実行します。macOS ではアプリ内に含まれているため、ターミナルで単に aleapp と入力して実行できるようにするには、一度 PATH にリンクします:
sudo ln -s /Applications/ALEAPP.app/Contents/MacOS/aleapp /usr/local/bin/aleapp
Python 3.11 以上
Python 環境の依存関係は requirements.txt に記載されています。以下のコマンドでインストールしてください。py の部分がご自身の環境に合っていることを確認してください(例: py、python、python3 など)。
py -m pip install -r requirements.txt
または
pip3 install -r requirements.txt
リリースがビルドされる際の正確な mister_skinnylegs 依存関係チェーンを使用する場合は、代わりにこちらを使用してください。これは mister_skinnylegs の行を除いた requirements.txt をインストールし、その後依存関係なしで requirements-msl-lock.txt をインストールし、Brotli が 1.2.1 より古い場合は停止します。また、ccl リーダーのいずれかのデフォルトブランチがインストールできない日でも動作します:
python3 admin/scripts/install_requirements.py
Linux で実行するには、以下のように tkinter を別途インストールする必要があります:
sudo apt-get install python3-tk
packaging/build.py は、同じ仮想環境から、実行されているマシン向けに PyInstaller で aleapp をビルドします。まず固定されたビルドツールをインストールし、その後 admin/scripts/install_requirements.py を使って requirements.txt と requirements-msl-lock.txt をインストールします。
python packaging/build.py exe # dist/ALEAPP/, and dist/ALEAPP.app on macOS
python packaging/build.py smoke # run what it built, without opening a window
python packaging/build.py installer # Windows: Inno Setup installer; macOS: .dmg; Linux: AppImage
python packaging/build.py linux-packages # Linux: .deb and .rpm around dist/ALEAPP/ (dpkg-deb, rpmbuild)
exe --onefile は代わりに dist/aleapp(Windows では dist\aleapp.exe)を単一ファイルとして生成します。Windows インストーラーには Inno Setup が必要です。Linux では、smoke にディスプレイが必要であり、それを xvfb-run が提供します。残りの詳細は python packaging/build.py --help にあります。
$ python aleapp.py -t <zip | tar | fs | gz | raw> -i <path_to_extraction> -o <path_for_report_output>
raw はディスクイメージ(.img、.dd、.bin、または分割セットの番号付き .001 セグメントのいずれか)、あるいはアクイジションとその隣にあるセグメントやファイル(EnCase/EWF .E01、SMART .s01、EWF2 .Ex01、AFF .aff、AFM .afm、AFD フォルダ内の任意の .aff、AFF4 .aff4、Apple .dmg とその隣にある任意の .dmgpart ファイル、.sparseimage または .sparsebundle フォルダ、あるいは仮想マシンディスク .vhd、.vhdx、.vmdk、.qcow2)をその場で読み取ります。マウントも管理者権限も不要です。その NTFS、FAT32、FAT16、FAT12、exFAT、ext2/3/4、F2FS、HFS+、APFS、QNX6、QNX4、ETFS、EFS、SquashFS、JFFS2、UBI/UBIFS、YAFFS、QNX IFS ボリュームは直接検索され(U-Boot 環境や Belkin NVRM ストアは 1 つのファイルとして読み取られます)、アーティファクトが要求するファイルだけがイメージから読み出されます。論理証拠である EnCase .L01 や FTK Imager .ad1 は、それが保持するファイルとして読み取られます。GUI はそれらの拡張子に対して自動的に raw を選択し、フォルダボタンで選択されたスパースバンドルや AFD フォルダについても同様です。admin/docs/raw_image_input.md を参照してください。
暗号化されたイメージは、そのパスワード(--image_password_file または --image_password_env)で開くか、証明書に封緘されている場合はその証明書の RSA 秘密鍵(--image_private_key)で開きます。イメージ内の BitLocker ボリュームは、同じ方法で与えられたパスワードまたは回復パスワード、あるいはスタートアップキー(--bitlocker_key、繰り返し指定可能)で開き、macOS がソフトウェアで暗号化した APFS ボリュームはパスワードまたは個人回復キーで、LUKS コンテナはパスフレーズで、それぞれ同じ方法で与えて開きます。ターミナルでは不足しているものはすべて尋ねられ、GUI ではダイアログで尋ねられます。BitLocker、APFS、LUKS ボリュームで何も開けないものは報告され、検索されません。
Linux ソフトウェア RAID セット(md、またはディスクをまたぐ LVM2)のディスクイメージはまとめて読み取られます。それらすべてを -t raw とともに -i に与えるか、GUI のファイルダイアログでまとめて選択してください。メンバーを保持する 1 つのイメージが与えられた場合、他のメンバーはそのフォルダ内で、ファイル名ではなく各ファイルが自身について記録している内容に基づいて探されます。コマンドラインはセットを読み取る前に、見つけたものと除外したもの、およびその理由を一覧表示し(--no-find-members は与えられたイメージのみを読み取ります)、GUI は見つけたファイルを読み取る前に確認を求めます。レポートは読み取ったすべてのイメージを列挙し、自動的に見つけたものに印を付けます。md メンバーを保持する 1 つのイメージも、そのアレイとともに読み取られます。メタデータ 1.1 または 1.2 を持つ単独の RAID1 メンバーは、アレイを通じてそのファイルシステムを読み取るようになり、そのボリューム名の先頭にイメージまたはアレイの名前が付加されます。2 回与えられた 1 つのディスクは 1 回だけ読み取られます。RAID メタデータが見つからないイメージは従来どおりに読み取られます。qnxprobe 1.71 が DDF、IMSM、および単独で読み取られた md メンバーイメージをどう扱うかについては、admin/docs/raw_image_input.md を参照してください。
tar は xz 圧縮された tar(.tar.xz)も読み取り、GUI はその拡張子に対して tar を選択します。.tar.gz を含む圧縮 tar は、ファイルが読み取られる前にレポートフォルダへ一度展開されるため、実行には非圧縮 tar 用の空き容量がそこに必要です。コピーは実行終了時に削除され、実行ログにはそのステップにかかった時間が記録されます。
$ python aleappGUI.py
$ python aleapp.py --help
アーティファクトモジュールは scripts/artifacts/ に配置され、ALEAPP が実行されるたびに読み込まれます。
新しいモジュール: まずは How to Write an iLEAPP Module から始めてください。これは iLEAPP をリファレンスとして使用しており、ALEAPP のモジュールも同じ __artifacts_v2__ ブロックと @artifact_processor デコレータを使用します。ヘルパーはツール間で同一ではないため、インポートする前に ALEAPP の scripts/ilapfuncs.py に存在するか確認してください。
モジュールがファイルの検索、SQLite の読み取り、メディアのチェックイン、タイムスタンプの変換に呼び出すヘルパー関数については、Helper Functions for Artifact Modules で説明されています。
モジュールは 2 つの部分で構成されます。ファイルの先頭にある __artifacts_v2__ 辞書と、@artifact_processor でデコレートされたアーティファクトごとの 1 つの関数です。例:
__artifacts_v2__ = {
"get_cool_messages": {
"name": "Cool App Messages",
"description": "Messages from the Cool App database",
"author": "@username",
"creation_date": "2026-10-14",
"last_update_date": "2026-10-14",
"requirements": "none",
"category": "Cool App",
"notes": "",
"paths": ('*/CoolApp/cool.db*',),
"output_types": "standard",
"artifact_icon": "message",
}
}
from scripts.ilapfuncs import (
artifact_processor, convert_unix_ts_to_utc, get_file_path, get_sqlite_db_records)
@artifact_processor
def get_cool_messages(context):
source_path = get_file_path(context.get_files_found(), 'cool.db')
if not source_path:
return (), [], ''
query = 'SELECT sent_at, sender, body FROM messages'
data_list = []
for row in get_sqlite_db_records(source_path, query):
data_list.append((convert_unix_ts_to_utc(row[0]), row[1], row[2]))
data_headers = (('Sent', 'datetime'), 'Sender', 'Message')
return data_headers, data_list, source_path
各エントリのキー(上記の get_cool_messages)は、装飾された関数の名前と一致している必要があります。これがローダーとデコレーターが互いを見つける仕組みです。エントリには以下が含まれます: