Mstar-bin-tool

You need Python 3.6+ and pip.

pip install -r requirements.txt

Alternatively, manually install:

MStar binaries generally do not follow standard partitioning tables (like GPT or MBR) at the start of the file. Instead, they utilize a custom header structure (often located at specific offsets) that describes the partitions.

Key structural elements include:

While powerful, mstar-bin-tool carries significant risks if misused. mstar-bin-tool

# Clone the repository
git clone https://github.com/luckyzhu/mstar-bin-tool.git
cd mstar-bin-tool
Some MStar images are AES encrypted (common in newer Hisense, TCL, Philips TVs).
The tool supports decryption if you have the key.
Decrypt first:
python mstar_bin_tool.py -f encrypted.bin --decrypt --key 16bytekey.bin -o decrypted.bin

Then unpack the decrypted firmware.

Without the correct key, encrypted firmware cannot be unpacked.


Avoid the "Download ZIP" method; use Git to ensure you get the submodules (if any).
git clone https://github.com/lionsharp/mstar-bin-tool.git
cd mstar-bin-tool

Step 1 – Unpack
python mstar_bin_tool.py -f update.bin -c my_tv.ini -u

Step 2 – Identify logo partition
Check config: logo is at offset 0x2481000 as raw data. You need Python 3
Step 3 – Replace logo
Your new logo must be in the exact format (BMP, RAW, or MStar proprietary).

Convert your image to the correct size/format using ffmpeg or GIMP.
dd if=new_logo.bin of=logo_partition.bin

Replace logo_partition.bin inside the unpacked folder.
Step 4 – Repack
python mstar_bin_tool.py -f new_firmware.bin -c my_tv.ini -p

Step 5 – Flash using USB or serial method. Then unpack the decrypted firmware