build(windows): add arm64 initial support #3905

rbqvq · 2025-05-25T08:30:17Z

Description

This PR adds an arm64 build for Windows.

Todo:

Cross compile build-deps for arm
Some dependencies not available in clang-aarch64 environment
- NSIS not available for ARM64... How to create installer? Sunshine: change windows installer to WiX roadmap#76
- MinHook does not support ARM64... excluded this library and disabled code that used it
- Boost issues (See commits)

Type of Change

Bug fix (non-breaking change which fixes an issue)
New feature (non-breaking change which adds functionality)
Breaking change (fix or feature that would cause existing functionality to not work as expected)
Dependency update (updates to dependencies)
Documentation update (changes to documentation)
Repository update (changes to repository files, e.g. .github/...)

Checklist

My code follows the style guidelines of this project
I have performed a self-review of my own code
I have commented my code, particularly in hard-to-understand areas
I have added or updated the in code docstring/documentation-blocks for new or existing methods/components

Question

Should we need disable all x86 hardware accel (nvenc, intel quicksync and amdvce) on windows arm64 build?

rbqvq · 2025-05-25T08:31:02Z

Known Issues

It crashed after moonlight connect

[2025-05-25 12:58:21.029]: Info: [libx264 @ 0000024346e9af20] kb/s:629.76
[2025-05-25 12:58:21.059]: Info:
Device Description : Qualcomm(R) Adreno(TM) 8cx Gen 3
Device Vendor ID   : 0x4D4F4351
Device Device ID   : 0x36333630
Device Video Mem   : 0 MiB
Device Sys Mem     : 1 MiB
Share Sys Mem      : 16081 MiB
Feature Level      : 0x0000B100
Capture size       : 2560x1440
Offset             : 0x0
Virtual Desktop    : 2560x1440
[2025-05-25 12:58:21.059]: Info: Active GPU has HAGS disabled
[2025-05-25 12:58:21.059]: Info: Using realtime GPU priority
[2025-05-25 12:58:21.059]: Info:
Colorspace         : DXGI_COLOR_SPACE_RGB_FULL_G22_NONE_P709
Bits Per Color     : 8
Red Primary        : [0.673828,0.317383]
Green Primary      : [0.280273,0.660156]
Blue Primary       : [0.142578,0.0449219]
White Point        : [0.313477,0.329102]
Min Luminance      : 0.0745 nits
Max Luminance      : 445.761 nits
Max Full Luminance : 445.761 nits
[2025-05-25 12:58:21.059]: Info: Desktop resolution [2560x1440]
[2025-05-25 12:58:21.060]: Info: Desktop format [DXGI_FORMAT_B8G8R8A8_UNORM]
[2025-05-25 12:58:21.060]: Info: Display refresh rate [119.987Hz]
[2025-05-25 12:58:21.060]: Info: Requested frame rate [60fps]
[2025-05-25 12:58:21.065]: Info:
[2025-05-25 12:58:21.065]: Info: // Ignore any errors mentioned above, they are not relevant. //
[2025-05-25 12:58:21.065]: Info:
[2025-05-25 12:58:21.065]: Info: Found H.264 encoder: libx264 [software]
[2025-05-25 12:58:21.065]: Info: Executing [Desktop]
[2025-05-25 12:58:21.182]: Info: New streaming session started [active sessions: 1]
libc++abi: terminating due to uncaught exception of type boost::wrapexcept<std::out_of_range>: config out of range

docs/getting_started.md

ReenigneArcher · 2025-05-25T14:18:53Z

src/config.cpp

The changes in this file don't make sense.

clangarm64 not support std
must use ::std

its necessary for clangarm64

What about the other hundreds of files?

There is no problem.

After changing this file, clangarm64 works correctly

I think it only happend in config::amd namespace, might it same error on x86?
Can u check it on Clang64?

that's a great resolution

the problem is actually caused by ln 115-117 in config.cpp. it imports headers in namespace amd, and the headers include std headers, which makes std redefine in namespace amd:

Sunshine/src/config.cpp

Lines 115 to 117 in a3ee774

#include <AMF/components/VideoEncoderAV1.h>

#include <AMF/components/VideoEncoderHEVC.h>

#include <AMF/components/VideoEncoderVCE.h>

src/platform/windows/audio.cpp

docs/building.md

cmake/dependencies/windows.cmake

.github/workflows/CI.yml

docs/getting_started.md

rbqvq · 2025-06-02T08:09:44Z

Can we use this hardware encode? 🤔
obsproject/obs-studio#11993

ReenigneArcher · 2025-06-02T12:52:36Z

I think MF encoder is already included with the FFmpeg build, so why not?

rbqvq · 2025-06-02T15:43:02Z

I think MF encoder is already included with the FFmpeg build, so why not?

Well, I didn't read the source code of sunshine.
This part is up to you. 🤪

ReenigneArcher · 2025-07-02T01:13:55Z

ci has been refactored a bit, the windows build is now in a separate workflow. It's already setup for a matrix build so should be easy to adapt your changes.

sonarqubecloud · 2025-07-22T19:44:37Z

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

LizardByte-bot · 2025-10-21T10:20:06Z

It looks like this PR has been idle for 90 days. If it's still something you're working on or would like to pursue, please leave a comment or update your branch. Otherwise, we'll be closing this PR in 10 days to reduce our backlog. Thanks!

rbqvq · 2025-10-21T12:10:19Z

:(

ReenigneArcher · 2025-10-21T13:17:44Z

Boost issues

Likely fixed by #4253 but waiting on https://gitlab.com/eidheim/Simple-Web-Server/-/merge_requests/283

OR #4132 but isn't working yet

NSIS not available for ARM64... How to create installer?

#3916 in process, but needs some adjustments. The scripts don't actually run during install.

LizardByte-bot · 2026-01-20T10:26:19Z

It looks like this PR has been idle for 90 days. If it's still something you're working on or would like to pursue, please leave a comment or update your branch. Otherwise, we'll be closing this PR in 10 days to reduce our backlog. Thanks!

rbqvq · 2026-01-20T10:33:21Z

PONG :)

I will pull some changes from #4521 later and rebase to master

Close LizardByte#3905

rbqvq · 2026-01-20T19:35:12Z

Builds failed with

✗ Build failed in 258ms
error during build:
parseAsync is not a function
    at Module.setSource (file:///C:/a/Sunshine/Sunshine/node_modules/rollup/dist/es/shared/node-entry.js:17416:37)
    at ModuleLoader.addModuleSource (file:///C:/a/Sunshine/Sunshine/node_modules/rollup/dist/es/shared/node-entry.js:21493:26)

codecov · 2026-01-21T03:05:08Z

Bundle Report

Bundle size has no change ✅

MinHook does not support arm64, add conditional check Signed-off-by: Coia Prant <[email protected]> Co-authored-by: ReenigneArcher <[email protected]>

Steam Audio Driver unavailable on Windows Arm64, add check Signed-off-by: Coia Prant <[email protected]>

For AMF `#include`, clang will resolve `std` to `config::amd::std` Use `::std` to force resolution to the global namespace Signed-off-by: Coia Prant <[email protected]> Co-authored-by: Ricky8955555 <[email protected]>

CLANGARM64 does not have libatomic which used by googletest, disable it Signed-off-by: Coia Prant <[email protected]>

Add windows arm64 documents. Signed-off-by: Coia Prant <[email protected]> Co-authored-by: ReenigneArcher <[email protected]>

nsis does not support arm64, so we cannot create an installer at this time Signed-off-by: Coia Prant <[email protected]> Co-authored-by: ReenigneArcher <[email protected]>

Add missing TOSTRING for ICON Signed-off-by: Coia Prant <[email protected]>

Add vendor ID detection for Qualcomm Adreno GPUs: - 0x4D4F4351: "QCOM" in ASCII (reversed as little-endian) - 0x5143: Alternate Qualcomm vendor ID When a Qualcomm GPU is detected, only Media Foundation encoders (h264_mf, hevc_mf, av1_mf) are considered compatible, as Qualcomm doesn't support NVENC, AMF, or QSV encoder APIs.

Add Windows Media Foundation hardware encoder support for platforms that don't have NVENC, AMF, or QSV (primarily Qualcomm Snapdragon). Encoders added: - h264_mf: H.264 via Media Foundation - hevc_mf: HEVC via Media Foundation - av1_mf: AV1 via Media Foundation Configuration: - Uses D3D11VA hardware device for GPU texture input - CBR rate control with display_remoting scenario for streaming - Only supports SDR 4:2:0 8-bit (Qualcomm MF encoder limitation) - Fixed GOP size of 120 frames since MF doesn't support on-demand IDR The mediafoundation encoder is probed after quicksync and amdvce, serving as a fallback for ARM64 Windows devices.

sonarqubecloud · 2026-01-21T20:22:20Z

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

rbqvq force-pushed the master branch 4 times, most recently from 0ccee19 to 4039fec Compare May 25, 2025 10:23

ReenigneArcher reviewed May 25, 2025

View reviewed changes

rbqvq force-pushed the master branch 2 times, most recently from b158d6d to 283ab4c Compare May 25, 2025 15:34

This was referenced May 26, 2025

refactor(installer/windows): move nsis code #3915

Merged

feat(installer/windows): add wix installer #3916

Draft

rbqvq force-pushed the master branch from 283ab4c to f5f8ad8 Compare June 2, 2025 17:14

This comment was marked as resolved.

Sign in to view

rbqvq force-pushed the master branch 11 times, most recently from 9d0c82c to b0e2234 Compare June 9, 2025 09:53

rbqvq force-pushed the master branch 2 times, most recently from 48376c4 to a3ee774 Compare June 30, 2025 05:21

rbqvq force-pushed the master branch from a3ee774 to cf8d908 Compare July 2, 2025 09:44

ReenigneArcher mentioned this pull request Aug 22, 2025

build(windows): add arm64 build #3369

Closed

15 tasks

LizardByte-bot added the stale label Oct 21, 2025

LizardByte-bot removed the stale label Oct 22, 2025

ReenigneArcher mentioned this pull request Dec 19, 2025

feat: Windows ARM64 Support (Qualcomm Snapdragon) #4521

Open

4 tasks

LizardByte-bot added the stale label Jan 20, 2026

rbqvq force-pushed the master branch from 885acc7 to ed73d18 Compare January 20, 2026 17:41

rbqvq added a commit to rbqvq/Sunshine that referenced this pull request Jan 20, 2026

fix(build): fix PROJECT_VERSION_PATCH 16-bit limit on windows

8b4e8b6

Close LizardByte#3905

rbqvq added a commit to rbqvq/Sunshine that referenced this pull request Jan 20, 2026

fix(build): fix PROJECT_VERSION_PATCH 16-bit limit on windows

5c893db

Close LizardByte#3905

rbqvq force-pushed the master branch from 8b4e8b6 to 5c893db Compare January 20, 2026 19:00

ReenigneArcher added this to the windows-arm milestone Jan 20, 2026

LizardByte-bot removed the stale label Jan 21, 2026

rbqvq and others added 9 commits January 21, 2026 20:15

fix(build): Enable minhook only on x86_64

22904a4

MinHook does not support arm64, add conditional check Signed-off-by: Coia Prant <[email protected]> Co-authored-by: ReenigneArcher <[email protected]>

fix(build): add check for Steam Audio Driver

a7f9ec1

Steam Audio Driver unavailable on Windows Arm64, add check Signed-off-by: Coia Prant <[email protected]>

fix(build): add compatibility for clang

9e53c1c

For AMF `#include`, clang will resolve `std` to `config::amd::std` Use `::std` to force resolution to the global namespace Signed-off-by: Coia Prant <[email protected]> Co-authored-by: Ricky8955555 <[email protected]>

fix(build): Disable test for windows arm64

9e05f3c

CLANGARM64 does not have libatomic which used by googletest, disable it Signed-off-by: Coia Prant <[email protected]>

docs(windows): add documents for arm64

4e024ec

Add windows arm64 documents. Signed-off-by: Coia Prant <[email protected]> Co-authored-by: ReenigneArcher <[email protected]>

ci(build/windows): add support for arm64

62fbe0f

nsis does not support arm64, so we cannot create an installer at this time Signed-off-by: Coia Prant <[email protected]> Co-authored-by: ReenigneArcher <[email protected]>

fix: clang llvm parse error

f21fe2d

Add missing TOSTRING for ICON Signed-off-by: Coia Prant <[email protected]>

rbqvq force-pushed the master branch from 5c893db to 18c77ae Compare January 21, 2026 20:16

	#include <AMF/components/VideoEncoderAV1.h>
	#include <AMF/components/VideoEncoderHEVC.h>
	#include <AMF/components/VideoEncoderVCE.h>

Uh oh!

build(windows): add arm64 initial support #3905

Are you sure you want to change the base?

build(windows): add arm64 initial support #3905

Conversation

rbqvq commented May 25, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Type of Change

Checklist

Question

Uh oh!

rbqvq commented May 25, 2025

Known Issues

Uh oh!

Uh oh!

ReenigneArcher May 25, 2025

Choose a reason for hiding this comment

Uh oh!

rbqvq May 25, 2025

Choose a reason for hiding this comment

Uh oh!

rbqvq May 25, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

ReenigneArcher May 25, 2025

Choose a reason for hiding this comment

Uh oh!

rbqvq May 25, 2025

Choose a reason for hiding this comment

Uh oh!

rbqvq Jun 2, 2025

Choose a reason for hiding this comment

Uh oh!

This comment was marked as off-topic.

Uh oh!

This comment was marked as off-topic.

Uh oh!

edesonmercy123 Jun 9, 2025

Choose a reason for hiding this comment

Uh oh!

ricky8955555 Jun 30, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

rbqvq commented Jun 2, 2025

Uh oh!

ReenigneArcher commented Jun 2, 2025

Uh oh!

rbqvq commented Jun 2, 2025

Uh oh!

This comment was marked as resolved.

ReenigneArcher commented Jul 2, 2025

Uh oh!

sonarqubecloud bot commented Jul 22, 2025

Quality Gate passed

Uh oh!

LizardByte-bot commented Oct 21, 2025

Uh oh!

rbqvq commented Oct 21, 2025

Uh oh!

ReenigneArcher commented Oct 21, 2025

Uh oh!

LizardByte-bot commented Jan 20, 2026

Uh oh!

rbqvq commented Jan 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

rbqvq commented Jan 20, 2026

Uh oh!

codecov bot commented Jan 21, 2026

Bundle Report

Uh oh!

sonarqubecloud bot commented Jan 21, 2026

rbqvq commented May 25, 2025 •

edited

Loading

rbqvq May 25, 2025 •

edited

Loading

rbqvq commented Jan 20, 2026 •

edited

Loading