Skip to content

About

A native macOS Menu Bar app to control Display Refresh Rates (Hz), Brightness, Night Warmth & Smart Battery Eco Mode with Apple Control Center aesthetics.

Topics

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

4 Commits

Folders and files

Repository files navigation

⚡ DisplayFlow for macOS

The Ultimate Native Menu Bar Controller for Display Refresh Rates (Hz), Brightness, Resolution & Battery Eco Mode.

Release License Swift 6.0 macOS 13+ Stars

A lightweight, 100% free and open-source alternative to BetterDisplay, Lunar, and MonitorControl.
Crafted with native SwiftUI and Apple Control Center aesthetics for seamless performance on Apple Silicon (M1/M2/M3/M4) & Intel Macs.


📥 Download Latest Release • ✨ Features • 🚀 Quick Install • ⌨️ Hotkeys • 📊 Comparison • 🤝 Contributing


💡 Why DisplayFlow?

macOS makes switching display refresh rates and adjusting external monitor brightness tedious. DisplayFlow brings fluid, 1-click controls right into your macOS Menu Bar, designed to look and feel like an official Apple system feature.

Whether you need 120Hz ProMotion / 144Hz for gaming & video editing, 60Hz Eco Mode to extend MacBook battery life, or smooth external monitor brightness & night warmth, DisplayFlow does it with zero bloat and zero background CPU usage.


✨ Features

⚡ Instant Refresh Rate (Hz) Switching

  • Query and switch between all supported display refresh rates (50Hz, 60Hz, 75Hz, 100Hz, 120Hz ProMotion, 144Hz, 240Hz) in 1 click.
  • Native segmented control UI matching macOS Control Center.

☀️ Apple Control Center Brightness Slider

  • Smooth capsule slider with embedded SF Symbol icon and interactive live percentage.
  • Hardware DDC/CI & DisplayServices private API integration for native Apple displays and external screens.
  • Seamless software dimming fallback down to 0% blackout.

🌡️ Night Warmth & Blue-Light Filter (True Tone Alternative)

  • Built-in color temperature slider (Cool White to Warm Amber) for eye protection during late-night coding.

🖥️ Resolution & HiDPI Retina Selector

  • Instant resolution switcher with HiDPI 2x Retina mode detection directly from the menu bar.

🔋 Smart Battery Auto-Eco Switcher

  • On Battery: Automatically drops refresh rate to 60Hz and optimizes brightness to prolong MacBook battery life.
  • On Charger: Instantly restores maximum 120Hz/144Hz ProMotion smoothness when plugged into power.

🚀 Launch at Login

  • Modern macOS 13+ SMAppService background launcher with zero overhead.

⌨️ Global Keyboard Shortcuts (Hotkeys)

  • ⌥ + ⇧ + R : Instant Refresh Rate Toggle (60Hz ⟷ Max Hz)
  • ⌥ + ⇧ + ↑ / ↓ : Brightness Up / Down (±10%)

📊 DisplayFlow vs Alternatives

Feature DisplayFlow ⚡ BetterDisplay MonitorControl QuickShade
Price 100% Free & Open Source Freemium ($19+) Free Free
Refresh Rate Switching (Hz) Yes (1-Click) Yes (Pro) ❌ No ❌ No
Apple Control Center UI Native SwiftUI Custom UI Basic Slider Legacy UI
Smart Battery 60Hz Eco Mode Automated Pro Only ❌ No ❌ No
Color Warmth / Blue Light Filter Included Pro Only ❌ No ❌ No
HiDPI Resolution Selector Included Pro Only ❌ No ❌ No
Apple Silicon M1/M2/M3/M4 Native (Universal) Native Native Native
Telemetry / Tracking Zero / Privacy-First Yes Zero Zero

🚀 Installation

Option 1: Direct Download (Recommended)

  1. Download the latest DisplayFlow.zip from Releases.
  2. Unzip and drag DisplayFlow.app into your /Applications folder.
  3. Launch and enjoy!

Option 2: Build from Source

# Clone the repository
git clone https://github.com/yahiabinzaman/DisplayFlow.git
cd DisplayFlow

# Build and create standalone .app
./build_app.sh

# Open the app
open DisplayControl.app

⌨️ Global Keyboard Shortcuts

Shortcut Action
⌥ Option + ⇧ Shift + R Toggle between 60Hz and Max Refresh Rate (120Hz/144Hz)
⌥ Option + ⇧ Shift + ↑ Increase brightness by 10%
⌥ Option + ⇧ Shift + ↓ Decrease brightness by 10%

🛠️ Tech Stack & Requirements

  • Language: Swift 6.0 + SwiftUI
  • Frameworks: AppKit, CoreGraphics, DisplayServices, IOKit, ServiceManagement
  • OS Requirement: macOS 13.0 (Ventura), macOS 14.0 (Sonoma), macOS 15.0+ (Sequoia)
  • Architecture: Universal Binary (Apple Silicon ARM64 & Intel x86_64)

🤝 Contributing

Contributions, feature suggestions, and pull requests are warmly welcome! Please check out CONTRIBUTING.md to get started.

If you find DisplayFlow useful, please consider giving it a ⭐️ Star on GitHub!


📜 License

Distributed under the MIT License. See LICENSE for more information.


Developed with ❤️ by Yahia Bin Zaman

About

A native macOS Menu Bar app to control Display Refresh Rates (Hz), Brightness, Night Warmth & Smart Battery Eco Mode with Apple Control Center aesthetics.

Topics

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages