Moonlight is an open-source game streaming client that lets a person play games running on their own gaming PC from another device, such as a laptop, phone, tablet, television box or handheld. It implements the GameStream protocol originally created by NVIDIA and today is most often paired with the open-source host Sunshine.
Within cloud gaming, Moonlight belongs to the self-hosted branch often described as streaming your own game: the frames are rendered on hardware the player owns rather than in a data center. This gives lower cost and full control over the game library, but it also makes the player responsible for the host machine, the network and the configuration.
How Moonlight streams a game
Moonlight works as the client half of a client-host pair: the host PC runs the game, captures each frame, encodes it into compressed video and sends it over the network, while Moonlight decodes the video, plays the audio and returns controller, keyboard, mouse and touch input to the host.
The process starts with pairing. Moonlight displays a four-digit PIN that the user enters on the host, after which the two devices exchange certificates and trust each other. Session setup uses an RTSP-style handshake, and the media and input travel mainly over UDP, which avoids the retransmission delays of TCP. The host relies on the hardware video encoder of the graphics card, such as NVIDIA NVENC, AMD AMF or Intel Quick Sync, so encoding adds only a few milliseconds.
The table below summarizes the main stages of one streamed frame and what affects each stage.
| Stage | Where it happens | Main influence on quality |
|---|---|---|
| Rendering | Host GPU | Game settings and host performance |
| Capture and encode | Host GPU encoder | Codec, bitrate, encoder generation |
| Transport | Local network or internet | Bandwidth, jitter, packet loss |
| Decode | Client device | Hardware decoder support |
| Display and input | Client screen and controllers | Display latency, input polling |
Hosts, platforms and stream settings
Moonlight needs a compatible host service, and the choice of host has changed over time. NVIDIA GeForce Experience originally provided GameStream on GeForce cards, but NVIDIA retired GameStream in early 2023, so most users now run Sunshine, which supports NVIDIA, AMD and Intel graphics and runs on Windows, Linux and macOS. Apollo, a community fork of Sunshine, adds features such as virtual displays.
The client itself runs on a wide range of platforms, including Windows, macOS, Linux, Android, iOS, iPadOS, Apple TV, Raspberry Pi and Linux handhelds such as the Steam Deck. Availability of specific features, such as HDR or AV1 decoding, depends on the client device hardware.
| Parameter | Typical range | What it affects |
|---|---|---|
| Resolution | 720p to 4K | Sharpness and required bitrate |
| Frame rate | 30 to 120 fps or higher | Smoothness and input responsiveness |
| Bitrate | About 10 to 150 Mbps | Image detail and network load |
| Codec | H.264, HEVC, AV1 | Efficiency and device compatibility |
| HDR | On or off | Color range, needs HEVC or AV1 support |
| Frame pacing | On or off | Smoothness versus a little extra latency |
As a rule of thumb, 1080p at 60 fps works well around 20 to 30 Mbps with HEVC, while 4K at 60 fps usually needs 80 Mbps or more for clean detail in fast scenes. The exact numbers depend on the game content, because dark, detailed or fast-moving images compress less efficiently.
Moonlight compared with other streaming options
Moonlight differs from commercial cloud gaming services because it streams hardware the player already owns. Services such as GeForce NOW, Xbox Cloud Gaming or Shadow PC rent remote hardware, while Moonlight, Steam Remote Play and PlayStation Remote Play stream from a machine at home.
| Option | Where the game runs | Main difference |
|---|---|---|
| Moonlight with Sunshine | Player-owned PC | Open source, any launcher, deep tuning |
| Steam Remote Play | Player-owned PC | Built into Steam, simpler, fewer settings |
| PlayStation Remote Play | Player-owned console | Limited to PlayStation games |
| GeForce NOW | Provider data center | Subscription, supported games only |
| Shadow PC | Rented remote PC | Full remote Windows machine, monthly fee |
Its main strengths are launcher independence, since it streams the whole desktop or any application, and very low latency on a good local network, often within a few milliseconds of network delay. Its main weakness is that setup and troubleshooting fall on the user, especially for remote access outside the home.
Setting up for low latency
The quality of a Moonlight session depends more on the network than on the software. A wired Ethernet connection on the host is the single most important step, and the client should ideally be wired or connected to 5 GHz or 6 GHz Wi-Fi close to the access point.
The following decision table matches common situations with recommended settings.
| Situation | Recommended setting | Reason |
|---|---|---|
| Wired home network | High bitrate, 60 to 120 fps | Ample bandwidth, minimal jitter |
| Busy Wi-Fi | Lower bitrate, HEVC or AV1 | Reduces packet loss and stutter |
| Remote over internet | VPN mesh, 10 to 30 Mbps | Limited upload, safer than open ports |
| Older client device | H.264 at 1080p | Widest hardware decoder support |
| HDR television | HEVC or AV1 with HDR | Preserves the wider color range |
For access away from home, a mesh VPN such as Tailscale or ZeroTier is generally preferred over forwarding ports on the router, because it avoids exposing the host service directly to the internet. Upload speed at home is usually the limiting factor for remote streaming.
Limitations and common issues
Moonlight cannot remove the physical limits of streaming: every session adds encoding, transport and decoding delay, and compression artifacts appear when bitrate is too low for the content.
- Host must stay awake: the PC needs to be powered on, or woken remotely with Wake-on-LAN, which not every network supports.
- Anti-cheat and launchers: some games react poorly to virtual input devices, and certain protected screens, such as Windows secure prompts, may not capture.
- Resolution mismatch: streaming a 16:10 or ultrawide client from a 16:9 host monitor causes black bars unless the host uses a virtual display.
- Wi-Fi interference: microwaves, crowded channels and distance cause intermittent stutter that looks like a software fault.
- Decoder limits: low-end phones and set-top boxes may not decode AV1 or high bitrates smoothly.
Understanding it simply
Moonlight is an app that lets you play the games on your home computer from another screen. The powerful PC does the hard work, and Moonlight shows you the picture and sends your button presses back.
Think of it as a very fast video call with your own computer, except you can control it in real time. It is free, works on many devices and needs no monthly subscription, but the result is only as good as your home network.
Applied in practice
A student keeps a desktop gaming PC with a recent graphics card in a shared apartment and installs Sunshine on it, connected to the router by Ethernet. On a living room television, an Android TV box runs Moonlight over 5 GHz Wi-Fi at 1080p, 60 fps and 30 Mbps with HEVC, and a Bluetooth controller is paired to the box.
The student plays a racing game and an action role-playing game from the sofa with no noticeable input delay and only occasional artifacts in heavy rain scenes. During a weekend trip, the same setup works through a mesh VPN at 15 Mbps on a laptop, which is good enough for a slower strategy game, while the fast racing game feels noticeably less responsive because of the longer internet path.