/Clover-Crate

Clover Bootloader (with Quirks) and Clover Configurator explained in detail. A usable documentation for Clover and Clover Configurator with additional guides.

Primary LanguageASLBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

CLOVER CRATE

Clover Version Clover Configurator macOS Last Update 00Main

⚠️ CAUTION
AMD Users: Clover Configurator 5.23.0 fixed "Skip" and "Count" keys being deleted from config.plist!

ABOUT

Clover Crate is an unofficial documentation of the popular Clover Boot Manager and its features to help you to figure out what each option does since the whole Clover project is a mess in regards to documentation (especially in English). Its structure closely follows the hierarchy of the config.plist and the corresponding sections in Clover Configurator.

Every setting/parameter (besides obvious ones) is explained. Special attention to detail was given to the ACPI section, as it is one of the most important interfaces for configuring a Hackintosh. In each section/chapter, you can click on the list menu on the top left to select a feature you are interested in to jump to the corresponding entry, so you don't have to scroll all the way through a document. I am talking about this one:

TOC

I created this repo for the following reasons:

  1. Overcoming language barriers: Clover's official documentation (PDF, 182 pages) is only available in Russian.
  2. Condensing information and presenting it in a modern way, making use of GitHub and Markdown. It's also much more focused on documentaing the actual features since it disregards all the personal anecdotal notes that the official documentation contains.
  3. Consolidating and unifying resources which are scattered all over the internet: the manual is only available in Russian on GitHub, the changelog is only available at insanelymac and the Clover Wiki had been neglected for years until it finally got integrated into Clover's GitHub Repo in 2022 (after I started Clover Crate).
  4. Exemplifying Clover's features using Clover Configurator: Acidanthera and Dortania did such an amazing job on documenting OpenCore that I though it was about time Clvoer gets something that at least documents its features and how to use them properly.

Disclaimer

The information provided in this repository is based on excerpts of the official Russian documentation for Clover using AI-based translation tools (deepl, google and yandex translate) as well as my own extensive research. The translations were reviewed and redacted afterwards, so that they follow the rules of English grammar and spelling while preserving their meanings. Nevertheless, some details may have been lost in translation (although I doubt it).

The methods and techniques presented in this repo are based on utilizing the official Clover release and its features alongside Kexts, SSDTs, Device Properties and other tools to enable/disable devices and features in macOS to get a proper working system which is ACPI conform!

Clover-Crate does not consider patching the DSDT an appropriate measure to get the "Real Vanilla Hackintosh" experience and therefore does not support nor promote patching the DSDT. In fact, it's quite the opposite, as explained here:

MaLd0n's implications that you need a custom DSDT to add and remove (well, remove yes, but disabling is good enough in virtually all cases) devices is incorrect. Aside from those claims, most device rename changes (probably also things you considered „missing“) are also not needed, as they are performed by Lilu and its plug-ins. This approach is a lot safer than previous ACPI renames as dumb find-replace patches can yield false positives, the kext approach cannot.

TABLE of CONTENTS

CONTRIBUTIONS

If you would like to contribute to the information provided in this repo in order to improve/expand it, feel free to create an issue with a meaningful title, link to the chapter/section and describe what you like to add, change, correct or expand upon.

CREDITS