Skip to content

Releases: oabdrabo/DisplayDisabler

DisplayDisabler v1.0.0 - Initial Release

08 Oct 02:15

Choose a tag to compare

🎉 First Stable Release

DisplayDisabler - Lightweight alternative to BetterDisplay for disabling MacBook built-in displays.

Features

  • 51KB binary vs 30MB BetterDisplay app (99.8% smaller)
  • Open source - Full Objective-C source code included
  • No dependencies - Standalone tool
  • Auto-disable on login - Via LaunchAgent
  • Same functionality - Uses identical CoreGraphics API
  • Complete documentation - Technical deep dive included

What's Included

  • display_disable - Compiled binary (51KB)
  • display_disable.m - Full source code
  • auto_disable_builtin.sh - Auto-disable script
  • install.sh - One-command installer
  • Complete documentation (README, INSTALL, TECHNICAL_DEEP_DIVE)

Quick Start

# Download and extract
# Run installer
./install.sh

Requirements

  • macOS 11+ (Big Sur or later)
  • Apple Silicon (M1/M2/M3) or Intel Mac

Perfect For

  • Headless MacBook setups
  • Broken/damaged internal displays
  • Minimalist configurations
  • Users who only need display disable feature

How It Works

Uses the same private CoreGraphics API as BetterDisplay:

CGSConfigureDisplayEnabled(config, displayID, false);

See TECHNICAL_DEEP_DIVE.md for complete reverse engineering analysis.


Tested on: M3 MacBook Air, macOS 15.2
License: MIT