Skip to content

Sunshine macOS HDR Experimental v0.2.1

Pre-release
Pre-release

Choose a tag to compare

View all tags
@azarashi11037 azarashi11037 released this 06 Aug 07:22
macos-hdr-v0.2.1
670d019

Sunshine macOS HDR Experimental v0.2.1

Unofficial pre-release / 非官方预发布版 / 非官方預發布版 / 非公式プレリリース
This fork is not affiliated with or endorsed by LizardByte. The macOS
application is ad-hoc signed and is not Apple-notarized.

简体中文

这是 macOS HDR 实验版的修复版本，对应源码提交
670d019f。

相较于 v0.2.0：

  • 修复 BetterDisplay 虚拟显示器休眠后，Sunshine 在首帧等待处卡住、VoidLink/Moonlight 无法连接的问题。
  • 开始捕获前主动唤醒所选显示器，并在捕获对象存续期间阻止显示器再次进入空闲休眠。
  • 同时从活动与在线显示器列表解析稳定 UUID，避免休眠时错误回退到其他显示器。
  • 将首帧等待限制为 5 秒，并安全清理 AVFoundation 回调、输出和信号量，避免进程永久卡死。
  • 保留 v0.2.0 的 P010、BT.2020、PQ、HEVC Main10 HDR、120 FPS、自适应 VideoToolbox 队列、系统音频和稳定显示器 UUID 支持。

实机测试中，BetterDisplay 虚拟显示器休眠后，Sunshine 能主动唤醒显示器并完成 H.264、HEVC 与 HEVC Main10 HDR 探测。实际表现仍会随设备、系统版本、画面复杂度、码率与网络状况变化。

繁體中文

這是 macOS HDR 實驗版的修正版本，對應原始碼提交
670d019f。

相較於 v0.2.0：

  • 修正 BetterDisplay 虛擬顯示器休眠後，Sunshine 卡在首幀等待、VoidLink/Moonlight 無法連線的問題。
  • 擷取開始前主動喚醒所選顯示器，並在擷取物件存續期間防止顯示器再次進入閒置休眠。
  • 同時從使用中與在線顯示器清單解析穩定 UUID，避免休眠時錯誤退回其他顯示器。
  • 將首幀等待限制為 5 秒，並安全清理 AVFoundation 回呼、輸出與信號量，避免處理程序永久卡住。
  • 保留 v0.2.0 的 P010、BT.2020、PQ、HEVC Main10 HDR、120 FPS、適應式 VideoToolbox 佇列、系統音訊及穩定顯示器 UUID 支援。

實機測試中，BetterDisplay 虛擬顯示器休眠後，Sunshine 能主動喚醒顯示器並完成 H.264、HEVC 與 HEVC Main10 HDR 探測。實際表現仍會隨裝置、系統版本、畫面複雜度、碼率及網路狀況變化。

English

This is a bug-fix release of the experimental macOS HDR build, corresponding
to source commit
670d019f.

Changes since v0.2.0:

  • Fixes a launch hang that prevented VoidLink/Moonlight from connecting after a BetterDisplay virtual display went to sleep and stopped delivering a first frame.
  • Wakes the selected display before capture and prevents idle display sleep for the lifetime of the capture object.
  • Resolves stable UUID selectors against both active and online displays so a sleeping display does not fall back to an unrelated output.
  • Bounds the first-frame wait to five seconds and safely detaches AVFoundation callbacks, outputs, and signals instead of hanging the process indefinitely.
  • Retains the v0.2.0 P010, BT.2020, PQ, HEVC Main10 HDR, 120 FPS, adaptive VideoToolbox queue, system-audio, and stable display UUID features.

In live testing, Sunshine woke a sleeping BetterDisplay virtual display and
completed H.264, HEVC, and HEVC Main10 HDR probing. Actual behavior still
depends on hardware, macOS version, scene complexity, bitrate, and network
conditions.

日本語

macOS HDR 実験版の不具合修正版で、ソースコミット
670d019f に対応します。

v0.2.0 からの変更点：

  • BetterDisplay の仮想ディスプレイがスリープした後、Sunshine が最初のフレーム待機で停止し、VoidLink/Moonlight が接続できなくなる問題を修正しました。
  • キャプチャ開始前に選択したディスプレイを起動し、キャプチャオブジェクトの存続中はアイドルスリープを防止します。
  • 安定した UUID をアクティブおよびオンラインの両ディスプレイ一覧から解決し、スリープ中に別の出力へ誤ってフォールバックすることを防ぎます。
  • 最初のフレーム待機を 5 秒に制限し、AVFoundation のコールバック、出力、シグナルを安全に解除して、プロセスの無期限停止を防ぎます。
  • v0.2.0 の P010、BT.2020、PQ、HEVC Main10 HDR、120 FPS、適応型 VideoToolbox キュー、システム音声、安定したディスプレイ UUID の各機能を維持します。

実機テストでは、スリープ中の BetterDisplay 仮想ディスプレイを Sunshine が起動し、H.264、HEVC、HEVC Main10 HDR の検出を完了しました。実際の動作は、ハードウェア、macOS のバージョン、画面の複雑さ、ビットレート、ネットワーク状態によって変動します。

Upstream reference and attribution

The display-wake and display-sleep assertion design is adapted from
LizardByte/Sunshine PR #5291
and upstream commit
c9863ebe,
authored by martona. This fork ports that approach
to its older experimental HDR branch and adds stable online UUID resolution,
a bounded first-frame timeout, and AVFoundation teardown handling. Thanks to
martona and all Sunshine contributors.

Validation

  • GitHub Actions release build and filtered unit-test suite passed.
  • The generated application is ad-hoc signed, Apple Silicon (arm64) only,
    and targets macOS 15.0+.
  • DMG SHA-256:
    9c3a4e6d2e9a17220a436f2724258ee31baafea873495906045d8edb1a52275b.
  • No Sunshine account, password, pairing data, log, display UUID, or local
    configuration is included in the release artifact.

Artifacts, source, and license

  • Binary: Sunshine-macOS-HDR-v0.2.1-arm64-adhoc.dmg
  • Checksum: Sunshine-macOS-HDR-v0.2.1-arm64-adhoc.dmg.sha256
  • Corresponding source: tag macos-hdr-v0.2.1 at commit 670d019f
  • License: GPL-3.0-only
  • Notices included in the app bundle: LICENSE, NOTICE, FORK_NOTICE.md

The build is not Apple-notarized. Use System Settings → Privacy & Security →
Open Anyway only if you trust this repository. Report fork-specific issues
here rather than to the upstream project.

Assets 4
Loading