Sunshine macOS HDR Experimental v0.2.1

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.

Sunshine macOS HDR Experimental v0.2.0

Sunshine macOS HDR Experimental v0.2.0

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 实验版的第二个预发布版本，对应源码提交
132a7286。

相较于 v0.1.0：

• 改进 VideoToolbox HDR 并行编码和背压处理，避免编码压力阻塞采集循环；实测动态画面可接近 120 FPS。
• 将固定四帧上限改为有界的低延迟自适应队列；120 FPS 会话从两帧起步，并可按负载在 2–8 帧之间调整。
• 同步 ScreenCaptureKit 停止与会话清理流程，修复客户端断开后可能出现的退出卡死。
• 恢复鼠标移动事件批处理，改善快速移动指针时的短暂停顿。
• 保留 P010、BT.2020、PQ、HEVC Main10 HDR、系统音频捕获和稳定显示器 UUID 支持。

本版本已在 M2 Pro、macOS 27.0 beta、2732×2048、120 Hz、HEVC Main10 HDR 环境进行实机验证。实际帧率、延迟和队列深度仍会随设备、画面复杂度、码率与网络状况变化。

发布包仅支持 Apple Silicon (arm64)，部署目标为 macOS 15.0+。此版本未经 Apple 公证；仅应在你信任本仓库时通过“系统设置 → 隐私与安全性 → 仍要打开”。本 fork 的问题请报告至本仓库，不要提交给上游项目。

繁體中文

這是 macOS HDR 實驗版的第二個預發布版本，對應原始碼提交
132a7286。

相較於 v0.1.0：

• 改善 VideoToolbox HDR 平行編碼與背壓處理，避免編碼壓力阻塞擷取迴圈；實測動態畫面可接近 120 FPS。
• 將固定四幀上限改為有界的低延遲自適應佇列；120 FPS 工作階段從兩幀起步，並可依負載在 2–8 幀之間調整。
• 同步 ScreenCaptureKit 停止與工作階段清理流程，修正用戶端中斷後可能發生的結束卡死。
• 恢復滑鼠移動事件批次處理，改善快速移動游標時的短暫停頓。
• 保留 P010、BT.2020、PQ、HEVC Main10 HDR、系統音訊擷取及穩定顯示器 UUID 支援。

本版本已於 M2 Pro、macOS 27.0 beta、2732×2048、120 Hz、HEVC Main10 HDR 環境進行實機驗證。實際幀率、延遲與佇列深度仍會隨裝置、畫面複雜度、碼率及網路狀況而變化。

發布套件僅支援 Apple Silicon (arm64)，部署目標為 macOS 15.0+。此版本未經 Apple 公證；僅應在你信任本倉庫時透過「系統設定 → 隱私權與安全性 → 仍要打開」。本 fork 的問題請回報至本倉庫，請勿提交至上游專案。

English

This is the second experimental macOS HDR pre-release and corresponds to source
commit 132a7286.

Changes since v0.1.0:

• Improves parallel VideoToolbox HDR encoding and backpressure handling so encoder pressure does not block the capture loop; motion-heavy testing can approach 120 FPS.
• Replaces the fixed four-frame ceiling with a bounded, latency-oriented adaptive queue. A 120 FPS session starts at two frames and can adjust within 2–8 frames under load.
• Synchronizes ScreenCaptureKit shutdown and session cleanup to fix a possible hang after client disconnection.
• Restores mouse-motion event batching to reduce brief stalls during fast pointer movement.
• Retains P010, BT.2020, PQ, HEVC Main10 HDR, macOS system-audio capture, and stable display UUID selection.

This build has been tested on an M2 Pro running macOS 27.0 beta at 2732×2048,
120 Hz, using HEVC Main10 HDR. Actual frame rate, latency, and queue depth vary
with hardware, scene complexity, bitrate, and network conditions.

The distributed build is Apple Silicon (arm64) only and targets macOS 15.0+.
It is ad-hoc signed and 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.

日本語

macOS HDR 実験版の第 2 回プレリリースで、ソースコミット
132a7286 に対応します。

v0.1.0 からの変更点：

• VideoToolbox HDR の並列エンコードとバックプレッシャー処理を改善し、エンコーダー負荷がキャプチャループを停止させないようにしました。動きの多い実機テストでは 120 FPS 近くに到達します。
• 固定 4 フレーム上限を、遅延を重視した有界の適応キューへ変更しました。120 FPS セッションは 2 フレームから開始し、負荷に応じて 2～8 フレームの範囲で調整されます。
• ScreenCaptureKit の停止処理とセッションのクリーンアップを同期し、クライアント切断後に終了が停止する場合がある問題を修正しました。
• マウス移動イベントのバッチ処理を復元し、ポインターを高速移動した際の一時的な引っ掛かりを軽減しました。
• P010、BT.2020、PQ、HEVC Main10 HDR、macOS システム音声キャプチャ、および安定したディスプレイ UUID 選択を引き続きサポートします。

本ビルドは M2 Pro、macOS 27.0 beta、2732×2048、120 Hz、HEVC Main10 HDR の環境で実機検証済みです。実際のフレームレート、遅延、キュー深度は、ハードウェア、画面の複雑さ、ビットレート、ネットワーク状態によって変動します。

配布ビルドは Apple Silicon (arm64) 専用で、macOS 15.0 以降を対象とします。アドホック署名のみで、Apple の公証は受けていません。本リポジトリを信頼できる場合に限り、「システム設定 → プライバシーとセキュリティ → このまま開く」を使用してください。本 fork 固有の問題は上流ではなく本リポジトリへ報告してください。

Artifacts, source, and license

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

No Sunshine account, password, pairing data, log, display UUID, or local
configuration is included in the release artifact.

Sunshine macOS HDR Experimental v0.1.0

Sunshine macOS HDR Experimental v0.1.0

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.

简体中文

这是基于 Sunshine v2026.516.143833 的首个 macOS HDR 实验预发布版。

• 新增 ScreenCaptureKit P010、BT.2020、PQ HDR 采集和 HEVC Main10 编码。
• 修复 VideoToolbox 串行编码造成的约 60–68 FPS 限制，并以四帧上限约束异步队列。
• 支持稳定显示器 UUID，避免 BetterDisplay 重连后数字 ID 改变。
• 回移上游 #5186，补充本地网络用途说明以改善 Bonjour 注册。
• 发行包仅支持 Apple Silicon (arm64)，部署目标为 macOS 15.0+。
• 当前仅在 M2 Pro、macOS 27.0 beta、2732×2048、120 Hz 环境完成实测。

请下载 DMG 与对应的 .sha256 文件，先验证校验值，再安装。此版本未经 Apple 公证；只应在你信任本仓库时通过“系统设置 → 隐私与安全性 → 仍要打开”。问题请提交到本 fork，不要提交给上游。

繁體中文

這是基於 Sunshine v2026.516.143833 的首個 macOS HDR 實驗預發布版。

• 新增 ScreenCaptureKit P010、BT.2020、PQ HDR 擷取及 HEVC Main10 編碼。
• 修正 VideoToolbox 串行編碼造成的約 60–68 FPS 限制，並以四幀上限限制非同步佇列。
• 支援穩定顯示器 UUID，避免 BetterDisplay 重新連線後數字 ID 改變。
• 回移上游 #5186，補上本機網路用途說明以改善 Bonjour 註冊。
• 發布包僅支援 Apple Silicon (arm64)，部署目標為 macOS 15.0+。
• 目前僅於 M2 Pro、macOS 27.0 beta、2732×2048、120 Hz 環境完成實測。

請下載 DMG 與對應的 .sha256 檔案，先驗證校驗值，再安裝。此版本未經 Apple 公證；僅應在你信任本倉庫時透過「系統設定 → 隱私權與安全性 → 仍要打開」。問題請提交至本 fork，請勿提交至上游。

English

This is the first experimental macOS HDR pre-release based on Sunshine
v2026.516.143833.

• Adds ScreenCaptureKit P010, BT.2020, PQ HDR capture and HEVC Main10 encoding.
• Removes the roughly 60–68 FPS serialization bottleneck in VideoToolbox and bounds its asynchronous queue to four frames.
• Adds stable display UUID selection for BetterDisplay reconnects that change numeric IDs.
• Backports upstream #5186, adding the Local Network usage description needed for Bonjour registration.
• The distributed build is Apple Silicon (arm64) only and targets macOS 15.0+.
• Live testing is limited to an M2 Pro on macOS 27.0 beta at 2732×2048, 120 Hz.

Download both the DMG and its .sha256 file, then verify the checksum before installation. This build is not Apple-notarized; use System Settings → Privacy & Security → Open Anyway only if you trust this repository. Report fork-specific issues here, not upstream.

日本語

Sunshine v2026.516.143833 を基にした、初回の macOS HDR 実験的プレリリースです。

• ScreenCaptureKit による P010・BT.2020・PQ の HDR キャプチャと HEVC Main10 エンコードを追加しました。
• VideoToolbox の直列化による約 60–68 FPS の制限を解消し、非同期キューを最大 4 フレームに制限しました。
• BetterDisplay の再接続で数値 ID が変わる場合に備え、安定したディスプレイ UUID 選択を追加しました。
• Bonjour 登録に必要なローカルネットワーク用途説明を追加する上流 #5186 をバックポートしました。
• 配布ビルドは Apple Silicon (arm64) 専用で、macOS 15.0 以降を対象とします。
• 実機テストは M2 Pro、macOS 27.0 beta、2732×2048、120 Hz の環境に限られます。

DMG と対応する .sha256 を両方ダウンロードし、インストール前にチェックサムを確認してください。このビルドは Apple の公証を受けていません。本リポジトリを信頼できる場合に限り、「システム設定 → プライバシーとセキュリティ → このまま開く」を使用してください。本フォーク固有の問題は上流ではなく本リポジトリへ報告してください。

Artifacts, source, and license

• Binary: Sunshine-macOS-HDR-v0.1.0-arm64-adhoc.dmg
• Checksum: Sunshine-macOS-HDR-v0.1.0-arm64-adhoc.dmg.sha256
• Corresponding source: tag macos-hdr-v0.1.0, including pinned submodule revisions
• License: GPL-3.0-only
• Notices included in the app bundle: LICENSE, NOTICE, FORK_NOTICE.md

No Sunshine account, password, pairing data, log, display UUID, or local
configuration is included in the release artifact.