4.4 KiB
Build and run from source
OpenCore Legacy Patcher at its core is a python-based TUI/CLI based application. This means that to run the project from source, you simply need to invoke the OpenCore-Patcher.command file via Python.
For developers wishing to validate mainline changes, you may use these nightly links:
Warning: These binaries should not be used without first consulting the CHANGELOG. Do not distribute these links in forums, instead direct to this file.
- Users running new builds of the project without understanding what has changed are at higher of bricking their installation as they do not read any warnings provided in the CHANGELOG. We wish to minimize these situations as much as possible.
Getting Started
To start, ensure you have python 3.6 or newer installed. Additionally ensure that they were downloaded from the offical source, python.org.
- Python installations either preinstalled or provided with Xcode/Xcode Tools are unsupported due to reliablility issues
Once Python is installed, open Terminal and run the following:
# Move into a directory to store the project
cd ~/Developer
# Move into Project directory
cd ./OpenCore-Legacy-Patcher
# Clone project
git clone https://github.com/dortania/OpenCore-Legacy-Patcher
# Install Python dependacies used by the project
pip3 install -r requirements.txt
Running OpenCore Legacy Patcher
To run the project from source, simply invoke via python3:
python3 OpenCore-Patcher.command
Note that the OpenCore-Patcher.command file can be run as both a TUI and a CLI utility for other programs to call. If no core arguments are passed, the TUI is initialized. Otherwise the CLI will start:
python3 OpenCore-Patcher.command --build --model iMac12,2 --verbose
See -h/--help for more information on supported CLI arguments.
Generating prebuilt binaries
The main goal of generating prebuilt binaries is to strip the requirement of a local python installation for users. For developers, there's very little benefit besides for usage with the project's GUI (Generating the GUI). For development, simply use the OpenCore-Patcher.command file with a python3 installation.
- Note that due to PyInstaller's linking mechanism, binaries generated on Catalina and newer are not compatible with High Sierra and older
- To ensure the largest compatibility, generate binaries on macOS Mojave. These binaries will be compatible with macOS 10.9 to macOS 12.
- Currently our build system is a Macmini8,1 provided by MacStadium running macOS Mojave (10.14.6).
# Install PyInstaller
pip3 install pyinstaller
# Move into project directory
cd ~/Developer/OpenCore-Legacy-Patcher/
# Create the pyinstaller based Application
pyinstaller OpenCore-Patcher.spec
# Post PyInstaller clean up
./after_pyinstaller.sh
# Open build folder
open ./dist/
Once done, you'll find the application generated at ./dist/OpenCore-Patcher.app:
Generating the GUI
To generate a GUI, you will have need a core OpenCore-Patcher binary generated during the above stage(Generating prebuilt binaries).
Once conditions are met, you'll be able to work with the GUI portion. The source of which is found at dortania/OCLP-GUI.
# Move into a directory to store the project
cd ~/Developer
# Clone project
git clone https://github.com/dortania/OCLP-GUI
# Update the OpenCore-Patcher binary from the core project
cp ./OpenCore-Legacy-Patcher/dist/OpenCore-Patcher ./OCLP-GUI/OpenCore\ Patcher/OpenCore\ Patcher/
# Rename binary to OCLP-CLI
mv ./OCLP-GUI/OpenCore\ Patcher/OpenCore\ Patcher/OCLP-GUI/OpenCore-Patcher ./OCLP-GUI/OpenCore\ Patcher/OpenCore\ Patcher/OCLP-GUI/OCLP-CLI
# Build project
cd ./OCLP-GUI/OpenCore\ Patcher; xcodebuild; cd ../../
# Move application to project root
open ./OCLP-GUI/OpenCore\ Patcher/build/Release/OpenCore\ Patcher.app