https://github.com/kpostekk/opencore-composer
[WIP] Easy and powerful OC customization tool inspired by Docker (by docker-compose mostly)
https://github.com/kpostekk/opencore-composer
hackintosh opencore opencore-config opencore-configuration opencore-efi opencorepkg uefi-boot
Last synced: about 2 months ago
JSON representation
[WIP] Easy and powerful OC customization tool inspired by Docker (by docker-compose mostly)
- Host: GitHub
- URL: https://github.com/kpostekk/opencore-composer
- Owner: kpostekk
- License: apache-2.0
- Created: 2021-05-13T13:26:26.000Z (about 5 years ago)
- Default Branch: main
- Last Pushed: 2021-05-17T09:06:37.000Z (about 5 years ago)
- Last Synced: 2025-01-18T04:07:38.751Z (over 1 year ago)
- Topics: hackintosh, opencore, opencore-config, opencore-configuration, opencore-efi, opencorepkg, uefi-boot
- Language: TypeScript
- Homepage:
- Size: 2.06 MB
- Stars: 4
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 
Easy and powerful OC customization tool inspired by Docker (by docker-compose mostly)
## Installation
```shell
git clone https://github.com/kpostekk/opencore-composer.git
cd opencore-composer
npm i
npx tsc
(sudo) npm link # on windows run as admin
```
### Requirements
- NodeJS v15 or newer
- Git
- Brain
### Run
```shell
oc-composer --init # initialize env
oc-composer
```
## Why?
In general, yeah, OpenCore has clean and easy to read config file. It's somehow easy to edit using ProperTree (awesome job CorpNewt),
but manual configuration has some downsides. Easy to make mistakes, no instant validation.
Also migrating config.plist can be a p̴̦̋a̷̳͊i̵̤̍n̶̦̾.
I have observed that my `config.plist`s are just variations of `Sample.plist`. Few changes here and there, experiment with
`PciRoot(0x0)/Pci(0x2,0x0)` and boom, it's ready to rock.
Updates were repetitive too. Find new keys, remove old keys, validate.
So I have created a tool for painless updating OC. And yeah, that's all.
### How it works
```
Get Sample.plist --> Import patches from oc-compose.yml
|
V
Export config.plist <-- Compile patches --> Copy OpenCore base files --> Copy .aml files and kexts
|
V
Issue validation by ocvalidate
```
### Future?
- Add option to download kexts and SSDTs from repo
- Add `import` statement to download someone composition and edit it