whatisgithub

What is restrictevents?

corpnewt/restrictevents — explained in plain English

Analysis updated 2026-08-05 · repo last pushed 2025-04-03

2C++Audience · ops devopsComplexity · 4/5StaleSetup · hard

In one sentence

A macOS kernel extension that hides hardware warnings and unlocks features on Hackintosh systems, so macOS runs smoothly on non-Apple hardware.

Mindmap

mindmap
  root((repo))
    What it does
      Blocks warning processes
      Patches system info
      Hides notification badges
    Tech stack
      C++
      Lilu framework
      Kernel extension
    Use cases
      Hide RAM slot warnings
      Custom CPU name display
      Stop GPU process crashes
    Audience
      Hackintosh builders
      OpenCore users
      AMD CPU users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Hide PCI expansion slot and RAM configuration warnings when running macOS on custom hardware.

USE CASE 2

Replace the CPU brand string in System Information for non-Intel processors like AMD.

USE CASE 3

Stop crash-prone background system services tied to unsupported older GPUs on macOS Ventura or later.

USE CASE 4

Unlock grayed-out macOS features such as the memory tab in System Information on non-standard hardware.

What is it built with?

C++LilumacOS kernel extensionOpenCore

How does it compare?

corpnewt/restrictevents0verflowme/learning-v89veedz/4leggedspiderbot
Stars222
LanguageC++C++C++
Last pushed2025-04-032022-07-16
MaintenanceStaleDormant
Setup difficultyhardhardhard
Complexity4/54/54/5
Audienceops devopsdevelopervibe coder

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires an existing Hackintosh setup with OpenCore and the Lilu kext installed, plus comfort editing boot arguments or NVRAM variables.

No license information was provided in the explanation, so usage terms are unknown.

So what is it?

RestrictEvents is a tool for people running macOS on hardware that Apple didn't intend it to run on, typically Hackintosh builders or anyone using OpenCore to boot macOS on non-standard configurations. It stops macOS from showing warnings, errors, and notification badges that pop up when the operating system notices hardware it doesn't expect, and it can unlock certain features that Apple normally restricts to specific Mac models. At a technical level, it's a kernel extension built on top of Lilu, which is a plugin framework for modifying macOS behavior at a low level. The extension does two main things: it blocks specific macOS processes from running (ones that trigger hardware-related notifications), and it patches parts of the system interface to hide or adjust information that would otherwise look wrong. For example, it can suppress the PCI expansion slot and RAM configuration warnings that appear on systems pretending to be a MacPro, or replace the CPU name shown in System Information with a custom string for non-Intel processors. The people who need this are running macOS on custom-built PCs, older hardware, or configurations that don't perfectly match a real Mac. Without it, they might see persistent notification badges in the Apple menu about memory slots or expansion cards, crash-prone system services tied to unsupported GPUs, or grayed-out features like the memory tab in System Information. Someone running macOS on an AMD CPU, for instance, would use it to patch the CPU brand string so System Information displays correctly. Someone with a Metal 1-era GPU on Ventura or later would use it to stop a background process from crashing. Configuration happens through boot arguments or NVRAM variables, letting users toggle individual patches on or off. The tool is maintained under the Acidanthera umbrella, which is the same group behind OpenCore and many other Hackintosh utilities, so it's designed to integrate cleanly with that ecosystem.

Copy-paste prompts

Prompt 1
I am building a Hackintosh with an AMD CPU and OpenCore. How do I configure RestrictEvents to patch the CPU brand string so System Information displays the correct processor name?
Prompt 2
My Hackintosh shows persistent notification badges about memory slots and PCI expansion cards. How do I use RestrictEvents boot arguments to suppress these warnings?
Prompt 3
I have a Metal 1-era GPU running macOS Ventura and a background system service keeps crashing. How do I set up RestrictEvents with Lilu to stop this process?
Prompt 4
Show me how to toggle individual RestrictEvents patches on or off using NVRAM variables in my OpenCore config.plist.

Frequently asked questions

What is restrictevents?

A macOS kernel extension that hides hardware warnings and unlocks features on Hackintosh systems, so macOS runs smoothly on non-Apple hardware.

What language is restrictevents written in?

Mainly C++. The stack also includes C++, Lilu, macOS kernel extension.

Is restrictevents actively maintained?

Stale — no commits in 1-2 years (last push 2025-04-03).

What license does restrictevents use?

No license information was provided in the explanation, so usage terms are unknown.

How hard is restrictevents to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is restrictevents for?

Mainly ops devops.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.