🍎 Hackintosh

June 24, 2026 Β· View on GitHub

πŸ‡§πŸ‡· Leia em PortuguΓͺs

Release macOS OpenCore Intel License Stars

OpenCore EFI + scripts to install macOS Sequoia 15 on the Acer Aspire VX5‑591G laptop β€” preparing everything from a Linux PC (or macOS itself), no Mac required.

⚠️ Hackintosh is for study/testing. Use at your own risk.


πŸ’» Tested hardware

ComponentDetailmacOS
ModelAcer Aspire VX5‑591Gβœ…
CPUIntel Core i7‑7700HQ (Kaby Lake)βœ…
iGPUIntel HD Graphics 630βœ… accelerated (Metal 3)
Dedicated GPUNVIDIA GTX 1050Tiβ›” disabled (no macOS driver)
AudioRealtek ALC255βœ…
Wi‑FiIntel 7265βœ… via itlwm + HeliPort app
Bluetooth / EthernetIntel / Realtek RTL8111βœ…
15.6" 1080p display, keyboard, trackpad, brightnessβœ…
External HDMIwired to the iGPU❌ not working on Sequoia (Kaby Lake limitation)

βœ… What works

Accelerated graphics, audio, Wi‑Fi (with HeliPort), Bluetooth, Ethernet, USB, keyboard, trackpad, brightness, iCloud.

β›” Do NOT update to macOS Tahoe (26) β€” it removes audio on Intel chips (ALC255 stops working). Stay on Sequoia 15.


πŸ“Έ Screenshots


About This Mac β€” i7‑7700HQ Β· HD630 Β· 16GB

System Settings β€” Software Update

Safari β€” internet working

Xcode + iPhone Simulator β€” iOS development

πŸ“‚ Project structure

.
β”œβ”€β”€ README.md                ← this file (overview β€” English, default)
β”œβ”€β”€ README-ptbr.md           ← Portuguese version
β”œβ”€β”€ EFI/                      ← ready OpenCore EFI (generate your own serial β€” step 1)
β”œβ”€β”€ scripts/
β”‚   β”œβ”€β”€ create-usb.sh         ← downloads macOS + builds the install USB (automatic)
β”‚   └── gen-smbios.sh         ← generates your own serial (SMBIOS)
β”œβ”€β”€ docs/
β”‚   └── INSTALACAO.md         ← detailed manual guide + troubleshooting (PT-BR)
β”œβ”€β”€ assets/                   ← system screenshots
└── .gitignore

πŸš€ Quick start (scripts)

Requirements: Linux or macOS, with git, python3, curl, unzip. On Linux also: sgdisk, mkfs.vfat, mkfs.exfat, wipefs.

1) Generate your serial (required)

The EFI ships without a serial (each Hackintosh needs a unique one):

./scripts/gen-smbios.sh --inject

Writes Serial, MLB and UUID to EFI/OC/config.plist. (ROM = your network MAC is optional β€” see the guide.)

2) Create the install USB (erases the USB!)

Find the USB disk with lsblk (Linux) or diskutil list (macOS), then run:

# Linux
sudo ./scripts/create-usb.sh --disk /dev/sdX

# macOS
sudo ./scripts/create-usb.sh --disk /dev/diskN

The script downloads macOS Sequoia (BaseSystem + full installer), partitions the USB and copies the EFI + installer. πŸͺ„

Useful options:

  • --mode online β†’ recovery only (smaller USB, β‰₯8GB; installs over the internet)
  • --skip-download β†’ reuse what was already downloaded in downloads/
  • --help β†’ all options

3) Install

Plug it into the Acer β†’ F2 (BIOS: Secure Boot OFF, UEFI) β†’ F12 β†’ boot from the USB β†’ follow the LEIA‑PRIMEIRO.txt the script left on the USB (or the detailed guide).


πŸ“– Full guide

Detailed step‑by‑step (BIOS, manual download, building the USB by hand, install, post‑install, Wi‑Fi, and troubleshooting) in docs/INSTALACAO.md (in Portuguese).


βš™οΈ EFI technical summary

OpenCore 1.0.6 Β· SMBIOS MacBookPro14,3 Β· native KBL HD630 iGPU 0x591b0000 Β· ALC255 layout 99 Β· dGPU disabled (SSDT-DDGPU) Β· Wi‑Fi itlwm Β· Ethernet RTL8111 Β· SecureBootModel = Disabled. Full details in the guide.


πŸ™ Credits


β˜• Support the Project

If this project was useful to you and you'd like to support its development, consider buying me a coffee:

Donate via PayPal

PIX (Brazil): cleyton1986@gmail.com

Any contribution is voluntary and greatly appreciated! It helps keep the project alive and motivates new features.


πŸ“„ License

This project is licensed under the GNU General Public License v3.0 β€” see the LICENSE file for details.

Bundled third‑party components (OpenCore, Lilu, WhateverGreen and other kexts) retain their own licenses.

This software is provided "as is", without warranty of any kind. Hackintosh is for educational/testing purposes β€” use at your own risk.


Developed by OctalDev β€” Cleyton Alves | Senior Software Engineer

Built for the Acer Aspire VX5‑591G. If it helped, leave a ⭐. Hackintosh is for study/testing. πŸš€