openremap 0.4.0

ECU binary analysis and patching toolkit — diff, validate, and apply tuning recipes to automotive ECU binaries.

OpenRemap

Runs on your machine. No internet. No account. No data leaves your hands — ever.

Drop a .bin, know exactly what it is. Triage a folder of hundreds. Apply a tune you can read in any text editor.

---

What it does

• Identify — manufacturer, ECU family, software version, hardware number, and a confidence verdict. Under a second.
• Scan & organise — point at a folder of mixed binaries and sort them into Bosch/EDC17/, Bosch/ME7/, etc. in one click. Every file classified and confidence-tagged.
• Cook — diff a stock and modified binary into a portable JSON recipe. Every changed byte, readable in Notepad.
• Tune — validate, patch, and verify in one shot. Full audit trail baked in.
• Confidence scoring — HIGH, MEDIUM, LOW, SUSPICIOUS, or UNKNOWN — based on signals read straight from the binary. Modified files are flagged before you touch anything.

17 Bosch ECU families supported — from 8 KB LH-Jetronic ROMs (1982) to 8 MB EDC17 flash dumps. → Full family reference

→ How it all works in detail

---

Install

• 🪟 Windows — Step-by-step guide · written for people who rarely use a terminal
• 🍎 macOS / 🐧 Linux — One-command install
• 🛠️ Contributing / development — Clone and run from source

---

Get started

openremap

That's it. The full terminal UI launches — identify files, scan folders, cook recipes, and apply tunes, all from one interface. No flags to memorise.

The complete CLI is still there when you need it:

openremap workflow    # Prints a plain-English guide with every step and command
openremap commands    # Quick reference for all available commands

→ Full CLI reference

---

Documentation

• CLI commands overview
• Confidence scoring — tiers, signals, and breakdown
• Supported Bosch ECU families
• Recipe JSON format
• Contributing — adding extractors, code style, PRs

---

Contributing

Contributions are welcome — especially new ECU family extractors. See CONTRIBUTING.md.

License

MIT — see LICENSE.

---

⚠️ Checksum verification is mandatory. Before flashing any tuned binary to a vehicle, you must run it through a dedicated checksum correction tool (ECM Titanium, WinOLS, or equivalent). openremap tune confirms the recipe was applied correctly — it does not correct or validate ECU checksums. Flashing a binary with an incorrect checksum will brick your ECU.

⚠️ Research and educational use only. Any output produced by this software must be reviewed by a qualified professional before being flashed to a vehicle. The authors accept no liability for damage, loss, or legal consequences arising from its use. Read the full DISCLAIMER.