Mac EFI Toolkit

Table of Contents

1. Intoduction
2. System Requirements
3. Getting Started
4. Application Manual
5. Wine Instructions
6. Support
7. Changelog
8. Features
9. Acknowledgements
10. Donate

Introduction

Mac EFI Toolkit (also known as mefit) is designed to aid technicians in repair and analysis of Mac EFI and Intel based Mac SOCROM firmwares. Designed to be compact, this application provides information gathering capabilities and limited patching functionality.

System Requirements

• Operating System:

  • Windows 11 (64-bit)
  • Windows 10 (32/64-bit)
  • mefit is compatible with Wine

• Internet Connectivity (optional, only required for specific features):

  • Receiving notifications about new versions (can be disabled in settings).
  • Fetching device configuration data from Apple’s server if not available in the internal database.
  • Checking serial numbers on EveryMac.

• Build Requirements:

  • Visual Studio 2022, targeting .NET Framework 4.8.

Getting Started

1. Ensure your system has .NET Framework 4.8 installed.
2. Download the latest version of mefit.
3. If needed, create a dump of your Mac firmware using an SPIROM programmer.
4. Launch the software (no installation required) and open your firmware.

Application Manual

📋 View the application manual here.

Wine Instructions

To run Mac EFI Toolkit on Linux or macOS using Wine, follow these steps:

1. Install Wine to your Operating System.
2. Open the terminal and run the command winecfg. This will open the Wine configuration window. Then, navigate to the 'Graphics' tab and change the 'Screen resolution' to 120 dpi.
3. Download all four required fonts from here. After downloading, navigate to Home\.wine\drive_c\windows\Fonts and copy the downloaded fonts into this folder.

Once these steps are completed, you should be able to run Mac EFI Toolkit under Wine.

Support

If you encounter any issues or need assistance, here are a few ways you can get help:

1. GitHub Issues

If you're experiencing a bug or issue, please check the open issues on GitHub. If your problem has not been reported, feel free to create a new issue. Be sure to include as much detail as possible, including:

• Application build (Can be found in the about window).
• A clear description of the problem.
• Steps to reproduce the issue.
• Screenshots or logs (if applicable).
• Firmware files (if applicable).

2. Email Me

For more direct support, you can contact me via email.

Changelog

📋 View the full changelog here.

Features

• Application

  • File Handling
    • All files are edited in memory preserving the original
    • Backup firmwares to a .zip archive for long-term storage
    • Drag and drop support
  • Error Handling and Logging
    • Automatic handling of uncaught exceptions
    • Automatic background logging for errors and key actions
  • User Interface
    • Automatic DPI scaling
    • New version notifications
    • Serial numbers are censored by default
  • Search and Verification
    • Knuth–Morris–Pratt algorithm for binary data searching
    • Serial number validation rules
    • Check serial numbers on EveryMac
    • View firmware parse time
  • Misc
    • No installation required
    • Works with Wine

• Firmware (EFIROM)

  • View firmware details
    • Binary size (bytes, hex)
    • Checksum
    • Created and modified date
    • EFI version
    • EFI lock status
    • Platform Data Region Board-ID
    • APFS driver status
    • Intel ME version
    • Model information
      • System model
      • System config code
      • System serial number
      • Hardware config code
      • System order number
  • Automatic Fsys checksum masking
  • Edit the system serial number
  • Export and replace the Fsys region
  • Export and replace the Intel Management Engine region
  • Export firmware information to a text file
  • Detect invalid binary size
  • Detect and repair invalid Fsys checksums
  • View Apple ROM section information
  • Reset NVRAM stores with proper header configuration
  • Detect and remove EFI passwords (EFI lock)
  • Detect and export decompressed LZMA DXE archives
  • Detect and export the Find My Mac email address

• Firmware (T2 SOCROM)

  • View firmware details
    • Binary size (bytes, hex)
    • Checksum
    • Created and modified date
    • iBoot version
    • Model Information
      • Scfg store details
      • System serial number
      • System config code
      • System order number
  • Edit the serial number
  • Export and replace the Scfg store
  • Export firmware information to a text file

Acknowledgements

This software uses the following third-party libraries and resources:

• LZMA v24.08 SDK, by Igor Pavlov.
• Knuth-Morris-Pratt algorithm, by Donald Knuth, James H. Morris, and Vaughan Pratt.
• MacModelShelf database by MagerValp.
• Application icon by ADI_ICONS on FlatIcon.

Donate

All donations go back into improving my software and workspace: