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?

docs/getting_started.md

src/config.cpp

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.

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 ✅

ReenigneArcher · 2026-01-21T20:58:03Z

cmake/prep/options.cmake

 option(BUILD_DOCS "Build documentation" ON)
 option(BUILD_TESTS "Build tests" ON)
+
+# CLANGARM64 does not have libatomic which used by googletest, disable it


Can you open an issue here? https://github.com/google/googletest/issues

It seems like there's really only one place where atomic is used, maybe they can easily work around it when it's not available. https://github.com/search?q=repo%3Agoogle%2Fgoogletest%20atomic&type=code

Or we should use the gtest provided by msys2? https://github.com/msys2/MINGW-packages/tree/ab284e9ffd0590397c948f56ac889208464fb0dd/mingw-w64-gtest

I don't know, I think you can open a issue for it
:(

ReenigneArcher · 2026-02-01T00:17:39Z

wix installer is working now, could you test it in combination with the arm build?

#3916

I still need to make a few tweaks to that PR though.

rbqvq · 2026-02-01T07:11:15Z

Wow, its a good news.

I will test it later.

MinHook does not support arm64, add conditional check Signed-off-by: Coia Prant <coiaprant@gmail.com> Co-authored-by: ReenigneArcher <42013603+ReenigneArcher@users.noreply.github.com>

Steam Audio Driver unavailable on Windows Arm64, add check Signed-off-by: Coia Prant <coiaprant@gmail.com>

Use ::std:: fully qualified namespace in template functions to avoid ambiguity with clang namespace resolution. Signed-off-by: Coia Prant <coiaprant@gmail.com> Co-authored-by: Ricky8955555 <rkmiao@duck.com>

Clang does not have libatomic which used by googletest, So disable it Signed-off-by: Coia Prant <coiaprant@gmail.com>

Add windows arm64 documents. Signed-off-by: Coia Prant <coiaprant@gmail.com> Co-authored-by: ReenigneArcher <42013603+ReenigneArcher@users.noreply.github.com>

nsis does not support arm64, so we cannot create an installer at this time Signed-off-by: Coia Prant <coiaprant@gmail.com> Co-authored-by: ReenigneArcher <42013603+ReenigneArcher@users.noreply.github.com>

Add missing TOSTRING for ICON Signed-off-by: Coia Prant <coiaprant@gmail.com>

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.

…llup - Add `@rollup/wasm-node` to devDependencies. - Use npm overrides to force Rollup to use the WASM version. - Fixes "Node-API symbol not loaded" and "parseAsync is not a function" errors specifically occurring in MSYS2 ClangARM64 environment. Signed-off-by: Coia Prant <coiaprant@gmail.com>

rbqvq · 2026-02-03T20:17:47Z

All thing done.

Pre-built portable can find at https://github.com/rbqvq/Sunshine/actions/runs/21646290004

Thanks all people who works on #3905 and #4521

sonarqubecloud · 2026-02-03T20:22:06Z

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 · 2026-02-03T22:07:41Z

I think we can provide only portable version for windows arm64 currently, installer will be delay.

OBS Studio also don't have a installer, only portable.

So I think its okay.

If you agree I will update markdown docs

This comment was marked as resolved.

Sign in to view

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

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 force-pushed the master branch from 5c893db to 18c77ae Compare January 21, 2026 20:16

ReenigneArcher reviewed Jan 21, 2026

View reviewed changes

rbqvq and others added 2 commits February 3, 2026 18:50

fix(build): Enable minhook only on x86_64

bca3365

MinHook does not support arm64, add conditional check Signed-off-by: Coia Prant <coiaprant@gmail.com> Co-authored-by: ReenigneArcher <42013603+ReenigneArcher@users.noreply.github.com>

fix(build): add check for Steam Audio Driver

4595bee

Steam Audio Driver unavailable on Windows Arm64, add check Signed-off-by: Coia Prant <coiaprant@gmail.com>

rbqvq force-pushed the master branch 2 times, most recently from 52fb69c to 885b977 Compare February 3, 2026 18:52

rbqvq and others added 7 commits February 3, 2026 19:13

fix(build): clang namespace resolution

7ac2bbe

Use ::std:: fully qualified namespace in template functions to avoid ambiguity with clang namespace resolution. Signed-off-by: Coia Prant <coiaprant@gmail.com> Co-authored-by: Ricky8955555 <rkmiao@duck.com>

fix(build): disable googletest for windows arm64

6bb52ea

Clang does not have libatomic which used by googletest, So disable it Signed-off-by: Coia Prant <coiaprant@gmail.com>

docs(windows): add documents for arm64

fca5215

Add windows arm64 documents. Signed-off-by: Coia Prant <coiaprant@gmail.com> Co-authored-by: ReenigneArcher <42013603+ReenigneArcher@users.noreply.github.com>

ci(build/windows): add support for arm64

fe0f022

nsis does not support arm64, so we cannot create an installer at this time Signed-off-by: Coia Prant <coiaprant@gmail.com> Co-authored-by: ReenigneArcher <42013603+ReenigneArcher@users.noreply.github.com>

fix: clang llvm parse error

9fafb76

Add missing TOSTRING for ICON Signed-off-by: Coia Prant <coiaprant@gmail.com>

rbqvq force-pushed the master branch from 885b977 to b50a39b Compare February 3, 2026 19:36

rbqvq marked this pull request as ready for review February 3, 2026 20:15

rbqvq force-pushed the master branch from b50a39b to 4bffd13 Compare February 3, 2026 20:18

rbqvq requested a review from cgutman February 3, 2026 20:29

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

Uh oh!

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!

This comment was marked as resolved.

Uh oh!

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!

rbqvq commented Jan 20, 2026

Uh oh!

codecov bot commented Jan 21, 2026

Bundle Report

Uh oh!

ReenigneArcher Jan 21, 2026

Choose a reason for hiding this comment

Uh oh!

rbqvq Feb 3, 2026

Choose a reason for hiding this comment

Uh oh!

ReenigneArcher commented Feb 1, 2026

Uh oh!

rbqvq commented Feb 1, 2026

Uh oh!

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

Uh oh!

Uh oh!

sonarqubecloud bot commented Feb 3, 2026

Quality Gate passed

Uh oh!

rbqvq commented Feb 3, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

8 participants

rbqvq commented May 25, 2025 •

edited

Loading

rbqvq commented Feb 3, 2026 •

edited

Loading