# neutrinolabs/pipewire-module-xrdp architecture

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

- Interactive diagram: https://gitdiagram.com/neutrinolabs/pipewire-module-xrdp
- Repository: https://github.com/neutrinolabs/pipewire-module-xrdp

## Overview

pipewire-module-xrdp bridges audio between an xrdp session and PipeWire. The documented startup path is desktop XDG autostart → module-loading script → PipeWire module. At runtime, the module exposes playback and capture streams and exchanges audio with xrdp over Unix sockets. A separate bundled pw-cli variant supports older PipeWire systems; the available excerpts do not establish how startup invokes it or detail its role in this workflow.

Main entry points: [`src/module-xrdp.c`](https://github.com/neutrinolabs/pipewire-module-xrdp/blob/devel/src/module-xrdp.c) (XRDP module), [`instfiles/pipewire-xrdp.desktop.in`](https://github.com/neutrinolabs/pipewire-module-xrdp/blob/devel/instfiles/pipewire-xrdp.desktop.in) (XDG autostart), [`instfiles/load_pw_modules.sh`](https://github.com/neutrinolabs/pipewire-module-xrdp/blob/devel/instfiles/load_pw_modules.sh) (Module loader)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_startup["Session startup"]
  node_autostart["XDG autostart"]
  node_loader["Module loader<br/>[load_pw_modules.sh]"]
end

subgraph group_bridge["Audio bridge"]
  node_module["XRDP module<br/>[module-xrdp.c]"]
  node_playback["Playback stream<br/>[module-xrdp.c]"]
  node_capture["Capture stream<br/>[module-xrdp.c]"]
  node_socket["XRDP Unix socket<br/>[module-xrdp.c]"]
end

subgraph group_compat["Compatibility tool"]
  node_legacycli["Legacy pw-cli<br/>[pw-cli_0358_mod.c]"]
end

node_desktop(("Desktop session"))
node_pipewire["PipeWire runtime"]
node_xrdp["XRDP audio service"]

node_desktop -->|"starts desktop"| node_autostart
node_autostart -->|"runs script"| node_loader
node_loader -->|"loads module"| node_module
node_module -->|"registers streams"| node_pipewire
node_module -->|"creates stream"| node_playback
node_module -->|"creates stream"| node_capture
node_playback -->|"sends audio"| node_socket
node_capture -->|"receives audio"| node_socket
node_socket -->|"exchanges audio"| node_xrdp

click node_autostart "https://github.com/neutrinolabs/pipewire-module-xrdp/blob/devel/instfiles/pipewire-xrdp.desktop.in"
click node_loader "https://github.com/neutrinolabs/pipewire-module-xrdp/blob/devel/instfiles/load_pw_modules.sh"
click node_module "https://github.com/neutrinolabs/pipewire-module-xrdp/blob/devel/src/module-xrdp.c"
click node_playback "https://github.com/neutrinolabs/pipewire-module-xrdp/blob/devel/src/module-xrdp.c"
click node_capture "https://github.com/neutrinolabs/pipewire-module-xrdp/blob/devel/src/module-xrdp.c"
click node_socket "https://github.com/neutrinolabs/pipewire-module-xrdp/blob/devel/src/module-xrdp.c"
click node_legacycli "https://github.com/neutrinolabs/pipewire-module-xrdp/blob/devel/src/pw-cli_0358_mod.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_autostart,node_loader toneBlue
class node_module,node_playback,node_capture,node_socket toneAmber
class node_legacycli toneMint
class node_desktop,node_pipewire,node_xrdp toneIndigo
```

## Components

### Session startup

- [XDG autostart](https://github.com/neutrinolabs/pipewire-module-xrdp/blob/devel/instfiles/pipewire-xrdp.desktop.in): `instfiles/pipewire-xrdp.desktop.in`
- [Module loader](https://github.com/neutrinolabs/pipewire-module-xrdp/blob/devel/instfiles/load_pw_modules.sh): `instfiles/load_pw_modules.sh`

### Audio bridge

- [XRDP module](https://github.com/neutrinolabs/pipewire-module-xrdp/blob/devel/src/module-xrdp.c): `src/module-xrdp.c`
- [Playback stream](https://github.com/neutrinolabs/pipewire-module-xrdp/blob/devel/src/module-xrdp.c): `src/module-xrdp.c`
- [Capture stream](https://github.com/neutrinolabs/pipewire-module-xrdp/blob/devel/src/module-xrdp.c): `src/module-xrdp.c`
- [XRDP Unix socket](https://github.com/neutrinolabs/pipewire-module-xrdp/blob/devel/src/module-xrdp.c): `src/module-xrdp.c`

### Compatibility tool

- [Legacy pw-cli](https://github.com/neutrinolabs/pipewire-module-xrdp/blob/devel/src/pw-cli_0358_mod.c): `src/pw-cli_0358_mod.c`

### Other components

- **Desktop session**
- **PipeWire runtime**
- **XRDP audio service**

## Connections

- Desktop session → XDG autostart: starts desktop (evidence: `README.md`)
- XDG autostart → Module loader: runs script (evidence: `README.md`)
- Module loader → XRDP module: loads module (evidence: `README.md`)
- XRDP module → PipeWire runtime: registers streams (evidence: `src/module-xrdp.c`)
- XRDP module → Playback stream: creates stream (evidence: `src/module-xrdp.c`)
- XRDP module → Capture stream: creates stream (evidence: `src/module-xrdp.c`)
- Playback stream → XRDP Unix socket: sends audio (evidence: `src/module-xrdp.c`)
- Capture stream → XRDP Unix socket: receives audio (evidence: `src/module-xrdp.c`)
- XRDP Unix socket → XRDP audio service: exchanges audio (evidence: `src/module-xrdp.c`)
