Documentation Index
Fetch the complete documentation index at: https://mintlify.com/lzhoang2801/OpCore-Simplify/llms.txt
Use this file to discover all available pages before exploring further.
OpCore Simplify is distributed as a plain ZIP archive — no installer, no package manager. You download it, extract it, and run the platform-specific launcher. The sections below walk through every step for Windows, macOS, and Linux.
Prerequisites
| Platform | Requirement |
|---|
| Windows | None — OpCore-Simplify.bat detects whether Python 3 is installed and downloads it silently from python.org if it is missing |
| macOS | Python 3 (the bundled .command launcher will prompt you to install it if absent) |
| Linux | Python 3 must be installed via your distribution’s package manager before running the script |
Extract OpCore Simplify to a folder whose full path contains no special characters (spaces, parentheses, accented letters, etc.). Paths with special characters can cause the tool to fail when it tries to locate its own scripts or write output files.
Download
Download the latest version as a ZIP archive using either method:
- Open the repository on GitHub, click Code, then click Download ZIP.
- Or download directly with this link:
https://github.com/lzhoang2801/OpCore-Simplify/archive/refs/heads/main.zip
C:\Tools\OpCore-Simplify on Windows or ~/Tools/OpCore-Simplify on macOS/Linux). The extracted folder will be named OpCore-Simplify-main.
Launch
Inside the extracted folder, double-click OpCore-Simplify.bat.On first run the launcher checks whether Python 3 is present on your system or in your PATH. If it is not found, it will ask:Python 3 was not found on the system or in the PATH var.
Would you like to install it now? [y/n]:
y to let the script download and install the latest Python 3 release from python.org automatically. Installation happens silently with PrependPath=1 set so that Python is immediately available to all future sessions. Once installation completes, the script re-checks and launches OpCore Simplify.If you prefer to install Python yourself, download it from python.org and make sure to check “Add Python X.X to PATH” during setup, then double-click the .bat file again.You can also launch from a Command Prompt or PowerShell terminal for easier log scrolling:cd C:\Tools\OpCore-Simplify-main
OpCore-Simplify.bat
Inside the extracted folder, double-click OpCore-Simplify.command.macOS may block the script the first time because it was downloaded from the internet. If you see a security warning, open System Settings → Privacy & Security, scroll down to the blocked-app notice, and click Open Anyway.Alternatively, launch it from Terminal to avoid the Gatekeeper prompt entirely:cd ~/Tools/OpCore-Simplify-main
bash OpCore-Simplify.command
Could not locate Python 2 or 3!
This script requires Python 3 to run.
Would you like to install the latest Python 3 now? (y/n):
y to download and install the latest Python 3 release from python.org. The script also runs the Install Certificates step automatically so that Python can make HTTPS requests without certificate errors.On macOS 10.15 Catalina and later, /usr/bin/python3 is a stub that requires Xcode Command Line Tools. The launcher accounts for this and prefers a full Python 3 installation from python.org.
Python 3 must be installed before running OpCore Simplify. Install it via your package manager if it is not already present:# Debian / Ubuntu
sudo apt install python3
# Fedora
sudo dnf install python3
# Arch Linux
sudo pacman -S python
cd ~/Tools/OpCore-Simplify-main
python3 OpCore-Simplify.py
The Windows-only export option (E. Export hardware report) is not available on Linux. Run Hardware Sniffer on a Windows machine to produce Report.json and the ACPI dump, then transfer the SysReport/ folder to your Linux machine and load the report from within the tool. Automatic Self-Update on Launch
Every time OpCore Simplify starts it runs an update check before displaying the main menu. The updater.py module compares the SHA of the local copy (stored in sha_version.txt) against the latest commit SHA fetched from the GitHub API:
Checking current version...
Fetching latest version from GitHub...
Current script SHA version: <local-sha>
Latest script SHA version: <remote-sha>
Do you want to skip the update process? (yes/No):
- Enter
yes to skip the update and continue running the current version.
- Enter
no to force an update attempt anyway — the updater will proceed using a placeholder version tag (update_forced_by_user) so all files are refreshed, which is useful if you suspect your local copy is corrupted.
Once an update completes successfully, OpCore Simplify restarts the Python process automatically using os.execv so you start fresh on the new code.
On first launch — before any SHA has been recorded — sha_version.txt will be absent and the tool will treat this the same as an available update, downloading the latest files and writing the initial SHA record. This is expected behaviour and only takes a few seconds on a normal connection.
