{"id":46098853,"url":"https://github.com/valnoxy/t420-oc","last_synced_at":"2026-03-01T19:19:03.541Z","repository":{"id":109530280,"uuid":"388281748","full_name":"valnoxy/t420-oc","owner":"valnoxy","description":"Lenovo ThinkPad T420 Hackintosh (macOS High Sierra, macOS Catalina 10.15.x / Big Sur 11.0.x) - OpenCore","archived":false,"fork":false,"pushed_at":"2024-06-29T16:34:57.000Z","size":8225,"stargazers_count":14,"open_issues_count":3,"forks_count":0,"subscribers_count":4,"default_branch":"main","last_synced_at":"2024-06-29T17:42:48.662Z","etag":null,"topics":["bigsur","catalina","hackintosh","highsierra","macos","opencore","t420"],"latest_commit_sha":null,"homepage":"https://exploitox.de","language":"ASL","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/valnoxy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"valnoxy","patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":null}},"created_at":"2021-07-22T00:28:00.000Z","updated_at":"2024-06-29T16:35:01.000Z","dependencies_parsed_at":"2024-06-29T17:41:15.995Z","dependency_job_id":"fa06a064-76e5-4b8f-9bd9-065cb0f3a6b1","html_url":"https://github.com/valnoxy/t420-oc","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/valnoxy/t420-oc","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/valnoxy%2Ft420-oc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/valnoxy%2Ft420-oc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/valnoxy%2Ft420-oc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/valnoxy%2Ft420-oc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/valnoxy","download_url":"https://codeload.github.com/valnoxy/t420-oc/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/valnoxy%2Ft420-oc/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29981390,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-01T16:35:47.903Z","status":"ssl_error","status_checked_at":"2026-03-01T16:35:44.899Z","response_time":124,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bigsur","catalina","hackintosh","highsierra","macos","opencore","t420"],"created_at":"2026-03-01T19:19:02.973Z","updated_at":"2026-03-01T19:19:03.520Z","avatar_url":"https://github.com/valnoxy.png","language":"ASL","funding_links":["https://github.com/sponsors/valnoxy"],"categories":[],"sub_categories":[],"readme":"# Lenovo ThinkPad T420 - OpenCore Configuation\n\n\u003cimg align=\"right\" src=\"https://dl.exploitox.de/t480-oc/Hackintosh-T480-Sonoma.png\" alt=\"macOS Sonoma running on the T480\" width=\"425\"\u003e\n\n[![macOS](https://img.shields.io/badge/macOS-brightgreen.svg)](https://developer.apple.com/documentation/macos-release-notes)\n[![OpenCore](https://img.shields.io/badge/OpenCore-blue)](https://github.com/acidanthera/OpenCorePkg)\n[![License](https://img.shields.io/badge/license-MIT-purple)](/LICENSE)\n\n\u003cp align=\"center\"\u003e\n   \u003cstrong\u003eStatus: Work in Progress\u003c/strong\u003e\n   \u003cbr /\u003e\n   \u003cstrong\u003eVersion: \u003c/strong\u003e1.0.0-preview1\n   \u003cbr /\u003e\n   \u003ca href=\"https://github.com/valnoxy/t420-oc/releases\"\u003e\u003cstrong\u003eDownload now »\u003c/strong\u003e\u003c/a\u003e\n   \u003cbr /\u003e\n   \u003ca href=\"https://github.com/valnoxy/t420-oc/issues\"\u003eReport Bug\u003c/a\u003e\n   ·\n   \u003ca href=\"https://www.youtube.com/watch?v=thYDWyJuUq4\"\u003eYouTube Video\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/p\u003e\n\u003c/br\u003e\n\n## ⚠️ Disclaimer\n\u003e [!CAUTION]\n\u003e This repo is **Work in Progress**! Expect possible bugs and instability! The development of this project is very slow at the moment because I don't have the time for it.\n\nThis guide is only for the Lenovo ThinkPad T420. I am NOT responsible for any harm you cause to your device. This guide is provided \"as-is\" and all steps taken are done at your own risk.\n\u003e This configuration is based of this [repository by tluck](https://github.com/tluck/Lenovo-T420-Clover).\n\n\u0026nbsp;\n\n## Introduction\n\n### EFI folders\n\nThis repo includes multiple EFI configuations for different macOS Versions.\n\n| EFI               | Description                                                               | Type      |\n| ----------------- | ------------------------------------------------------------------------- | --------- |\n| `EFI`             | Supports macOS High Sierra \u0026 Catalina (using Airportitlwm)                | `Stable`  |\n| `EFI - HeliPort`  | Supports every macOS Version, Require HeliPort app                        | `Soon`    |\n\n\u003ca href=\"https://github.com/OpenIntelWireless/HeliPort/releases\"\u003e\u003cstrong\u003e\nDownload HeliPort app »\u003c/strong\u003e\u003c/a\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e💻 My Hardware\u003c/strong\u003e\u003c/summary\u003e\n\u003cbr\u003e\nThese are the Hardware component I use. But this OpenCore configuation \u003cstrong\u003eshould still work\u003c/strong\u003e with your device, even if the components are not equal.\n\n\u003e **Note** Check the model of your WiFi \u0026 Bluetooth card. Intel cards should be compatible with itlwm (or AirportItlwm). If your card is from another manufacturer, please check if your card supports macOS.\n\n| Category  | Component                            |\n| --------- | ------------------------------------ |\n| CPU       | Intel Core i5-2540M                  |\n| GPU       | Intel HD Graphics 3000               |\n| WiFi \u0026 BT | Dell Wireless 1510 (BCM4322)         |\n\n\u003c/details\u003e  \n\n\u003c/details\u003e\n\n\u0026nbsp;\n\n## Installation\n\n\u003cdetails\u003e  \n\u003csummary\u003e\u003cstrong\u003e📝 Requirements\u003c/strong\u003e\u003c/summary\u003e\n\u003c/br\u003e\n\nYou must have the following items:\n- Lenovo ThinkPad T420 (Obviously 😁).\n- Access to a working Windows machine with Python installed.\n- A pendrive with more than 4 GB (Remember that during the preparation we will format the flash drive to create the installation media).\n- an Internet connection (recommended via Ethernet).\n- 1-2 hours of your time.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e  \n\u003csummary\u003e\u003cstrong\u003e⚙️ Preperation\u003c/strong\u003e\u003c/summary\u003e\n\u003c/br\u003e\n\n### Create the install media\n\nFirst of all, you will need the install media of macOS. I will use [macrecovery](https://github.com/acidanthera/OpenCorePkg) to download and create the macOS Install media.\n\nWith macrecovery, the process is the following:\n- Download [OpenCorePkg](https://github.com/acidanthera/OpenCorePkg) as a ZIP.\n- Extract the OpenCorePkg-master.zip file.\n- Open ```cmd.exe``` with Administrator privileges and change the directory to OpenCorePkg-master\\Utilities\\macrecovery.\n- Enter the following command to download macOS:\n```\n# Big Sur (11)\npython macrecovery.py -b Mac-42FD25EABCABB274 -m 00000000000000000 download\n\n# Monterey (12)\npython macrecovery.py -b Mac-E43C1C25D4880AD6 -m 00000000000000000 download\n\n# Ventura (13)\npython macrecovery.py -b Mac-7BA5B2D9E42DDD94 download\n```\n- After the download succeeded, type ```diskpart``` and wait until you see ```DISKPART\u003e```\n\n- Plug-in your pendrive and type ```list disk``` to see your disk id.\n\n- Select your pendrive by typing ```select disk \u003cdiskid\u003e```\n\n- Now we are gonna clean the pendrive and convert it to GPT. First, type ```clean``` and then ```convert gpt```.\n\n\u003e  **Note**: If an error occurred, try to convert again by typing ```convert gpt```.\n\n- After the pendrive is clean and converted, we will create a new partition where we can put our files on. First, type ```create partition primary```, then select the new partition with ```select partition 1``` and format it ```format fs=fat32 quick```.\n\n- Finally, mount your pendrive by typing ```assign```\n\n- Now, close the Command Prompt and copy the folder ```com.apple.recovery.boot``` on the pendrive. \n\nNow we are ready to make the USB drive bootable.\n\n### Configure and install OpenCore\nDownload the EFI folder from this repo, you will find the latest files under the release tab or just download the repo as it is. Move the folder to the root of your pendrive (e.g. J:\\) and rename the folder to ```EFI```.\n\n#### GenSMBIOS\nWe need a script, called [GenSMBIOS](https://github.com/corpnewt/GenSMBIOS), to create fake serial number, UUID and MLB numbers. **This step is essential to have working iMessage, so do not skip it!**\n\nThe process is the following:\n\n- Download GenSMBIOS as a ZIP, then extract it.\n- Start GenSMBIOS.bat and use option ```1``` to download MacSerial.\n- Choose option ```2```, to select the path of the config.plist file. It will be located in ```EFI -\u003e OC``` folder.\n- Choose option ```3```, and enter ```MacBookPro8,1``` as the machine type.\n- Press ```Q``` to quit. Your config now should contain the requied serials.\n\n#### Enter the proper ROM value\nAfter adding serials to your config.plist, you have to add the computer's MAC address to the config.plist file. **This step is also essential to have a working iMessage, so do not skip it.** We need a Plist editior, to write the MAC address into the config.plist file. I used [ProperTree](https://github.com/corpnewt/ProperTree), since it works on Windows too. You have to change the MAC address value in the config.plist at\n\n```PlatformInfo -\u003e Generic -\u003e ROM```\n\nDelete the generic ```112233445566``` value, and enter your MAC address into the field, without any colons. Save the Plist file, and it is now ready to be written out to the EFI partition of your install media.\n\n#### Default keyboard layout and language\nThe default keyboard layout and language is ```German```. To change the language, edit the value of ```NVRAM -\u003e Add -\u003e 7C436110-AB2A-4BBB-A880-FE41995C9F82 -\u003e prev-lang:kbd``` to the value of your language. If your value contains an underscore \"```_```\", replace it with a hyphen \"```-```\". The value for English would be ```en-US:0```. You can find a list of all language values [here](https://github.com/acidanthera/OpenCorePkg/blob/master/Utilities/AppleKeyboardLayouts/AppleKeyboardLayouts.txt).\n\n##### ACPI patches\nPlease enable / disable the following patches depending on what is installed in your device.\n\n| SSDT              | Affected device            | Description                                                |\n| ----------------- | -------------------------- | ---------------------------------------------------------- |\n| SSDT-ARPT.aml     | Broadcom cards             | Disable Broadcom card during sleep                         |\n| SSDT-OFFTB.aml    | Thunderbolt                | Disable Thunderbolt                                        |\n| SSDT-OFFGDGPU.aml | NVIDIA GeForce MX 150      | Disable NVIDIA GPU (necessary if installed)                |\n\n### Install OpenCore\nAfter you've finished with the neccesary tweaks, you have to copy the EFI folder to the EFI partition of your pendrive.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e  \n\u003csummary\u003e\u003cstrong\u003e🚚 Installation\u003c/strong\u003e\u003c/summary\u003e\n\u003c/br\u003e\n\n### Prepare BIOS\nThe bios must be properly configured prior to installing macOS.\nIn Security menu, set the following settings:\n\n-  `Security \u003e Security Chip`: must be **Disabled**\n-  `Memory Protection \u003e Execution Prevention`: must be **Enabled**\n-  `Virtualization \u003e Intel Virtualization Technology`: must be **Enabled**\n-  `Virtualization \u003e Intel VT-d Feature`: must be **Enabled**\n-  `Anti-Theft \u003e Computrace -\u003e Current Setting`: must be **Disabled**\n-  `Secure Boot \u003e Secure Boot`: must be **Disabled**\n-  `Intel SGX -\u003e Intel SGX Control`: must be **Disabled**\n-  `Device Guard`: must be **Disabled**\n\nIn Startup menu, set the following options:\n\n-  `UEFI/Legacy Boot`: **UEFI Only**\n-  `CSM Support`: **No**\n\nIn Thunderbolt menu, set the following options:\n\n-  `Thunderbolt BIOS Assist Mode`: **UEFI Only**\n-  `Wake by Thunderbolt(TM) 3`: **No**\n-  `Security Level`: **No**\n-  `Support in Pre Boot Environment \u003e Thunderbolt(TM) device`: **No**\n\nNow you can go through the install.\n\n### Install macOS\n1. Boot from USB, press ```SPACE``` and select the USB drive inside of OpenCore ```\"NO NAME (DMG)\" or similar```.\n\u003e  **Note:** The first boot may take up to 20 minutes.\n2. Wait for the macOS Utilities screen.\n3. Select Disk Utility, select your disk and click erase. Give a name and choose **APFS** with **GUID Partition Map**.\n4. After erasing, go back and select **Reinstall macOS** and follow the steps on your screen. The installation make take up to **2 hours**.\n\u003e  **Note:** Your PC will restart multiple times. Just boot from USB and select your disk inside of OpenCore. (named macOS Installer or the disk name).\n5. Once you see the `Region selection` screen, you are good to proceed.\n6. Create your user accound and everything else.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e  \n\u003csummary\u003e\u003cstrong\u003e♻️ Upgrade macOS / Switch EFI\u003c/strong\u003e\u003c/summary\u003e\n\u003c/br\u003e\n\nIf you plan to upgrade your macOS (or updating the EFI / switching to HeliPort), you'll need a different OpenCore configuation (EFI). Please follow these steps:\n\n\u003e Note: Download the desired macOS version in the Settings before following these steps, if you are connected via WiFi.\n\n1. Download the newest release \u0026 [ProperTree](https://github.com/corpnewt/ProperTree) and extract it.\n2. Start ProperTree and load the ```Config.plist``` on your EFI partition. (File -\u003e Open)\n\u003e Note: You can mount your EFI partition by pressing ```ALT + SPACE```, typing Terminal and enter the following command: ```sudo diskutil mountDisk disk0s1```.\n3. Now also load the new configuration file from the repo for the desired macOS installation (or HeliPort config). \n4. You should now have 2 ProperTree-windows open on your screen.\n5. Go in both windows to ```Root -\u003e PlatformInfo -\u003e Generic```. Transfer ```MLB, ROM, SystemProductName, SystemSerialNumber and SystemUUID``` to the new config. \n6. Save the new config (File -\u003e Save) and close both windows.\n7. Now delete your existing EFI folder from the EFI partition and copy the new one to it. (Make sure that the Directorys ```Boot and OC``` are in ```EFI```).\n\nIf you want to upgrade macOS, download the desired macOS version in the Settings app and perform the upgrade like on a real Mac.\n\n\u003c/details\u003e\n\n\u0026nbsp;\n\n## Post-install (optional)\n\n\u003cdetails\u003e  \n\u003csummary\u003e\u003cstrong\u003e💾 Install OpenCore to Hard drive\u003c/strong\u003e\u003c/summary\u003e\n\u003c/br\u003e\n\n1. Press `ALT + SPACE` and open terminal. Type `sudo diskutil mountDisk disk0s1` (where disk0s1 corresponds to the EFI partition of the main disk)\n2. Open Finder and copy the EFI folder of your USB device to the main disk's EFI partition.\n3. Unplug the USB device and reboot your laptop. Now you can boot macOS without your USB device.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e  \n\u003csummary\u003e\u003cstrong\u003e✏️ Create a offline install media (Optional)\u003c/strong\u003e\u003c/summary\u003e\n\u003c/br\u003e\n\nIn case of reinstalling macOS, a offline install media can save some time. You also don't need an Ethernet connection for the installation.\nTo create a offline install media, you need the following stuff: \n\n- macOS Installer from the App Store.\n- A 16 GB pendrive (Keep in mind, during the preperation we will format the disk to create the install media).\n\nPress `ALT + SPACE` and open Disk utility. Select your USB device and click erase. Name it `MyUSB` and choose **Mac OS Extended** with **GUID Partition Map**. After erasing the USB device, close Disk utility.\n\nNow press `ALT + SPACE` and open terminal. Type the following command:\n\nBig Sur:\n```sudo /Applications/Install\\ macOS\\ Big\\ Sur.app/Contents/Resources/createinstallmedia --volume /Volumes/MyUSB --downloadassets```\n\nMonterey:\n```sudo /Applications/Install\\ macOS\\ Monterey.app/Contents/Resources/createinstallmedia --volume /Volumes/MyUSB --downloadassets```\n\nVentura:\n```sudo /Applications/Install\\ macOS\\ Ventura.app/Contents/Resources/createinstallmedia --volume /Volumes/MyUSB --downloadassets```\n\nAfter creating the install media, copy your EFI folder to the EFI partition of your USB device.\n\n\n\u003c/details\u003e\n\n\u0026nbsp;\n\n## Status\n\n\u003cdetails\u003e  \n\u003csummary\u003e\u003cstrong\u003e✅ What's working\u003c/strong\u003e\u003c/summary\u003e\n\u003c/br\u003e\n \n- [X] It boots\n\n\u003c/details\u003e\n\n\u003cdetails\u003e  \n\u003csummary\u003e\u003cstrong\u003e⚠️ What's not working\u003c/strong\u003e\u003c/summary\u003e\n\u003c/br\u003e\n\n- [ ] Safari DRM ```Use Chromium powered Browser or Firefox to watch Amazon Prime Video, Netflix, Disney+ and others```\n- [ ] AirDrop \u0026 Continuity (devices with Intel WiFi)\n- [ ] Fingerprint Reader (Disabled with NoTouchID kext)\n- [ ] Sidecar Wireless\n- [ ] Apple Watch Unlock\n- [ ] Dualbooting Windows / Linux (with OpenCore) ```Theoretically, this works, but due to the ACPI patches, the respective operating system can become unstable.```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e  \n\u003csummary\u003e\u003cstrong\u003e🔄 Not tested\u003c/strong\u003e\u003c/summary\u003e\n\u003c/br\u003e\n\n- [ ] Intel WiFi \u0026 Bluetooth (thanks to [itlwn](https://github.com/OpenIntelWireless/itlwm))\n- [ ] Brightness / Volume Control\n- [ ] Battery Information\n- [ ] Audio (Audio Jack \u0026 Speaker)\n- [ ] USB Ports \u0026 Built-in Camera\n- [ ] Graphics Acceleration\n- [ ] Trackpoint / Touchpad\n- [ ] Power management / Sleep\n- [ ] FaceTime / iMessage (iServices)\n- [ ] HDMI\n- [ ] Automatic OS updates\n- [ ] Handoff / Universal Clipboard\n- [ ] Sidecar (Cable) / AirPlay to Mac\n- [ ] SIP / FireVault 2\n- [ ] USB-C\n- [ ] WWAN\n\n\u003c/details\u003e\n\n\u0026nbsp;\n\n## ⭐️ Feedback\nDid you find any bugs or just have some questions? Feel free to provide your feedback using the Discussions tab.\n\n\u0026nbsp;\n\n## 📜 License\n\nThis repo is licensed under the [MIT License](https://github.com/valnoxy/t420-oc/blob/main/LICENSE).\n\nOpenCore is licensed under the [BSD 3-Clause License](https://github.com/acidanthera/OpenCorePkg/blob/master/LICENSE.txt).\n\n\u003chr\u003e\n\u003ch6 align=\"center\"\u003e© 2018 - 2024 valnoxy. All Rights Reserved. \n\u003cbr\u003e\nBy Jonas Günner \u0026lt;jonas@exploitox.de\u0026gt;\u003c/h6\u003e\n\u003cp align=\"center\"\u003e\n\t\u003ca href=\"https://github.com/valnoxy/t420-oc/blob/main/LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/static/v1.svg?style=for-the-badge\u0026label=License\u0026message=MIT\u0026logoColor=d9e0ee\u0026colorA=363a4f\u0026colorB=b7bdf8\"/\u003e\u003c/a\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvalnoxy%2Ft420-oc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvalnoxy%2Ft420-oc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvalnoxy%2Ft420-oc/lists"}