Skip to content

Repository files navigation

HiFrame app icon

HiFrame

A high-refresh-rate assistant for ProMotion MacBooks, aiming to reduce visible flicker in low-brightness gray scenes.

English · 简体中文

⬇ Download HiFrame for macOS
Apple Silicon · macOS 13+ · ZIP download
Release notes and checksums · Previous versions

macOS 13+ Preview

HiFrame is a small macOS menu bar utility for MacBook Pro displays with ProMotion. It continuously presents a nearly invisible 1 × 1-point Metal surface, requesting a 60 or 120 fps presentation cadence during otherwise static content.

This may reduce the visible flicker and discomfort that some users notice in dark gray areas at low brightness.

The interface supports Follow System, English, and Simplified Chinese language options directly from the menu bar. The preview download is ad-hoc signed and not notarized, so macOS may require approval in System Settings → Privacy & Security on first launch.

Important

HiFrame requests a presentation cadence. It does not change the macOS display mode, measure the panel's physical refresh rate, or guarantee a 120 Hz lock. Results vary by Mac, macOS version, content, power state, and viewer.

Install

  1. Download the ZIP using the button above and unzip it.
  2. Move HiFrame.app to Applications, then open it. HiFrame appears in the menu bar.
  3. When upgrading from SteadyFrame, quit the old app before opening HiFrame.

Highlights

  • Request a 60 or 120 fps cadence while keeping ProMotion enabled.
  • Run continuously or only when connected to external power.
  • Stop automatically below a configurable battery level.
  • Target the built-in display or all connected displays.
  • Use a fixed, tiny 8/255 frame-to-frame luminance delta.
  • Place the signal at the lower-left, lower-right, or center of the screen.
  • Switch between Follow System, English, and Simplified Chinese from the menu bar.
  • Choose Report an Issue… to open GitHub’s new-issue page in your browser.
  • Toggle instantly with ⌃⌥⌘H and copy runtime diagnostics from the menu bar.

Requirements

  • macOS 13 or later
  • A MacBook Pro with ProMotion for the intended use case
  • A Swift 5.10-compatible toolchain and macOS SDK when building from source

Build from source

To build the app yourself:

swift test
./scripts/build-app.sh
open dist/HiFrame.app

HiFrame runs only in the menu bar. On first launch it is enabled at 120 fps, targets the built-in display, places the signal at the center, and runs only on external power with a 20% low-battery cutoff.

About

Steady high-refresh presentation for ProMotion MacBook Pro / 稳定 ProMotion MacBook Pro 的高刷新呈现节奏

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages