ProperTree Guide

ProperTree Guide

Learn to use ProperTree, the native plist editor for macOS, to manage your OpenCore config.plist, run OC Snapshot, and handle EFI folder operations.

Downloading ProperTree

Download the latest release from the GitHub repository:

ProperTree on GitHub

Extract the app to your Applications folder.

Opening config.plist

  1. Launch ProperTree.
  2. Click "File" → "Open".
  3. Navigate to your EFI/OC/ folder.
  4. Select config.plist and click "Open".

Running OC Snapshot

OC Snapshot automatically adds your kexts and drivers to the config:

  1. With config.plist open, click "File" → "OC Snapshot".
  2. Select your EFI folder.
  3. Choose options (typically defaults are fine).
  4. Click "Snapshot" to update config.plist.

This will populate Kernel → Add and UEFI → Drivers sections.

Editing Config Sections

Kernel → Add

Ensure all your kexts are listed with correct properties:

  • BundlePath: Path to the kext
  • Enabled: true
  • ExecutablePath: Contents/MacOS/[kext name]
  • PlistPath: Contents/Info.plist

UEFI → Drivers

Check that essential drivers are enabled:

  • OpenRuntime.efi
  • HfsPlus.efi
  • AudioDxe.efi (optional)

ACPI → Add

Add your SSDTs here when ready.

Saving Changes

  1. Click "File" → "Save" or press Cmd+S.
  2. Copy the updated config.plist back to your EFI partition.

Troubleshooting

  • If ProperTree won't open, right-click and select "Open" (bypass Gatekeeper).
  • Use "Validate Config" in ProperTree to check for errors.
  • Keep backups of working config.plist files.