Releases: qiin2333/Sunshine-Foundation
v2025.623.40319.杂鱼
What's Changed
- Fix: 设置密码后跳转首页 by @Yundi339 in #91
- build(deps): update by @qiin2333 in #96
- Fix: 增加最小帧率系数范围1-30 by @Yundi339 in #98
- Dev by @qiin2333 in #99
- fix: 修复写入vdd_setting时产生空行 by @Qian23333 in #100
- fix: build and packaging by @qiin2333 in #107
- fix: gh action build by @qiin2333 in #108
- fix: implement async encode by @Yundi339 in #114
- fix: RDP mode caused the revert-setting-warning-log flood by @Yundi339 in #115
- fix: CI build failed because upnp 'size_t' not be declared by @Yundi339 in #119
Full Changelog: v2025.0516...v2025.623.40319
Contributors
v2025.620.164515.杂鱼
What's Changed
- Fix: 设置密码后跳转首页 by @Yundi339 in #91
- build(deps): update by @qiin2333 in #96
- Fix: 增加最小帧率系数范围1-30 by @Yundi339 in #98
- Dev by @qiin2333 in #99
- fix: 修复写入vdd_setting时产生空行 by @Qian23333 in #100
- fix: build and packaging by @qiin2333 in #107
- fix: gh action build by @qiin2333 in #108
- fix: implement async encode by @Yundi339 in #114
- fix: RDP mode caused the revert-setting-warning-log flood by @Yundi339 in #115
- fix: CI build failed because upnp 'size_t' not be declared by @Yundi339 in #119
Full Changelog: v2025.0516...v2025.620.164515
Contributors
v2025.520
What's Changed
- 优化：开启“就是要用虚拟显示器~”选项后，将强制启用游戏优化设置，以避免因客户端未正确配置，导致串流失败
- 优化：恢复 Sunshine 用户注册流程（一直都有的功能），强制要求设置用户名与密码，保证远程访问的安全性
- 修复：Sunshine520.exe 版本修复了设置密码成功以后不会跳转的问题~~
Warning
注册流程说明
1. 打开 Sunshine 设置界面： 任务栏图标右键“Open Sunshine”打开界面（若界面画面有问题，Ctrl+R刷新 / 重新点击“Open Sunshine” / 重启Sunshine 进行恢复）
2. 首次设置用户与密码： 仅需设置一次用户密码，若显示“欢迎使用Sunshine”内容，说明 Sunshine 未设置过用户密码，设置后点击登录完成注册（点击登录后，画面不会跳转，重新点击登录后报错请无视）
3. 设置完成后重新进入界面： 请返回第 1 步，再次点击 “Open Sunshine” 进入设置页面。
4. 忘记密码如何处理：退出 Sunshine 程序，删除配置文件"C:\Program Files\Sunshine\config\sunshine_state.json"（删除后将清除所有 PIN 码连接记录，请谨慎操作)，通过Win开始菜单重新启动 Sunshine，将自动跳转至注册页面。
5. 关于账户信息的安全性说明： Sunshine 的用户名与密码仅保存在本地，不会上传至任何服务器，确保用户隐私安全。密码保护功能为官方内置机制，现根据用户反馈重新启用，以加强局域网和公网的访问控制。
Note
如何设置虚拟显示器/息屏显示，新手首次操作顺序：
1：确保 Sunshine 安装在C盘，确保 Sunshine 目录在安全卫士白名单中
2：确保虚拟显示器存活： Windows-设备管理器-显示适配器-Zako Display Adapter，保持激活启用状态
3：激活虚拟显示器： Windows-任务栏托盘-Sunshine，右键点击VDD Monitor Toggle
若黑屏则执行系统快捷键
Ctrl Shift Win B（记得确保键盘能正常使用的，没有锁WIN等问题）
4：设置虚拟屏拓展： Windows-桌面右键-显示，选中主显示器，设置“拓展这些显示器”（如果只需要息屏功能，设置为“拓展”或“仅1”均可）
5：触发显示器记忆保存： 打开Sunshine-故障排除，点击“重置记忆显示设备组合态”
6：关闭虚拟显示器： Windows-任务栏托盘-Sunshine，右键点击VDD Monitor Toggle，将会关闭虚拟显示器
7：设置Sunshine基础配置： Sunshine-配置/Setting-Audio/Video
- 适配器名称： 选择对应的GPU（如果能够正常串流，请无视首页的GPU报错提醒）
- 输出显示器指定： 选择“就是要用虚拟显示器~”
- 串流时显示器组合状态设定： 选择“禁用其他显示器，只启用指定显示器”，不能选无操作
- 点击最下方“保存”并“应用”
8：如何串流： 使用Moonlight串流主机，如何远程参考程序内的文档介绍~
9：无需在主机上新增分辨率和帧率！！！ 只要前面设置正确，虚拟显示器会自动改为Moonlight中选择的分辨率
Warning
异常处理1：升级后或者串流退出后物理屏黑屏
解决办法：系统快捷键Ctrl+Shift+Win+B（确保键盘能用，以及没有锁win），物理屏亮起之后 进入sunshine故障排除重置记忆。
如果无法解决，大概率是核显被你禁用了，而非软件问题。参考案例：
Example1. 为了息屏串流需要把核显禁用了，导致物理屏不显示
Example2. 笔记本bios改成独显直连（原先是混合显示），导致物理屏也灭了
异常处理2：升级后串流无法使用虚拟显示器(Sunshine配置均正确)
解决办法：下载 VirtualDisplayDriver0407.zip，解压到 C:\VirtualDisplayDriver
Full Changelog: v2025.0422...v2025.0516
v2025.0422
What's Changed
- 优化新版Zako虚拟显示器显示策略
- 修复Sunshine配置无法保存问题
- 新增Zako虚拟显示器支持色彩格式设置
- 优化退出串流后的音频恢复策略
- 新增快捷键 CTRL+SHIFT+ALT+V 切换VDD
- 新增开发者接口 Moonlight客户端“串流时显示器组合状态设定”（需要Moonlight客户端适配）
Note
新手首次操作顺序：
步骤1：Windows-设备管理器-显示适配器-Zako Display Adapter，保持激活启用状态
操作2：Windows-任务栏托盘-Sunshine，右键点击VDD Monitor Toggle，若黑屏则执行Ctrl+Shift+Win+B（记得确保键盘能正常使用的，没有锁WIN等问题）
操作3：Windows-桌面右键-显示，选中主显示器，设置“拓展这些显示器”（如果只需要息屏功能，设置为“拓展”或“仅1”均可）
操作4：Sunshine-配置/Setting-Audio/Video
-
- 适配器名称，选择对应的GPU（如果能够正常串流，请无视首页的GPU报错提醒）
-
- 输出显示器指定，选择“就是要用虚拟显示器~”
-
- 串流时显示器组合状态设定，选择“禁用其他显示器，只启用指定显示器”
-
- 点击最下方“保存”并“应用”
操作5：Sunshine-故障排除，点击“重置记忆显示设备组合态”
操作6：Windows-任务栏托盘-Sunshine，右键点击VDD Monitor Toggle，将会关闭虚拟显示器
操作7：使用Moonlight串流主机，如何远程参考程序内的文档介绍~
Full Changelog: v2025.0221...v2025.0422
MD5 bcef0e1a388920c04cce1556ed03537b
v2025.0230
What's Changed
- 虚拟显示器加固，在原vdd基础上增加了显示器创建/销毁能力，以及EDID信息优化。
- 修复新版Zako虚拟显示器状态修改失败导致锁屏黑屏问题。
- 托盘菜单增加控制虚拟显示器开关
- 增加虚拟显示器设置面板
- feat(confighttp):add api 'boom' and 'restart' using 'GET' method by @Yundi339 in #41
- 添加复制配置按钮
- 除本机外访问WEBUI需要登录
- 修复应用封面下载 fix(http): lower TLS to v1.2 for downloading covers
Note
升级建议：在设备管理器中卸载原 VDD(Virtual Display with HDR)，并彻底删除 ”C:\VirtualDisplayDriver”；不同版本的 sunshine 使用的VDD名称和虚拟显示器配置的文件夹不同，请自行区分！
新虚拟显示器手动操作部分：
操作1：安装后设备管理器会新增虚拟显示器(Zako xxxx)，请手动启用后保持一直开启状态！任务栏托盘Sunshine图标，右键手动开启VDD Monitor Toggle的选项，在桌面右键显示重新设置“拓展”（如果只需要息屏功能，设置为“拓展”或“仅1”均可，建议“拓展”）。
操作2：点击”Sunhine-故障排除-重置记忆显示设备组合态“，接着如果不需要常驻虚拟显示器，任务栏托盘Sunshine图标，右键点击关闭VDD Monitor Toggle的选项。
操作3：”常驻虚拟屏幕“模式：原 ”指定虚拟显示器(VDD by MTT) “在升级后需要手动指定为新的虚拟显示器(Zako HDR)。手动开启需要在托盘的VDD控制面板自行添加分辨率创建。
操作4： 非“常驻虚拟屏幕”模式：“就是要用虚拟显示器”选项保持不变。（新版本默认情况，只有在串流时才会创建显示器，一定程度降低虚拟显示器异常启动导致的黑屏概率。）（该模式为大部分用户场景，不懂设置优先考虑这个模式）
操作5："串流时显示器组合状态设定"根据自己的选择对应的选项，该功能在旧版本中已经存在，请自行摸索，串流虚拟显示器不要选择“无操作”。
异常说明1：升级后物理显示器如有问题，先尝试点击”Sunhine-故障排除-重置记忆显示设备组合态“。
异常说明2：切换息屏和副屏模式异常，切换“自动激活”还是原来的息屏模式，其实自动激活不代表副屏，只是激活对应显示器，默认使用禁用前的屏幕组合。
解决方法：退出串流，手动开启“常驻虚拟显示器”，手动桌面右键选择“显示”，选中把虚拟屏幕改为“拓展”，再点击sunshine的“重置记忆”，关闭虚拟屏幕，这时候自动激活就会变成上次禁用虚拟显示前的状态，也就是期望的副屏模式。
异常说明3：如果手动激活虚拟显示器后，黑屏了，尝试系统快捷键重启显卡驱动Ctrl+Shift+Win+B（记得确保键盘能正常使用的，没有锁WIN等问题）
New Contributors
Full Changelog: v2024.1227...v2025.0221
MD5 48AD5E75202129A9B3E50DEFCE3C1FCD
Contributors
Assets 3
v2025.0212
What's Changed
- 虚拟显示器加固，在原vdd基础上增加了显示器创建/销毁能力，以及EDID信息优化。
- 托盘菜单增加控制虚拟显示器开关
- feat(confighttp):add api 'boom' and 'restart' using 'GET' method by @Yundi339 in #41
- 添加复制配置按钮
- 除本机外访问WEBUI需要登录
- Control Panel (GUI) 升级
Note
升级建议：在设备管理器中卸载原 VDD(Virtual Display with HDR)，并彻底删除 ”C:\VirtualDisplayDriver”；不同版本的 sunshine 使用的VDD名称和虚拟显示器配置的文件夹不同，请自行区分！
操作变更1：新版本 Sunshine 携带的虚拟显示器，默认情况仅在串流时才会创建显示器，一定程度降低虚拟显示器异常启动导致的黑屏概率。
操作变更2：安装后设备管理器会新增虚拟显示器(Zako HDR)，请手动启用后保持一直开启状态！升级后物理显示器如有问题，先尝试点击”Sunhine-故障排除-重置记忆显示设备组合态“。
操作变更3：配置"输出显示器指定"， ”指定虚拟显示器(VDD by MTT) “在升级后需要重新设置为新的虚拟显示器(Zako HDR)，需在托盘菜单中手动启用后可见。
New Contributors
Full Changelog: v2024.1227...ZakoVDD
Contributors
Assets 3
5090
Contributors
Assets 3
v2024.1227
Full Changelog: v2024.1111...v2024.1227
- 更新虚拟显示器到 24.12.24
Note
升级前建议先卸载原vdd
- 修复 关闭“游戏优化” 可能造成虚拟显示器崩溃的问题
- 修复 windows 11 24H2 HDR配置文件可能切换不生效的问题
- fix(nvenc): Enable opt-in client refresh by client (#3415)
- update FFmpeg to release/7.1
v2024.1111
Full Changelog: v2024.1025...v2024.1111
- 配对中自动导入客户端个性名， 并加入指令环境变量，可解锁针对不同客户端的特定操作命令。
- HDR 校准配置文件与客户端关联，并在串流中自动应用。
日月（sm) 串流独家功能 HDR 得到重磅更新：动辄几千尼特上限的串流终端屏幕，比如手机和TV，在串流时也可以用上匹配的亮度曲线与色调映射，前提是该设备使用了 Windows HDR 校准 软件生成了正确的配置，并手动在pin页面与设备关联。
- 内核升级到 v2024.1109.210203， 修复已知bug。
v2024.1025
Full Changelog: v2024.1015...v2024.1025
- feat(stream)!: remove limit on concurrent sessions and allow quitting apps with active
- 升级GUI内核，GUI 内下载资源调用外部浏览器