Open source tutorial & information collector for hackintosh installation.



# Hackintosh-Installer-University
[![License](https://img.shields.io/badge/license-CC%204.0-blue.svg)](https://creativecommons.org/licenses/by/4.0/)
![progress](https://img.shields.io/badge/progress-developing-yellow.svg)
[![contributions](https://img.shields.io/badge/contributions-welcome-green.svg)](https://github.com/huangyz0918/Hackintosh-Installer-University) 


:loudspeaker: This is an open source tutorial & information collector for Hackintosh installations that does not charge readers any fee. 

:loudspeaker: We don't want to build a universal installation tutorial and, it's also impossible since every device is different. We are here because we want to gather information and experiences, we want to build an index for most successful builds in GitHub and make them be discovered more easily. When I was just a newbie, I didn't know how to get started building a Hackintosh since I didn't know what's a bootloader and an EFI partition. It took me a long time to find a helpful build in Github due to the deep location of that repo. So this is the purpose why we created this index.

:loudspeaker: As we know, Hackintosh is potentially illegal because doing this violates the end-user license agreement [(EULA)](http://images.apple.com/legal/sla/docs/macosx107.pdf) from Apple for macOS. Therefore, we just focus on the technologies related to Hackintosh and do not use it commercially. If you want to get started, please first read this license in detail and remember that you are a geek, not a criminal.

Here are some other language versions:
- [中文版本](README-CN.md)


## What's Hackintosh ?

When Apple announced their switch away from the PowerPC architecture to Intel's processors and chipsets, many were looking forward to having the ability to run Windows software on Apple hardware and Apple's operating systems on their non-Apple hardware. Apple was able to eventually build their Boot Camp feature in Mac OS X 10.5, later allowing Windows to run on Apple hardware. Those hoping to easily run Mac OS X on a standard PC didn't have it so easy.

Even though running Mac OS X on a generic PC is not supported by Apple, it is possible to accomplish given the right hardware and determination by users. Any system that is not made to run the Apple operating system is referred to as Hackintosh. This term comes from the fact that the software needs to be hacked to properly run on Non-Apple hardware. Of course, some of the hardware needs to be tweaked in a few cases as well.

## How to learn Hackintosh ?

:bell:There's a lot to learn if you want to figure out the secrets behind Hackintosh, please go this door ---> [:door:](slow/slow.md)

:bell:If you have no interest in those theories, and just want a quick installation, please go through this door ---> [:door:](quick/quick.md)

### Famous websites for hackintosh and macOS
- [Wikipedia](https://en.wikipedia.org/wiki/Hackintosh)
- [OSx86 Project](https://www.osx86project.org/)
- [Tonymacx86](https://www.tonymacx86.com/)
- [hackintosh.com](https://hackintosh.com/)
- [9to5mac](https://9to5mac.com/)
- [Rehabman Github](https://github.com/RehabMan)
- [Rehabman Bitbucket](https://bitbucket.org/RehabMan/)
- [PCbeta](http://mac.pcbeta.com/)
- [iMacHK](https://imac.hk/)

### Devices available in Res

- [Lenove B50-70](https://github.com/huangyz0918/Hackintosh-Installer-University/tree/master/Res/%20Lenove-B50-intelHD4600-success)
- [Asus-P8Z77-V-LX-10.12.6](https://github.com/huangyz0918/Hackintosh-Installer-University/tree/master/Res/Asus-P8Z77-V-LX-10.12.6)
- [Gigabyte Z270XP-SLI](https://github.com/huangyz0918/Hackintosh-Installer-University/tree/master/Res/Gigabyte-GA-Z270XP-SLI-10.13.4)

### Devices avaliable in Github

- [Acer Aspire E1-471G](https://github.com/matthew728960/Clover-ACER-E1-471G)
- [Acer A515-51G](https://github.com/SiddheshNan/Acer-A515-51G-Hackintosh)
- [Acer V5-573G](https://github.com/Kaijun/Acer-V5-573G-Hackintosh)
- [Acer Aspire E5-571-376T](https://github.com/GalaticStryder/Acer-E5-571-Hackintosh)
- [Acer Aspire V3-371-52FF](https://github.com/Ty3uK/52ff-elcapitan-toolbox)
- [Acer Aspire E5-473-30N5](https://github.com/b-ggs/aspire-e5-hackintosh)
- [Acer Aspire V3-572G](https://github.com/FREDwiz/Hackintosh)
- [Alienware 17 R4 KBL-1060 Dual Graphics](https://github.com/RockJesus/Alienware-17-R4-I7-7700HQ-MacOS-High-Sierra)
- [Asus FX50J/X550JX](https://github.com/Xc2333/Hackintosh-ASUS-FX50J)
- [Asus H81M-K](https://github.com/Slbomber/AsusH81MK-macos)
- [Asus Zenbook](https://github.com/hieplpvip/ASUS-ZENBOOK-HACKINTOSH)
- [Asus Vivobook S510UA](https://github.com/tctien342/Asus-Vivobook-S510UA-High-Sierra-10.13-Hackintosh)
- [Asus ROG Zephyrus S GX531](https://github.com/williambj1/Hackintosh-EFI-Asus-Zephyrus-S-GX531)
- [Dell 7559 4K SKL](https://github.com/RockJesus/Dell-7559-I7-6700HQ-4K-touch-MacOS-High-Sierra)
- [Dell G7 7588 OpenCore](https://github.com/Juan-VC/Hackintosh-macOS-Dell-G7-7588)
- [Dell XPS13-9350-Skylake](https://github.com/syscl/XPS9350-macOS)
- [Dell XPS15-9550](https://github.com/corenel/XPS9550-macOS)
- [Dell XPS15-9550](https://github.com/PromiseYo/XPS15-9550-macOS)
- [Dell XPS13-9360](https://github.com/the-darkvoid/XPS9360-macOS)
- [Dell XPS15-9530-Haswell](https://github.com/the-darkvoid/XPS9530-OSX)
- [Gigabyte GA-Z77-DS3H](https://github.com/tkrotoff/Gigabyte-GA-Z77-DS3H-rev1.1-Hackintosh)
- [Gigabyte GA-H97-D3H](https://github.com/korzhyk/Clover_GA-H97-D3H)
- [Gigabyte GA-Z270M-D3H](https://github.com/LER0ever/Hackintosh)
- [Gigabyte X99P-SLI](https://github.com/koush/EFI-X99)
- [Gigabyte Aero15-W](https://github.com/Errrneist/Hackintosh-Aero-15W)
- [Gigabyte z170x ud3 ultra](https://github.com/RoJoHub/Hackintosh)
- [Gigabyte Sabre15K](https://github.com/gnehs/Sabre15KClover)
- [Lenovo chao 5000](https://github.com/Xc2333/Hackintosh-Lenovo-chao5000)
- [Lenovo G50-70M](https://github.com/LEXUGE/macOS-Lenovo_G50-70M)
- [Lenovo G50-80](https://github.com/upupming/Lenovo-G50-80-Clover)
- [Lenovo Thinkpad P50](https://github.com/Errrneist/Hackintosh-Thinkpad-P50)
- [Lenove Thinkpad T450](https://github.com/shmilee/T450-Hackintosh)
- [Lenovo Thinkpad T460P](https://github.com/LER0ever/Hackintosh)
- [Lenovo T430s](https://github.com/dmitriypavlov/T430s-macOS)
- [Lenovo T430-NVS5400M](https://github.com/david-cako/T430-Hackintosh)
- [Lenovo T450s](https://github.com/stevenmirabito/T450s-Hackintosh)
- [Lenovo U330/U430/U530](https://github.com/RehabMan/Lenovo-U430-Touch-DSDT-Patch)
- [Lenovo Y470](https://github.com/Dwarven/Hackintosh/tree/master/Lenovo%20Y470)
- [Lenovo Y50-70](https://github.com/RehabMan/Lenovo-Y50-DSDT-Patch)
- [Lenovo Z50-70](https://github.com/Maxvien/hackintosh-lenovo-z5070)
- [Lenovo B470](https://github.com/0xE8551CCB/hackintosh)
- [Lenovo G470](https://github.com/hunterMG/DSDT-Lenovo-G470)
- [Lenovo T470 (i5-6300U)](https://github.com/okay/t470)
- [Lenovo x230 ](https://github.com/edu-rinaldi/Lenovo-x230-High-Sierra)
- [Lenovo Yoga 710](https://github.com/xiaoxx970/Hackintosh-Mojave-for-Lenovo-Yoga710)
- [Lenovo Yoga 3 Pro](https://github.com/zohaad/hackintosh-Yoga-3-Pro)
- [Lenovo-v3000-ISE](https://github.com/Xc2333/Hackintosh-Lenovo-v3000-ISE)
- [Lenovo-rescuer-15-isk](https://github.com/oneplusdash/lenovo-rescuer-15-isk-hackintosh)
- [Lenovo Ideapad 310-14IKB](https://github.com/29satnam/LenovoHackintoshEFI)
- [Lenovo-XiaoXin700-15ISK](https://github.com/athlonreg/Lenovo-XiaoXin700-15ISK)
- [HUANAN X79](https://github.com/cheneyveron/clover-x79-e5-2670-gtx650)
- [HP ProBook/EliteBook/ZBook](https://github.com/RehabMan/HP-ProBook-4x30s-DSDT-Patch)
- [HP Elitebook 8470p](https://github.com/minhphuc429/hackintosh-hp-elitebook-8470p)
- [HP Elitebook 8470p](https://github.com/dreadkopp/8470p_10.13.x)
- [HP Elitebook 840 G1/G2](https://github.com/loicpirez/HackintoshConfig)
- [HP Elitebook Folio 9480m](https://github.com/obviouslyerratic/clover_9480m)
- [HP EliteDesk 800 G2 TWR](https://github.com/sakoula/HP-EliteDesk-800-G2-6700)
- [HP Envy J-series](https://github.com/RehabMan/HP-Envy-DSDT-Patch)
- [HP Envy K-series](https://github.com/RehabMan/HP-Envy-K-DSDT-Patch)
- [HP Envy Q-series](https://github.com/RehabMan/HP-Envy-Q-DSDT-Patch)
- [HP Envy N-series](https://github.com/RehabMan/HP-Envy-N-DSDT-Patch)
- [HP Z420 Workstation](https://github.com/NTT123/Hackintosh-HP-Z420-MacOS-High-Sierra-10.13)
- [Samsung 450r5j](https://github.com/LER0ever/Hackintosh)
- [Samsung nt550p7c-IVY](https://github.com/RockJesus/samsung-nt550p7c-sierra)
- [Samsung NT900X3L-K501S](https://github.com/justiceserv/NT900X3L-Hackintosh)
- [XiaoMi NoteBook Pro](https://github.com/daliansky/XiaoMi-Pro)
- [Xiaomi Mi Air 13.3 Skylake-U 2016 (1rst Gen)](https://github.com/sakoula/XiaoMi-Air-6200U)


## * CLOVER Collections
We have collected some **CLOVER EFI configurations**, you can checkout in our repo:

- [Asus](https://github.com/huangyz0918/Hackintosh-Installer-University/tree/master/Clover-Configs/Asus)
- [Acer](https://github.com/huangyz0918/Hackintosh-Installer-University/tree/master/Clover-Configs/Acer)
- [Lenovo](https://github.com/huangyz0918/Hackintosh-Installer-University/tree/master/Clover-Configs/Lenovo)
- [Dell](https://github.com/huangyz0918/Hackintosh-Installer-University/tree/master/Clover-Configs/Dell)
- [Xiao Mi](https://github.com/huangyz0918/Hackintosh-Installer-University/tree/master/Clover-Configs/XiaoMi)
- [LG](https://github.com/huangyz0918/Hackintosh-Installer-University/tree/master/Clover-Configs/LG)

If you have a laptop, there are many good guides for laptops on Tonymacx86. Search your laptop and you may find a guide for it or similar one.

## How to contribute to this repository?

You need to `fork` this repository, just click the `fork` button at the top of this page.
After a fork, you can use git to clone this repository to your local device and make changes in your branches. We encourage you to  contribute to this repo by submitting a pull request.

### **Contribute to tutorials**
The core part of this repo are tutorials, we distribute all of them into these parts:

- **Buyer's guide**

    In this part, you can get a quick idea of Hackintosh and get to know what hardware is suitable for installing Mackintosh on PC hardware. You can learn a lot about computer hardware like CPU, Hard Drives and graphics cards in this chapter. We keep these in the standalone folder `Hardwares`.

- **Bootloader Installation Guide**

    In this part, we will focus on the bootloaders of Hackintosh, you can gain knowledge about how a computer(PC) boots and how a operation system launches. We also cover information about the Clover Bootloader and Chameleon Bootloader here. We keep these in the `Bootloader` folder.

- **System Installation Guide**
  
    This is a introduction about macOS system installation. We keep these articles in the  `System` floder.

- **Post Installation Guide**

    This part is intended for post installation. Here, you can learn about basic drivers and kexts of your system and macOS. If you want to contribute to this part, please put your articles into `Post` folder.

- **Troubleshooting**

    We have a specific part for addressing issues, if you have any questions you can open an issue and ask for help from others. Also, if you want to share your experience about fixing some issues during hackintosh installation, you can contribute to this part. Don't forget to attach your hardware information and put your experience into `troubleshooting` workspace.

We will improve the workspace tree day by day, so don't forget to give us your precious suggestions !

### **Contribute to resource**
We encourage you to upload your hackintosh configs and kexts if you don't mind. This repo has a workspace named `Res` and you can make your own workspace there, and share your successful configs and kexts with others if you want. It's a good place to make a backup and share. Be sure to follow thses rules:

- Build your device folder under `Res` folder, named your device like this: `Computer brand-model-macOS  version`
- Put your device information into a markdown file: `info.md`.
- Put your configs in the root of workspace and create a `kexts` folder to hold all your kexts.
- For `kexts` folder, you can create different subfolders for different kinds of kexts, such as `Wifi`, `Graphics Cards` and so on.
- Please give links rather than uploading many large files.
- If you are a lazy person who get tired with creating so many folders, it's good for you to put the whole `EFI` along with your system kexts & information in your workspace.

A good example may look like this:

```bash

Res/
└── Lenove-B50-10.12.6
    ├── config.plist
    ├── info.md
    └── kexts/

```
A good `info.md` file looks like:

```markdown
- Device name: GA-Z170-Gaming 7
- CPU: i7-6700K
- Graphics: Nvidia GeForce GT 640
- Graphics: Intel HD4600

```

We are all looking forward to your resources! :+1:

## License
[Attribution 4.0 International (CC BY 4.0)](https://creativecommons.org/licenses/by/4.0/)

<img width="120" src="https://i.loli.net/2018/05/15/5afaddc9aa3f5.png"/><img width="120" src="https://i.loli.net/2018/05/15/5afaddc9a9789.png"/>


