Skip to content

v1.0.0

Latest
Latest

Choose a tag to compare

View all tags
@github-actions github-actions released this 05 Aug 07:36
v1.0.0
e383b7e
This commit was signed with the committer’s verified signature.
totocaster Toto Tvalavadze
SSH Key Fingerprint: ZjnjbZg6djJImA4Ua29nWyvVlq0kUj8U+GLVZIq1mjk
Verified
Learn about vigilant mode.

Refmode 1.0.0 is the first public release of a focused, scriptable CLI for discovering and switching Apple display reference modes.

Highlights

  • Discover every online display, its capability, and its active reference preset when readable.
  • List factory and custom reference modes without relying on hardcoded preset names or indices.
  • Switch by exact name or stable preset ID with idempotent no-op handling and positive read-back verification.
  • Target displays safely with stable UUID selectors, ambiguity checks, mirror rejection, and topology-race detection.
  • Integrate with Stream Deck and other automation through quiet mode, stable exit statuses, and versioned JSON output.
  • Install an Apple Silicon build for macOS 13 or later through the Homebrew tap or the checksummed release archive.

Install

brew tap totocaster/tap
brew install totocaster/tap/refmode
REFMODE_PATH="$(command -v refmode)"
"${REFMODE_PATH}" --version

For GUI automation tools, use the absolute path printed by command -v refmode (normally /opt/homebrew/bin/refmode for the supported Apple Silicon installation).

Artifact

Platform Archive SHA-256
macOS 13+, Apple Silicon refmode-1.0.0-aarch64-apple-darwin.tar.gz d6ce2cd0cdf3a939238fe6b3a01808a3e18ce8a5d7f94a429488a1d33dabd1f7

This archive is unsigned and has not been notarized. Review the checksum and repository source before running it.

Refmode is distributed under the MIT License. The complete license text is included in the archive.

Compatibility and private API notice

Refmode dynamically loads undocumented private CoreDisplay functions. Apple can change or remove this interface in any macOS update. Refmode checks capabilities and symbols at runtime and fails safely when they are unavailable, but it is not suitable for Mac App Store distribution.

This initial archive is ARM64-only. CI cross-compiles x86_64 to detect source and ABI declaration problems, but Intel distribution is intentionally withheld until the private CoreDisplay ABI and list/set/verify/reset behavior have been exercised on physical Intel hardware. ARM64 availability is also not a claim that every macOS release, display model, or topology has been physically tested. Initial support remains capability-based and the hardware compatibility matrix is intentionally limited; run refmode doctor before relying on mutation in automation.

The release-qualified hardware row covers list, current, set with positive read-back, factory-default reset, idempotence, and verified restoration on the documented ARM64 built-in Liquid Retina XDR configuration. External, mirrored, custom-preset, two-display, disconnect/sleep, real Stream Deck, and physical Intel configurations remain outside the current qualification matrix.

Reference modes affect color and luminance behavior. Select a preset appropriate for the intended content and viewing environment. Refmode switches Apple display presets; it does not assign ColorSync ICC profiles.

Changelog

Features

  • Implement Refmode CLI and distribution (d0a8de6)

Maintenance

  • Update checkout action to v7 (bbe82d0)

Other changes

  • Record v1.0.0 hardware qualification (e383b7e)
  • Polish generated notes (65880aa)

Full changelog: https://github.com/totocaster/refmode/commits/v1.0.0

Assets 4
Loading