# valvesoftware/proton architecture

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

- Interactive diagram: https://gitdiagram.com/valvesoftware/proton
- Repository: https://github.com/valvesoftware/proton
- Video tour (about a minute): https://gitdiagram.com/valvesoftware/proton/video

## Overview

Proton lets Windows-exclusive games run on Linux using Wine. The supplied tree and excerpts chiefly expose lsteamclient, a Steam API compatibility layer: a game-facing Remote Storage call is adapted to a Steam-client call through generated parameter structures and dispatch macros. The wider game-launch path through Wine is documented, but its implementation is not present in the supplied files. Other Steam API areas and SDK interface versions are represented in the tree; their internal wiring is not established by these excerpts.

Main entry points: [`lsteamclient/winISteamRemoteStorage.c`](https://github.com/valvesoftware/proton/blob/proton_11.0/lsteamclient/winISteamRemoteStorage.c) (Remote Storage bridge), [`lsteamclient/steamclient_generated.c`](https://github.com/valvesoftware/proton/blob/proton_11.0/lsteamclient/steamclient_generated.c) (Generated dispatch), [`lsteamclient/steamclient_private.h`](https://github.com/valvesoftware/proton/blob/proton_11.0/lsteamclient/steamclient_private.h) (Client ABI support), [`lsteamclient/steamclient_main.c`](https://github.com/valvesoftware/proton/blob/proton_11.0/lsteamclient/steamclient_main.c) (Client entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_compat["Compatibility runtime"]
  node_private["Client ABI support"]
  node_generated["Generated dispatch"]
  node_main["Client entry<br/>[steamclient_main.c]"]
  node_generatedheaders["Generated API structures"]
end

subgraph group_steamapi["Steam API bridges"]
  node_remote["Remote Storage bridge"]
  node_account["User and apps APIs"]
  node_social["Friends and community"]
  node_play["Games and matchmaking"]
  node_network["Networking APIs"]
  node_media["Media and input APIs"]
  node_content["UGC and inventory"]
  node_manual["Manual API wrappers"]
end

subgraph group_sdk["Steamworks interfaces"]
  node_interfaces["Versioned SDK interfaces"]
end

node_game(("Windows game"))
node_wine["Wine runtime"]
node_steamclient(("Steam client"))

node_game -->|"runs through"| node_wine
node_wine -.->|"calls API"| node_remote
node_remote -->|"uses ABI support"| node_private
node_remote -->|"dispatches calls"| node_generated
node_private -->|"includes declarations"| node_generated
node_generated -.->|"forwards calls"| node_steamclient
node_main -.->|"initializes client"| node_steamclient

click node_remote "https://github.com/valvesoftware/proton/blob/proton_11.0/lsteamclient/winISteamRemoteStorage.c"
click node_private "https://github.com/valvesoftware/proton/blob/proton_11.0/lsteamclient/steamclient_private.h"
click node_generated "https://github.com/valvesoftware/proton/blob/proton_11.0/lsteamclient/steamclient_generated.c"
click node_main "https://github.com/valvesoftware/proton/blob/proton_11.0/lsteamclient/steamclient_main.c"
click node_account "https://github.com/valvesoftware/proton/tree/proton_11.0/lsteamclient"
click node_social "https://github.com/valvesoftware/proton/tree/proton_11.0/lsteamclient"
click node_play "https://github.com/valvesoftware/proton/tree/proton_11.0/lsteamclient"
click node_network "https://github.com/valvesoftware/proton/tree/proton_11.0/lsteamclient"
click node_media "https://github.com/valvesoftware/proton/tree/proton_11.0/lsteamclient"
click node_content "https://github.com/valvesoftware/proton/tree/proton_11.0/lsteamclient"
click node_interfaces "https://github.com/valvesoftware/proton/blob/proton_11.0/lsteamclient/steamworks_sdk_136/isteamremotestorage.h"
click node_generatedheaders "https://github.com/valvesoftware/proton/blob/proton_11.0/lsteamclient/steamclient_structs_generated.h"
click node_manual "https://github.com/valvesoftware/proton/blob/proton_11.0/lsteamclient/steam_networking_manual.c"

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_private,node_generated,node_main,node_generatedheaders,node_steamclient toneBlue
class node_remote,node_account,node_social,node_play,node_network,node_media,node_content,node_manual toneAmber
class node_interfaces toneMint
class node_game,node_wine toneIndigo
```

## Components

### Compatibility runtime

- [Client ABI support](https://github.com/valvesoftware/proton/blob/proton_11.0/lsteamclient/steamclient_private.h): `lsteamclient/steamclient_private.h`
- [Generated dispatch](https://github.com/valvesoftware/proton/blob/proton_11.0/lsteamclient/steamclient_generated.c): `lsteamclient/steamclient_generated.c`
- [Client entry](https://github.com/valvesoftware/proton/blob/proton_11.0/lsteamclient/steamclient_main.c): `lsteamclient/steamclient_main.c`
- [Generated API structures](https://github.com/valvesoftware/proton/blob/proton_11.0/lsteamclient/steamclient_structs_generated.h): `lsteamclient/steamclient_structs_generated.h`

### Steam API bridges

- [Remote Storage bridge](https://github.com/valvesoftware/proton/blob/proton_11.0/lsteamclient/winISteamRemoteStorage.c): `lsteamclient/winISteamRemoteStorage.c`
- [User and apps APIs](https://github.com/valvesoftware/proton/tree/proton_11.0/lsteamclient): `lsteamclient`
- [Friends and community](https://github.com/valvesoftware/proton/tree/proton_11.0/lsteamclient): `lsteamclient`
- [Games and matchmaking](https://github.com/valvesoftware/proton/tree/proton_11.0/lsteamclient): `lsteamclient`
- [Networking APIs](https://github.com/valvesoftware/proton/tree/proton_11.0/lsteamclient): `lsteamclient`
- [Media and input APIs](https://github.com/valvesoftware/proton/tree/proton_11.0/lsteamclient): `lsteamclient`
- [UGC and inventory](https://github.com/valvesoftware/proton/tree/proton_11.0/lsteamclient): `lsteamclient`
- [Manual API wrappers](https://github.com/valvesoftware/proton/blob/proton_11.0/lsteamclient/steam_networking_manual.c): `lsteamclient/steam_networking_manual.c`

### Steamworks interfaces

- [Versioned SDK interfaces](https://github.com/valvesoftware/proton/blob/proton_11.0/lsteamclient/steamworks_sdk_136/isteamremotestorage.h): `lsteamclient/steamworks_sdk_136/isteamremotestorage.h`

### Other components

- **Windows game**
- **Wine runtime**
- **Steam client**

## Connections

- Windows game → Wine runtime: runs through
- Wine runtime → Remote Storage bridge: calls API
- Remote Storage bridge → Client ABI support: uses ABI support (evidence: `lsteamclient/winISteamRemoteStorage.c`)
- Remote Storage bridge → Generated dispatch: dispatches calls (evidence: `lsteamclient/winISteamRemoteStorage.c`)
- Client ABI support → Generated dispatch: includes declarations (evidence: `lsteamclient/steamclient_private.h`)
- Generated dispatch → Steam client: forwards calls
- Client entry → Steam client: initializes client
