Git Product home page Git Product logo

clover-crate's Introduction

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

clover-crate's People

Contributors

5t33z0 avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

clover-crate's Issues

Unsure about ExtendedFirmwareFeaturesMask

Hi,
I am trying to update Monterey beta 6 to Monterey 12.0.1

First of all setting the j160 HWTarget make the installer app say the device is unsupported, removing does the trick though

I also read that to continue the update, ExtendedFirmwareFeatures and its mask need to be set

i seem to have understood how to calculate the first variable, but i don't know how to calculate the mask. Using the values from Clover's sample config plist does not work, as the system reboots indefinitely after monterey detects something is not right

Any help is appreciated.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.