Skip to content

Repository files navigation

LGU Manager

Analysis, extraction, and rebuild tool for .lgu firmware files of LG Gen5 head units (NXP i.MX6 / Windows CE, Aerith updater, LG EU20 format).

A single self-contained Windows executable, usable as a graphical application or as a command-line tool. No Python or external dependency required to run it.

Download lgu-manager.exe

Downloads the executable from the latest release.

Screenshots

Home screen — choose Decompile or Compile:

Home

Content view — files carved from a firmware dump:

Content

Features

  • Automatic format detection (raw device dump, native Aerith format), header, i.MX6 IVT, entropy.
  • Listing of embedded files (programs / DLLs) with name, type, architecture, offset, and size; filter and sort.
  • Entropy map (colored, also in the terminal), computed on load.
  • Full-file search in ASCII, UTF-16, or HEX.
  • Extraction of a single file, all files, or a raw byte range.
  • CRC-32 computation and verification.
  • Native .lgu rebuild (plaintext header + CRC-32).
  • Encrypted-header support: decrypt and re-sign (re-encrypt) the .lgu header (RC4), with per-version password profiles managed from the UI.
  • Nine interface languages with automatic detection and a manual selector.

Usage

Graphical interface

Run lgu-manager.exe (double-click, or launch with no arguments).

Command line

lgu-manager info        file.lgu
lgu-manager list        file.lgu [--filter NAME] [--sort name|type|machine|offset|size] [--json]
lgu-manager map         file.lgu [--width N] [--no-color]
lgu-manager search      file.lgu PATTERN [--mode ascii|utf16|hex] [--limit N]
lgu-manager crc         file.lgu --off 0x.. --len 0x.. [--expect N]
lgu-manager extract     file.lgu (--off 0x.. --len 0x.. | --index N | --name NAME) --out PATH
lgu-manager extract-all file.lgu --out DIR [--filter NAME]
lgu-manager build       --zone NAME=image ... --out file.lgu [--meta KEY=VAL]
lgu-manager selftest    file.lgu
lgu-manager header      file.lgu [--profile NAME]
lgu-manager decrypt-header file.lgu --out out.lgu [--profile NAME]
lgu-manager sign-header    file.lgu --out out.lgu [--profile NAME]
lgu-manager profiles

Global options: --lang {en,fr,es,de,it,ru,zh,ja,ko}, --no-color. Run lgu-manager --help for the full reference.

Examples:

lgu-manager list    firmware.lgu --sort size
lgu-manager extract firmware.lgu --name Lisa --out Lisa.exe
lgu-manager build   --zone USER=user.img --out output.lgu

Building from source

Requires Python 3.9+ (standard library only). To produce the executable:

pip install pyinstaller
pyinstaller --onefile --console --hide-console hide-early --name lgu-manager lgu_manager.py

The build output goes to dist/lgu-manager.exe.

Supported files

The tool targets .lgu images of the LG EU20 platform. Firmware integrity uses CRC-32 (zlib); there is no asymmetric signature, so a correctly built native image is accepted on magic, sizes, and CRC alone.

Notes and limitations

  • The rebuild feature is experimental. Validate on a bench (dual OS A/B + UBACKUP + a master dump) before flashing a real device.
  • selftest applies only to native-format .lgu files, not raw dumps.
  • Windows only.

About

GUI/CLI tool to inspect, extract from, and rebuild LG Gen5 .lgu firmware images.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages