Skip to content

Latest commit

 

History

History
81 lines (63 loc) · 7.87 KB

README.md

File metadata and controls

81 lines (63 loc) · 7.87 KB
Raw

CLOVER CRATE

Clover Version Clover Configurator macOS Last Update 00Main

⚠️ Current Issues/Updates
HWTarget is broken in macOS 13+. Use this workaround to get System Updates (or switch to OpenCore).
AMD Users: Clover Configurator 5.23.0 fixed "Skip" and "Count" keys being deleted from config.plist!

ABOUT

Clover Crate is an unofficial documentation for the Clover Boot Manager and its features. Its structure closely follows the hierarchy of the config.plist and the corresponding sections in Clover Configurator.

It provides up-to-date and in-depth explanations for every setting and parameter. Special attention to detail was given to the ACPI section, since it is crucial for configuring a Hackintosh. The documentation is designed to be user-friendly and easy to navigate. The list menu on the top left allows users to quickly jump to the specific topics/sections they're interested in. I am talking about this one:

TOC

Motivation (click to reveal)

Motivation

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 documenting the actual features since it disregards the personal anecdotal remarks 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 (but not updated) 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 Clover gets something that at least documents its features and how to use them properly.
Disclaimer (click to reveal)

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.

SECTIONS

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