Code Monkey home page Code Monkey logo

hackintosh-guide's Introduction

Getting Started

So You Want A Vanilla Install?

What does that even mean?

A vanilla setup implies that the OS itself remains relatively untouched - and that the bulk of the Hackintosh-related kexts, patches, etc are contained on the EFI partition. For all intents and purposes, a vanilla install's main partition is identical to that of an official Apple computer.

Quick Terms Glossary

There's a number of terms you'll be seeing throughout this guide - I'll outline a few of them and their definitions here:

  • Clover - this is the bootloader we'll be using. Real macs have a custom firmware that allows them to boot macOS. PC hardware needs a little help to get this working; Clover helps us achieve that. It also handles kext injection, ACPI renames, kext patches, and a ton of other functions.
  • Kexts - the word "kext" is actually the combination of Kernel Extension; and you can think of kexts simply as drivers for macOS.
  • Config.plist - this is the file that tells Clover what to do. It's an XML formatted property list (looks very similar to HTML) and is one of the most important parts of setting up your Hackintosh.
  • OOB - an acronym for Out Of the Box that implies working support without tweaking.
  • More will be added as I work on this guide (probably)

PreRequisites

This guide focuses on Desktops ONLY. There are other guides out there for laptops (see RehabMan's guide at TMac) - but they're often much more specific than this guide will be.

We'll need a few things to get us started:

  1. An 8+GB USB flash drive
  2. The Install OS X/macOS.app (preferably downloaded direct from the app store)
  3. __Clover's Install Package __(courtesy of Dids)
  4. Clover Configurator (the brave can edit with any text editor - but CC is typically quicker)
    • Make sure you get the Global edition
  5. __VirtualSMC.kext - this supercedes FakeSMC.kext as our SMC emulator and either VirtualSMC or FakeSMC is vital to booting our Hackintosh. Without one of them, we'd never boot.
  6. Any other kexts for our mobo/etc
    • We'll go over this in the next section!
  7. Some patience, persistence, and google-fu

hackintosh-guide's People

Contributors

corpnewt avatar fotvoren avatar gitbook-bot avatar johan456789 avatar midi1996 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  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  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

hackintosh-guide's Issues

Ivy Bridge config.plist

I have a GA-Z68M-D2H motherboard with a i7-3770 CPU. Do you have the matching Ivy Bridge config.plist?

USBMap Guide

I use your brilliant USBMap cli tool as do many others, I know there are other methods but given that it and this guide are both yours I think it could be good to have a section here on how to use it.

After using USBMap recently to get Catalina Beta to install I have to say it wasn't as complicated as the guides I came across made it out to be, especially with your tool although it can be hard to know where to start.

I was going to write a step by step guide for myself on it for future reference but if you think it would make sense in this guide I could put it here instead. lmk

[Suggestion] Clarification and more details needed for framebuffer patching

I was wondering if you could flesh out the Kaby/Coffe Lake framebuffer properties section a bit. It seems some details are missing that make the section confusing.

You say “the way we get the proper value for this is to look at the ig-platform-id we intend to use, then swap the pairs of hex bytes.” However, there is no mention of where or how to get the ig-platform-id or device id we need for our system in order to follow the rest of your instructions in the section.

Also, it isn't shown how to actually “swap hex bytes” and google wasn’t much help. A line or two on how to do this would be helpful.

So, if possible, I think it would help users, especially noobs, if this section was expanded a bit. And it might lead to fewer posts on reddit or discord asking for help.

Thanks.

Coffee lake: animations lag and iGPU Metal support

Hi,

I've followed your guide to build an hackintosh but i'm experiencing some animations lag in the Mission Control due to the lack of the iGPU metal support.

What i've tried so far:

  • Using different SMBIOSes: 17.1, 18.1, 18.2, and 18.3
  • Using different ig-platform-id: 0x3E9B0007 and 0x3E920003 (for each SMBIOS above)
  • Using a different DisplayPort
  • Recompiled and installed WhateverGreen and Lilu with the latest GitHub changes
  • Removing all USB devices
  • Update the BIOS to the latest version
  • Flip the GPU BIOS switch
  • Remove the shikigva=40 bootflag
  • Remove the shikigva=40 bootflag and the Devices>Properties section

image

Could the problem be related to some BIOS setting? Like CSM UEFI/Legacy option?

My system: CPU: 8700k Motherboard: ROG STRIX Z370-I GAMING GPU: SAPPHIRE NITRO+ RADEON RX 580 8GB
Reddit post: https://www.reddit.com/r/hackintosh/comments/a6n4w4/8700k_rx_580_ui_lag/

ACPI names are *always* 4 characters

Hello CorpNewt,

Thank you very much for your excellent guide.

At one point, I think it needs a change:
'XHC' is represented as 'XHC_'
see: RehabMan
Quote: ACPI names are always 4 characters. 'XHC' is represented as 'XHC_'. Read the ACPI spec.

Regards, Rudolf DL5FA

Missing -n in echo

Very small issue, just for "to be fully correct". :)

echo External | base64 produces RXh0ZXJuYWwK

and the echo -n External | base64 will spit out the wanted RXh0ZXJuYWw= :)

diff --git a/Hackintosh-Guide-master/Hackintosh-Guide-master/config.plist-basics.md b/Hackintosh-Guide-master copy/Hackintosh-Guide-master/config.plist-basics.md
index d9b9f8a..088c98c 100755
--- a/Hackintosh-Guide-master/Hackintosh-Guide-master/config.plist-basics.md
+++ b/Hackintosh-Guide-master copy/Hackintosh-Guide-master/config.plist-basics.md       
@@ -38,7 +38,7 @@ This will output `External` on the next line. We use the `&& echo` to output a n
 
 You can also convert from ASCII to base64 \(handy for working with ACPI renames - more about that later\) with the following in Terminal.app:
 
-`echo External | base64`
+`echo -n External | base64`
 
 This will spit out `RXh0ZXJuYWw=` which is exactly what we'd expect.

AptioMemoryFix no longer available in Clover ^v4988

Hey @corpnewt thanks for this guide, it's really easy to follow and I have never felt so confident about my hackintosh in the 5 years I've been using when as when I followed this guide.

AptioMemoryFix.efi no longer ships with new versions of Clover. According to this ticket OsXAptioFix3Drv is now the preferred driver. Recently I have been using this driver and haven't noticed any problems with stability, NVRAM. Should we change the docs at https://github.com/corpnewt/Hackintosh-Guide/blob/master/clover-setup.md#installing-clover to reflect these changes?

Sandy Bridge config.plist

First, thank you very munch for this beautiful guide!

I have an old Sandy Bridge based computer at home that I want to update.
It currently runs Yosemite with a tonymacx86 setup but I want to move on a vanilla setup (last time I played with Hackintosh stuff it was the golden age of Chameleon and DSDT files :-D).

Do you think that I can follow your Ivy Bridge section to perform a fresh High Sierra install?

Specs (if needed):

  • MSI H61M-P31/W8
  • Intel Core i5 2500K Sandy Bridge
  • NVidia GeForce 8800GT

Thank you!

ACPI trouble

Hi folk;

I been hit whit this type of error ACPI Exception ARE_NOT_Found

I tested the config.plist of Coffe Lake, Kaby Lake, Skylake, and
I get the error of ACPI Exception ARE_NOT_Found, also I try whit acpi=off but I not have success.

I been looking around in the interwebs whit out any
possible solution for my trouble.

Can be possible that you can help me whit this?

Thanks in advance.

USB Installer - need to give a link/explanation w.r.t. "partial" Install downloads

Good day,

There should be an explanation how to get the full Install image as the AppStore now only downloads a partial "stub" installer, so readers should be made aware that the case of this happening, that they should start the installer, let it download the full ~6GB installer image/data, abort/quit the installation when it request the reboot, and have that copied into the Install macOS Mojave directory before the installmedia scripts would work.

Should that be done inline, or rather as a separate page linked to from the "Create Install USB" page?

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.