> For the complete documentation index, see [llms.txt](https://ugfugl-io.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ugfugl-io.gitbook.io/docs/introduction/faq.md).

# FAQ

Quick answers about setup, stopping, input, audio and automation.

Glimmer is a native Swift Sunshine client for Mac, iPhone and iPad. Pair your device with the PC, choose a game and play.

## Setup

| Question                   | Answer                                                                                                                                                                                          |
| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Intel Mac or GameStream?   | No. Use [Apple Silicon, macOS 15.7 and Sunshine](/docs/introduction/requirements.md).                                                                                                           |
| iPhone or iPad?            | Yes: iOS 26 or later on iPhone, or iPadOS 26 or later on iPad. [Install through TestFlight](/docs/introduction/getting_started/install.md#iphone-and-ipad) now, or the App Store when released. |
| Virtual display needed?    | Only for a headless PC or [unsupported display mode](/docs/introduction/getting_started/host_setup.md).                                                                                         |
| Tailscale?                 | Enter the PC's address. [Wake on LAN](/docs/guides/features/pcs.md) stays on your home network.                                                                                                 |
| Why a Wi-Fi helper on Mac? | It pauses [AirDrop radio interruptions](/docs/guides/features/wifi.md) during a stream.                                                                                                         |

## Playing

| Question                             | Answer                                                                                                                                                                                                         |
| ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Stop without quitting the game?      | Turn on “Leave games running when you disconnect” in Settings › General before streaming. Then [Resume or Continue here](/docs/guides/features/streaming.md#continue-a-running-game) on another paired device. |
| Pointer trapped on Mac?              | Press Control-P. See [mouse controls](/docs/guides/features/keyboard_mouse.md).                                                                                                                                |
| Muffled AirPods on Mac?              | Use the Mac or USB microphone for [voice chat](/docs/guides/features/audio.md). Glimmer doesn't forward microphones.                                                                                           |
| Copy from the PC?                    | No clipboard sync. You can [paste Mac text into the PC](/docs/guides/features/keyboard_mouse.md#paste-text-into-the-pc).                                                                                       |
| Need a controller on iPhone or iPad? | No. Use [touch controls](/docs/guides/features/controllers.md#play-with-touch-controls-on-iphone-and-ipad), or touch to move and click the mouse.                                                              |

## Picture and connection

| Question                       | Answer                                                                                                                                                                                                                    |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| iPad picture cropped?          | The picture fills Split View and Stage Manager windows. Choose Native for the closest window size; see [iPad display modes](/docs/guides/features/streaming.md#play-on-iphone-or-ipad).                                   |
| “Adjusting stream quality…”?   | Glimmer is reconnecting at a different quality while keeping the game running. [Bandwidth set to Automatic](/docs/guides/features/wifi.md#bandwidth-automatic-maximum-and-saver) is currently the default in beta builds. |
| HDR or AV1 on iPhone and iPad? | Yes, when the PC, device and display support it. See [video support](/docs/guides/features/streaming.md#check-video-support).                                                                                             |

## More

| Question                       | Answer                                                                                                                                                                                         |
| ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Raycast or Stream Deck on Mac? | Use [automation](/docs/automation/automation.md).                                                                                                                                              |
| Analytics?                     | None. [Diagnostics stay local](/docs/security-and-privacy/security/privacy.md).                                                                                                                |
| Why Glimmer over Moonlight?    | Glimmer brings native controls and a shared streaming experience to Mac, iPhone and iPad. Moonlight inspired Glimmer; see [credits](https://github.com/Se7enbrc/glimmer/blob/main/CREDITS.md). |
| What's next?                   | [Updates](/docs/introduction/updates.md) and the [roadmap](/docs/project/roadmap.md), without delivery dates.                                                                                  |

Next: [troubleshoot a problem](/docs/guides/features/troubleshooting.md) or [find an existing report](https://github.com/Se7enbrc/glimmer/issues).