How theubusu/unixtract works
unixtract is a Rust command-line extractor for firmware packages; it does not repack them. The documented workflow is to provide an input and optional output directory/options, identify a supported format, then extract its contents. The registry links format detectors and extractors; format handlers may decrypt, decompress, parse nested structures, and write extracted files. The README documents a much broader format catalog than the sampled implementations. The graph groups that catalog where individual runtime wiring was not shown; omitted connections reflect evidence limits, not absent capabilities.
Main entry points: formats.rs Format registry · mstar/mod.rs MStar upgrade · msd10/mod.rs MSD 1.0 · mtk_pkg/mod.rs MediaTek PKG
Components 25
CLI and dispatch
- CLI workflow
src/main.rs - Format registry
src/formats.rs
Firmware formats
- Format extractors
src/formats - LG EPK
src/formats/epk/mod.rs - MSD 1.0
src/formats/msd10/mod.rs - MSD 1.1
src/formats/msd11/mod.rs - MStar upgrade
src/formats/mstar/mod.rs - MediaTek PKG
src/formats/mtk_pkg/mod.rs - MediaTek PKG new
src/formats/mtk_pkg_new/mod.rs - MediaTek PKG old
src/formats/mtk_pkg_old/mod.rs - Android OTA payload
src/formats/android_ota_payload/android_ota_update_metadata.rs - Panasonic DVD
src/formats/pana_dvd/mod.rs - SDDL secure
src/formats/sddl_sec/mod.rs
Shared processing
- MTK LZHS
src/formats/mtk_pkg/lzhs.rs - MTK Huffman tables
src/formats/mtk_pkg/huffman_tables.rs - AES helpers
src/utils/aes.rs - Compression helpers
src/utils/compression.rs - Sparse writer
src/utils/sparse.rs - Binary I/O helpers
src/utils/common.rs - LZOP helper
src/utils/lzop.rs - Global options
src/utils/global.rs
Keys and MSD parsing
- OUITH parsers
src/formats/msd/msd_ouith_parser_old.rs - UKF key collections
src/ukf.rs
Other components
- User
- Output files
Connections 38
- User → CLI workflow: provides input
README.md - CLI workflow → Format registry: uses registry
src/main.rs - Format registry → Format extractors: registers formats
src/formats.rs - Format registry → LG EPK: registers handler
src/formats.rs - Format registry → MSD 1.0: registers handler
src/formats.rs - Format registry → MSD 1.1: registers handler
src/formats.rs - Format registry → MStar upgrade: registers handler
src/formats.rs - Format registry → MediaTek PKG: registers handler
src/formats.rs - Format registry → MediaTek PKG new: registers handler
src/formats.rs - Format registry → MediaTek PKG old: registers handler
src/formats.rs - Format registry → Android OTA payload: registers handler
- Format registry → Panasonic DVD: registers handler
src/formats.rs - Format registry → SDDL secure: registers handler
src/formats.rs - LG EPK → AES helpers: decrypts with
src/formats/epk/mod.rs - LG EPK → Global options: dumps headers
- MSD 1.0 → OUITH parsers: parses OUITH
src/formats/msd10/mod.rs - MSD 1.0 → UKF key collections: reads keys
- MSD 1.1 → OUITH parsers: parses OUITH
- MSD 1.0 → Output files: writes extracted files
src/formats/msd10/mod.rs - MStar upgrade → Compression helpers: decompresses data
src/formats/mstar/mod.rs - MStar upgrade → LZOP helper: decompresses data
src/formats/mstar/mod.rs - MStar upgrade → Sparse writer: unsparses data
src/formats/mstar/mod.rs - MStar upgrade → Output files: writes partitions
src/formats/mstar/mod.rs - MediaTek PKG → MTK LZHS: uses decoder
src/formats/mtk_pkg/mod.rs - MediaTek PKG → MTK Huffman tables: uses tables
src/formats/mtk_pkg/mod.rs - MediaTek PKG → AES helpers: decrypts with
src/formats/mtk_pkg/mod.rs - MediaTek PKG → Output files: writes partitions
src/formats/mtk_pkg/mod.rs - MediaTek PKG new → MTK LZHS: uses decoder
src/formats/mtk_pkg_new/mod.rs - MediaTek PKG old → MTK LZHS: uses decoder
src/formats/mtk_pkg_old/mod.rs - Panasonic DVD → AES helpers: decrypts with
src/formats/pana_dvd/mod.rs - Panasonic DVD → Output files: writes extracted files
- SDDL secure → AES helpers: decrypts with
src/formats/sddl_sec/mod.rs - SDDL secure → Output files: writes modules
src/formats/sddl_sec/mod.rs - Android OTA payload → Compression helpers: decompresses data
src/formats/android_ota_payload/mod.rs - MStar upgrade → Binary I/O helpers: reads input
src/formats/mstar/mod.rs - MSD 1.0 → Binary I/O helpers: reads input
src/formats/msd10/mod.rs - SDDL secure → Binary I/O helpers: reads input
src/formats/sddl_sec/mod.rs - CLI workflow → UKF key collections: loads key file
src/main.rs