mirror of
https://github.com/Ap0dexMe0/unixtract.git
synced 2026-07-15 21:00:03 +02:00
Update readme
This commit is contained in:
theubusu
@@ -1,8 +1,11 @@
|
||||
# unixtract
|
||||
Extractor for various file formats.
|
||||
This is a tool that is able to extract the contents of various firmware package formats.
|
||||
Built in Rust, and made to not depend on any external dependancies, only Rust crates. This way it can work on Windows, Linux and MacOS without any issue.
|
||||
Please note that this project is still mostly under development and errors may occur. Feel free to make an issue in that case.
|
||||
This is a tool that is able to extract the contents of various firmware package formats, mostly from TVs and AV devices.
|
||||
Built in Rust, and made to not depend on any external dependancies, only Rust crates. This way it can work on Windows, Linux and MacOS and even Android without any issue.
|
||||
Please note that this project is still under active development and errors may occur. Feel free to make an issue in that case, or if you have any feature request.
|
||||
|
||||
# Installation
|
||||
Build from source, by downloading the code or cloning the respository and running `cargo build --release`. The binary will be saved in `target/release`.
|
||||
|
||||
# Usage
|
||||
`unixtract <INPUT_TARGET> [OUTPUT_FOLDER]`
|
||||
@@ -10,4 +13,118 @@ Please note that this project is still mostly under development and errors may o
|
||||
`[OUTPUT_FOLDER]` - Folder to save extracted files to.
|
||||
If an output folder is not provided, extracted files will be saved in folder `_<INPUT_TARGET>`.
|
||||
|
||||
# Supported formats
|
||||
# Supported formats
|
||||
## Android OTA payload.bin
|
||||
**Used in:** Android devices, smartphones, TVs
|
||||
**Notes:** Some compression methods may not be supported.
|
||||
**Thanks to:** https://android.googlesource.com/platform/system/update_engine/+/HEAD/update_metadata.proto
|
||||
|
||||
## BDL
|
||||
**Used in:** Enterprise HP Printers
|
||||
**Notes:** None, all files should be supported
|
||||
|
||||
## EPK v1
|
||||
**Used in:** LG TVs before ~2010
|
||||
**Notes:** None, all files should be supported
|
||||
**Thanks to:** https://github.com/openlgtv/epk2extract
|
||||
|
||||
## EPK v2
|
||||
**Used in:** LG TVs since ~2010
|
||||
**Notes:** **Depends on keys** - see keys.rs
|
||||
**Thanks to:** https://github.com/openlgtv/epk2extract
|
||||
|
||||
## EPK v3
|
||||
**Used in:** LG webOS-based TVs
|
||||
**Notes:** **Depends on keys** - see keys.rs
|
||||
**Thanks to:** https://github.com/openlgtv/epk2extract
|
||||
|
||||
## Funai UPG
|
||||
**Used in:** Some Funai TVs
|
||||
**Notes:** Decryption is not yet supported.
|
||||
|
||||
## INVINCIBLE_IMAGE
|
||||
**Used in:** LG Broadcom-based Blu-Ray players
|
||||
**Notes:** Only version 3 is supported (2011+)
|
||||
|
||||
## MSD 1.0
|
||||
**Used in:** Samsung TVs 2013-2015
|
||||
**Notes:** **Depends on keys** - see keys.rs
|
||||
**Thanks to:** https://github.com/bugficks/msddecrypt
|
||||
|
||||
## MSD 1.1
|
||||
**Used in:** Samsung TVs 2016+
|
||||
**Notes:** **Depends on keys** - see keys.rs
|
||||
**Thanks to:** https://github.com/bugficks/msddecrypt
|
||||
|
||||
## MStar upgrade bin
|
||||
**Used in:** Many MStar-based TVs (Hisense, Toshiba...)
|
||||
**Notes:** All files should be supported, includes lzop, lz4, lzma, sparse_write support
|
||||
|
||||
## MediaTek BDP
|
||||
**Used in:** Many MediaTek-based Blu-Ray players (LG, Samsung, Philips, Panasonic...)
|
||||
**Notes:** Some older files may fail to extract
|
||||
|
||||
## MediaTek PKG (New)
|
||||
**Used in:** Newer MediaTek-based TVs (TCL, Hisense, Sony, Philips, CVT...)
|
||||
**Notes:** **Depends on keys** - see keys.rs (Keys for Philips and Sony included)
|
||||
|
||||
## MediaTek PKG (Old)
|
||||
**Used in:** Older MediaTek-based TVs (Philips, Sony, Hisense...)
|
||||
**Notes:** All files should be supported, decryption + decompression
|
||||
|
||||
## MediaTek PKG
|
||||
**Used in:** MediaTek-based TVs (Sony, Philips, Panasonic, Sharp...)
|
||||
**Notes:** All files should be supported, decryption + decompression, however some Philips files use custom keys - most are included some could be missing
|
||||
**Thanks to:** https://github.com/openlgtv/epk2extract
|
||||
|
||||
## Novatek PKG (NFWB)
|
||||
**Used in:** Some older Novatek-based TVs (LG, Philips)
|
||||
**Notes:** None, all files should be supported.
|
||||
|
||||
## Novatek TIMG
|
||||
**Used in:** Newer Novatek-based TVs (Philips TitanOS, Hisense)
|
||||
**Notes:** There is an older type of this format that is not yet supported, but for newer type all files should work.
|
||||
|
||||
## Panasonic Blu-Ray (PANA_DVD.FRM, PANA_ESD.FRM, PANAEUSB.FRM)
|
||||
**Used in:** Panasonic Blu-Ray Players and Recorders
|
||||
**Notes:** **Depends on keys** - see keys.rs, and there is an issue with some ancient files not extracting correctly.
|
||||
|
||||
## Philips UPG (Autorun.upg, 2SWU3TXV)
|
||||
**Used in:** Philips pre-TPVision TVs 200?-2013
|
||||
**Notes:** **Depends on keys** - see keys.rs
|
||||
**Thanks to:** https://github.com/frederic/pflupg-tool
|
||||
|
||||
## PUP
|
||||
**Used in:** Sony PlayStation 4/5
|
||||
**Notes:** File has to be decrypted.
|
||||
**Thanks to:** https://github.com/Zer0xFF/ps4-pup-unpacker
|
||||
|
||||
## Roku
|
||||
**Used in:** Roku TV's/players
|
||||
**Notes:** The contents of the update file can be extracted, but some firmware images contained inside are additionally encrypted, and they cannot be decrypted as of now.
|
||||
|
||||
## RUF
|
||||
**Used in:** Samsung Broadcom-based Blu-Ray players
|
||||
**Notes:** **Depends on keys** - see keys.rs
|
||||
|
||||
## RVP/MVP
|
||||
**Used in:** Sharp Blu-Ray players/recorders
|
||||
**Notes:** Only the older types of files are supported (XOR-encrypted)
|
||||
|
||||
## Samsung (Folder with ***.img.sec)
|
||||
**Used in:** Samsung TVs pre 2013
|
||||
**Notes:** **Depends on keys** - see keys.rs
|
||||
**Thanks to:** https://github.com/george-hopkins/samygo-patcher
|
||||
|
||||
## SDDL.SEC
|
||||
**Used in:** Panasonic TVs
|
||||
**Notes:** Pre-2011 files are not supported.
|
||||
|
||||
## SLP
|
||||
**Used in:** Samsung Tizen-based NX series cameras
|
||||
**Notes:** None, all files should be supported.
|
||||
|
||||
## Sony BDP
|
||||
**Used in:** Sony Blu-Ray players
|
||||
**Notes:** Only platforms up to MSB18 are supported.
|
||||
**Thanks to:** http://malcolmstagg.com/bdp/s390-firmware.html
|
||||
-28
@@ -1,28 +0,0 @@
|
||||
| Format name | Used by | Notes | Thanks to |
|
||||
| ----------------------------- | --------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |
|
||||
| Android OTA payload.bin | Some Android MediaTek TVs | Some compression methods are not supported | https://android.googlesource.com/platform/system/update_engine/+/HEAD/update_metadata.proto |
|
||||
| BDL | HP Printers | All files should be supported. | - |
|
||||
| EPK v1 | LG TVs before ~2010 | All files should be supported. | https://github.com/openlgtv/epk2extract |
|
||||
| EPK v2 | LG TVs since ~2010 | **Depends on keys** - see keys.rs | https://github.com/openlgtv/epk2extract |
|
||||
| EPK v3 | LG webOS TVs | **Depends on keys** - see keys.rs | https://github.com/openlgtv/epk2extract |
|
||||
| Funai UPG | Some Funai TVs | Only supports unencrypted/unobfuscated files | - |
|
||||
| INVINCIBLE_IMAGE | LG Broadcom-based Blu-Ray players | Only version 3 is supported (2011+) | - |
|
||||
| MSD v1.0 | Samsung TVs 2013-2015 | **Depends on keys** - see keys.rs | https://github.com/bugficks/msddecrypt |
|
||||
| MSD v1.1 | Samsung TVs 2016+ | **Depends on keys** - see keys.rs | https://github.com/bugficks/msddecrypt |
|
||||
| Mstar upgrade bin | Many MStar-based TVs (Hisense, Toshiba..) | Most files should be supported | - |
|
||||
| Mediatek BDP | Many Mediatek-based Blu-Ray players (LG, Samsung, Philips, Panasonic...) | Some older files may not be supported | - |
|
||||
| Mediatek PKG (New) | Newer Mediatek-based TVs | **Depends on keys** - see keys.rs | - |
|
||||
| Mediatek PKG (Old) | Older Mediatek-based TVs | All files should be supported | - |
|
||||
| Mediatek PKG | Many Mediatek-based TVs (Hisense, Sony, Panasonic, Philips...) | Some firmwares **Depend on keys** - see keys.rs | https://github.com/openlgtv/epk2extract |
|
||||
| Novatek PKG (NFWB) | Some Novatek-based TVs (Philips, LG..) | All files should be supported | https://github.com/openlgtv/epk2extract |
|
||||
| Novatek TIMG | Later Novatek Based TVs (Philips TitanOS/Hisense) | All files should be supported | - |
|
||||
| Panasonic Blu-Ray (PANA_DVD) | Panasonic Blu-Ray Players/Recorders | **Depends on keys** - see keys.rs | - |
|
||||
| Philips UPG | Philips pre-TPVision TVS 2008-2013 | **Depends on keys** - see keys.rs | https://github.com/frederic/pflupg-tool |
|
||||
| PUP | Sony PlayStation 4/ PlayStation 5 | File has to be decrypted | https://github.com/Zer0xFF/ps4-pup-unpacker |
|
||||
| Roku | Roku TVs/players | Most files should work, but encrypted images contained within will not be decrypted. | - |
|
||||
| RUF | Samsung Broadcom-based Blu-Ray players | **Depends on keys** - see keys.rs | - |
|
||||
| RVP/MVP | Sharp Blu-Ray players/recorders | Only supports older files (XOR encrypted) | - |
|
||||
| Samsung | Old Samsung TV firmwares pre 2013 | **Depends on keys** - see keys.rs | https://github.com/george-hopkins/samygo-patcher |
|
||||
| SDDL.SEC | Panasonic TVs 2011+ | All files 2011+ are supported | https://github.com/theubusu/sddl_dec |
|
||||
| SLP | Samsung Tizen-based NX series cameras | All files should be supported | - |
|
||||
| Sony BDP | Sony Blu-Ray players | Only platforms up to MSB18 are supported | http://malcolmstagg.com/bdp/s390-firmware.html |
|
||||
Reference in New Issue
Block a user