Skip to content

How to use

okwang edited this page May 12, 2026 · 3 revisions

How to use

Online install

Use this when the iMac can access GitHub and GitHub release downloads:

brew tap latel/moonlight-qt https://github.com/latel/moonlight-qt.git
brew install --cask latel/moonlight-qt/moonlight-metal
open /Applications/Moonlight.app

Offline/local install

Use this when the iMac has no external network access.

Copy these items to the iMac first:

/tmp/moonlight-qt
/tmp/moonlight-metal-offline/Moonlight-Metal-imac18_3.zip

Then run:

brew tap latel/moonlight-qt /tmp/moonlight-qt
brew install --cask latel/moonlight-qt/moonlight-metal-local
open /Applications/Moonlight.app

Verify Metal is enabled

/usr/libexec/PlistBuddy -c 'Print :LSEnvironment:VT_FORCE_METAL' /Applications/Moonlight.app/Contents/Info.plist

Expected output:

1

Verify iMac architecture support

file /Applications/Moonlight.app/Contents/MacOS/Moonlight

Expected output contains x86_64 for Intel iMacs. The tested app bundle is universal and contains both x86_64 and arm64.

Connect to Sunshine

Open Moonlight and add the host Mac by IP, for example:

192.168.1.2

Recommended first settings for real 5K testing:

Resolution: 5120x2880
FPS: 30 first, 60 for stress testing
Codec: HEVC

Clone this wiki locally