# sunshinestream/sunshine architecture

> Architecture diagram of the GitHub repository sunshinestream/sunshine, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sunshinestream/sunshine
- Repository: https://github.com/sunshinestream/sunshine

## Overview

Sunshine is a self-hosted game-streaming host for Moonlight. A typical user connects from a Moonlight client, streams a game or desktop, and sends controls back to the host; a browser can configure Sunshine and pair clients. The tree shows separate HTTP, RTSP, capture, encoding, audio, and input modules, including platform-specific backends. README statements support the product capabilities, but the excerpts do not expose the runtime call chain, so subsystem links are omitted rather than inferred.

Main entry points: [`src/main.cpp`](https://github.com/sunshinestream/sunshine/blob/master/src/main.cpp) (Host runtime), [`src/video.cpp`](https://github.com/sunshinestream/sunshine/blob/master/src/video.cpp) (Video processing), [`src/input.cpp`](https://github.com/sunshinestream/sunshine/blob/master/src/input.cpp) (Client input), [`src/confighttp.cpp`](https://github.com/sunshinestream/sunshine/blob/master/src/confighttp.cpp) (Web configuration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_control["Host control"]
  node_main["Host runtime<br/>[main.cpp]"]
  node_web["Web configuration<br/>[confighttp.cpp]"]
  node_http["HTTP endpoints<br/>[nvhttp.cpp]"]
end

subgraph group_stream["Streaming"]
  node_rtsp["Stream session<br/>[rtsp.cpp]"]
  node_streaming["Stream coordination<br/>[stream.cpp]"]
  node_video["Video processing<br/>[video.cpp]"]
  node_nvenc["NVIDIA encoding<br/>[nvenc_base.cpp]"]
  node_network["Network transport<br/>[network.cpp]"]
end

subgraph group_platform["Platform backends"]
  node_capture["Video capture<br/>[kmsgrab.cpp]"]
  node_windows_display["Windows display capture<br/>[display_vram.cpp]"]
  node_input["Client input<br/>[input.cpp]"]
  node_virtual_hid["Virtual HID"]
  node_audio["Audio capture<br/>[audio.cpp]"]
  node_display["Display management<br/>[display_device.cpp]"]
end

subgraph group_support["Shared support"]
  node_config["Configuration<br/>[config.cpp]"]
  node_logging["Logging<br/>[logging.h]"]
end

node_moonlight(("Moonlight client"))
node_browser(("Browser user"))

node_moonlight -.->|"connects to"| node_rtsp
node_browser -->|"configures and pairs"| node_web
node_moonlight -->|"streams from"| node_main
node_main -.->|"captures frames"| node_capture
node_main -.->|"processes video"| node_video
node_main -.->|"receives controls"| node_input
node_main -.->|"captures audio"| node_audio
node_main -.->|"serves configuration"| node_web
node_main -.->|"hosts sessions"| node_rtsp
node_video -.->|"encodes video"| node_nvenc
node_input -.->|"emulates gamepad"| node_virtual_hid
node_main -.->|"captures display"| node_windows_display

click node_main "https://github.com/sunshinestream/sunshine/blob/master/src/main.cpp"
click node_web "https://github.com/sunshinestream/sunshine/blob/master/src/confighttp.cpp"
click node_http "https://github.com/sunshinestream/sunshine/blob/master/src/nvhttp.cpp"
click node_rtsp "https://github.com/sunshinestream/sunshine/blob/master/src/rtsp.cpp"
click node_streaming "https://github.com/sunshinestream/sunshine/blob/master/src/stream.cpp"
click node_capture "https://github.com/sunshinestream/sunshine/blob/master/src/platform/linux/kmsgrab.cpp"
click node_video "https://github.com/sunshinestream/sunshine/blob/master/src/video.cpp"
click node_nvenc "https://github.com/sunshinestream/sunshine/blob/master/src/nvenc/nvenc_base.cpp"
click node_windows_display "https://github.com/sunshinestream/sunshine/blob/master/src/platform/windows/display_vram.cpp"
click node_input "https://github.com/sunshinestream/sunshine/blob/master/src/input.cpp"
click node_virtual_hid "https://github.com/sunshinestream/sunshine/blob/master/src/platform/virtualhid_input.cpp"
click node_audio "https://github.com/sunshinestream/sunshine/blob/master/src/audio.cpp"
click node_network "https://github.com/sunshinestream/sunshine/blob/master/src/network.cpp"
click node_config "https://github.com/sunshinestream/sunshine/blob/master/src/config.cpp"
click node_display "https://github.com/sunshinestream/sunshine/blob/master/src/display_device.cpp"
click node_logging "https://github.com/sunshinestream/sunshine/blob/master/src/logging.h"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_main,node_web,node_http,node_moonlight,node_browser toneBlue
class node_rtsp,node_streaming,node_video,node_nvenc,node_network toneAmber
class node_capture,node_windows_display,node_input,node_virtual_hid,node_audio,node_display toneMint
class node_config,node_logging toneRose
```

## Components

### Host control

- [Host runtime](https://github.com/sunshinestream/sunshine/blob/master/src/main.cpp): `src/main.cpp`
- [Web configuration](https://github.com/sunshinestream/sunshine/blob/master/src/confighttp.cpp): `src/confighttp.cpp`
- [HTTP endpoints](https://github.com/sunshinestream/sunshine/blob/master/src/nvhttp.cpp): `src/nvhttp.cpp`

### Streaming

- [Stream session](https://github.com/sunshinestream/sunshine/blob/master/src/rtsp.cpp): `src/rtsp.cpp`
- [Stream coordination](https://github.com/sunshinestream/sunshine/blob/master/src/stream.cpp): `src/stream.cpp`
- [Video processing](https://github.com/sunshinestream/sunshine/blob/master/src/video.cpp): `src/video.cpp`
- [NVIDIA encoding](https://github.com/sunshinestream/sunshine/blob/master/src/nvenc/nvenc_base.cpp): `src/nvenc/nvenc_base.cpp`
- [Network transport](https://github.com/sunshinestream/sunshine/blob/master/src/network.cpp): `src/network.cpp`

### Platform backends

- [Video capture](https://github.com/sunshinestream/sunshine/blob/master/src/platform/linux/kmsgrab.cpp): `src/platform/linux/kmsgrab.cpp`
- [Windows display capture](https://github.com/sunshinestream/sunshine/blob/master/src/platform/windows/display_vram.cpp): `src/platform/windows/display_vram.cpp`
- [Client input](https://github.com/sunshinestream/sunshine/blob/master/src/input.cpp): `src/input.cpp`
- [Virtual HID](https://github.com/sunshinestream/sunshine/blob/master/src/platform/virtualhid_input.cpp): `src/platform/virtualhid_input.cpp`
- [Audio capture](https://github.com/sunshinestream/sunshine/blob/master/src/audio.cpp): `src/audio.cpp`
- [Display management](https://github.com/sunshinestream/sunshine/blob/master/src/display_device.cpp): `src/display_device.cpp`

### Shared support

- [Configuration](https://github.com/sunshinestream/sunshine/blob/master/src/config.cpp): `src/config.cpp`
- [Logging](https://github.com/sunshinestream/sunshine/blob/master/src/logging.h): `src/logging.h`

### Other components

- **Moonlight client**
- **Browser user**

## Connections

- Moonlight client → Stream session: connects to
- Browser user → Web configuration: configures and pairs (evidence: `README.md`)
- Moonlight client → Host runtime: streams from (evidence: `README.md`)
- Host runtime → Video capture: captures frames
- Host runtime → Video processing: processes video
- Host runtime → Client input: receives controls
- Host runtime → Audio capture: captures audio
- Host runtime → Web configuration: serves configuration
- Host runtime → Stream session: hosts sessions
- Video processing → NVIDIA encoding: encodes video
- Client input → Virtual HID: emulates gamepad
- Host runtime → Windows display capture: captures display
