Skip to main content
Sunshine on macOS is experimental. Gamepads do not work.
Sunshine can be installed on macOS using either the DMG installer or Homebrew package manager.

​
Installation Methods

​
Download and Install

  1. Download the DMG file from the latest release
  2. Open the downloaded DMG file
  3. Drag Sunshine to your Applications folder
  4. Launch Sunshine from your Applications folder

​
Uninstall

  1. Open Finder
  2. Navigate to Applications
  3. Drag Sunshine to the Trash
  4. Empty the Trash

​
Post-Installation Setup

​
Permissions

The first time you start Sunshine, you will be asked to grant access to screen recording and your microphone.
1

Screen Recording Permission

When prompted, grant Sunshine permission to record your screen. This is required for streaming.
2

Microphone Permission

When prompted, grant Sunshine permission to access your microphone. This is required for audio streaming.

​
Audio Setup

Sunshine can only access microphones on macOS due to system limitations. To stream system audio use Soundflower or BlackHole.
System audio capture requires third-party audio routing software like Soundflower or BlackHole.

​
Requirements

  • macOS 10.15 (Catalina) or later recommended
  • Screen Recording and Microphone permissions
  • Third-party audio routing software for system audio (optional)

​
Known Limitations

The following limitations currently exist on macOS:
  • Gamepads are not currently supported
  • Command Keys are not forwarded by Moonlight
  • Right Option-Key is mapped to CMD-Key

​
Keyboard Mapping

Command Keys are not forwarded by Moonlight. Right Option-Key is mapped to CMD-Key.
Due to Moonlight’s keyboard handling, some key combinations may not work as expected. The Right Option key can be used as an alternative to the Command key.

Build docs developers (and LLMs) love

Get started for freeTalk to us