# coherence-project/upnp-inspector architecture

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

- Interactive diagram: https://gitdiagram.com/coherence-project/upnp-inspector
- Repository: https://github.com/coherence-project/upnp-inspector

## Overview

UPnP-Inspector is a GTK desktop analyzer and lightweight control point. A user starts at the main window, discovers network devices, and selects devices or services to inspect details, run actions, or open specialized device tools. The specialized tools cover MediaServer browsing, MediaRenderer playback control, Internet Gateway status, event monitoring, logging, and description extraction. The excerpts show the main-window wiring and several specialized operations; other capability links are supported by the README. Some subsystem internals were not sampled, so their internal call paths are not expanded.

Main entry points: [`upnp_inspector/base.py`](https://github.com/coherence-project/upnp-inspector/blob/develop/upnp_inspector/base.py) (Main Window), [`upnp_inspector/devices.py`](https://github.com/coherence-project/upnp-inspector/blob/develop/upnp_inspector/devices.py) (Device Browser), [`upnp_inspector/extract.py`](https://github.com/coherence-project/upnp-inspector/blob/develop/upnp_inspector/extract.py) (Description Extractor), [`upnp_inspector/mediaserver.py`](https://github.com/coherence-project/upnp-inspector/blob/develop/upnp_inspector/mediaserver.py) (MediaServer Browser)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_main["Inspector UI"]
  node_main_window["Main Window<br/>[base.py]"]
  node_device_tree["Device Browser<br/>[devices.py]"]
  node_coherence["Coherence Control Point<br/>[base.py]"]
end

subgraph group_analysis["Inspection Tools"]
  node_details["Object Details<br/>[details.py]"]
  node_events["Event Monitor<br/>[events.py]"]
  node_log["Global Log<br/>[log.py]"]
  node_extract["Description Extractor<br/>[extract.py]"]
end

subgraph group_media["Media Control"]
  node_media_server["MediaServer Browser<br/>[mediaserver.py]"]
  node_renderer["MediaRenderer Control<br/>[mediarenderer.py]"]
end

subgraph group_gateway["Gateway Tools"]
  node_gateway["Gateway Inspector<br/>[igd.py]"]
end

subgraph group_support["Shared Support"]
  node_resources["Icon Resources<br/>[_resources.py]"]
  node_about["About Dialog<br/>[about.py]"]
end

node_user(("User"))
node_upnp_devices(("UPnP Devices"))
node_mail(("SMTP Mail Service"))

node_user -->|"opens"| node_main_window
node_main_window -->|"creates"| node_coherence
node_coherence -->|"discovers"| node_upnp_devices
node_main_window -->|"shows"| node_device_tree
node_device_tree -->|"lists"| node_upnp_devices
node_device_tree -->|"refreshes"| node_details
node_main_window -->|"opens"| node_events
node_main_window -->|"opens"| node_log
node_device_tree -->|"opens"| node_extract
node_device_tree -->|"opens"| node_media_server
node_device_tree -->|"opens"| node_renderer
node_device_tree -->|"opens"| node_gateway
node_media_server -.->|"sends media"| node_renderer
node_extract -.->|"emails archive"| node_mail
node_main_window -->|"opens"| node_about
node_about -->|"loads logo"| node_resources
node_main_window -->|"loads icons"| node_resources

click node_main_window "https://github.com/coherence-project/upnp-inspector/blob/develop/upnp_inspector/base.py"
click node_device_tree "https://github.com/coherence-project/upnp-inspector/blob/develop/upnp_inspector/devices.py"
click node_coherence "https://github.com/coherence-project/upnp-inspector/blob/develop/upnp_inspector/base.py"
click node_details "https://github.com/coherence-project/upnp-inspector/blob/develop/upnp_inspector/details.py"
click node_events "https://github.com/coherence-project/upnp-inspector/blob/develop/upnp_inspector/events.py"
click node_log "https://github.com/coherence-project/upnp-inspector/blob/develop/upnp_inspector/log.py"
click node_extract "https://github.com/coherence-project/upnp-inspector/blob/develop/upnp_inspector/extract.py"
click node_media_server "https://github.com/coherence-project/upnp-inspector/blob/develop/upnp_inspector/mediaserver.py"
click node_renderer "https://github.com/coherence-project/upnp-inspector/blob/develop/upnp_inspector/mediarenderer.py"
click node_gateway "https://github.com/coherence-project/upnp-inspector/blob/develop/upnp_inspector/igd.py"
click node_resources "https://github.com/coherence-project/upnp-inspector/blob/develop/upnp_inspector/_resources.py"
click node_about "https://github.com/coherence-project/upnp-inspector/blob/develop/upnp_inspector/about.py"

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_window,node_device_tree,node_coherence,node_user toneBlue
class node_details,node_events,node_log,node_extract toneAmber
class node_media_server,node_renderer toneMint
class node_gateway toneRose
class node_resources,node_about,node_upnp_devices,node_mail toneIndigo
```

## Components

### Inspector UI

- [Main Window](https://github.com/coherence-project/upnp-inspector/blob/develop/upnp_inspector/base.py): `upnp_inspector/base.py`
- [Device Browser](https://github.com/coherence-project/upnp-inspector/blob/develop/upnp_inspector/devices.py): `upnp_inspector/devices.py`
- [Coherence Control Point](https://github.com/coherence-project/upnp-inspector/blob/develop/upnp_inspector/base.py): `upnp_inspector/base.py`

### Inspection Tools

- [Object Details](https://github.com/coherence-project/upnp-inspector/blob/develop/upnp_inspector/details.py): `upnp_inspector/details.py`
- [Event Monitor](https://github.com/coherence-project/upnp-inspector/blob/develop/upnp_inspector/events.py): `upnp_inspector/events.py`
- [Global Log](https://github.com/coherence-project/upnp-inspector/blob/develop/upnp_inspector/log.py): `upnp_inspector/log.py`
- [Description Extractor](https://github.com/coherence-project/upnp-inspector/blob/develop/upnp_inspector/extract.py): `upnp_inspector/extract.py`

### Media Control

- [MediaServer Browser](https://github.com/coherence-project/upnp-inspector/blob/develop/upnp_inspector/mediaserver.py): `upnp_inspector/mediaserver.py`
- [MediaRenderer Control](https://github.com/coherence-project/upnp-inspector/blob/develop/upnp_inspector/mediarenderer.py): `upnp_inspector/mediarenderer.py`

### Gateway Tools

- [Gateway Inspector](https://github.com/coherence-project/upnp-inspector/blob/develop/upnp_inspector/igd.py): `upnp_inspector/igd.py`

### Shared Support

- [Icon Resources](https://github.com/coherence-project/upnp-inspector/blob/develop/upnp_inspector/_resources.py): `upnp_inspector/_resources.py`
- [About Dialog](https://github.com/coherence-project/upnp-inspector/blob/develop/upnp_inspector/about.py): `upnp_inspector/about.py`

### Other components

- **User**
- **UPnP Devices**
- **SMTP Mail Service**

## Connections

- User → Main Window: opens (evidence: `README.txt`)
- Main Window → Coherence Control Point: creates (evidence: `upnp_inspector/base.py`)
- Coherence Control Point → UPnP Devices: discovers (evidence: `README.txt`)
- Main Window → Device Browser: shows (evidence: `upnp_inspector/base.py`)
- Device Browser → UPnP Devices: lists (evidence: `upnp_inspector/devices.py`)
- Device Browser → Object Details: refreshes (evidence: `upnp_inspector/base.py`)
- Main Window → Event Monitor: opens (evidence: `upnp_inspector/base.py`)
- Main Window → Global Log: opens (evidence: `upnp_inspector/base.py`)
- Device Browser → Description Extractor: opens (evidence: `upnp_inspector/devices.py`)
- Device Browser → MediaServer Browser: opens (evidence: `upnp_inspector/devices.py`)
- Device Browser → MediaRenderer Control: opens (evidence: `upnp_inspector/devices.py`)
- Device Browser → Gateway Inspector: opens (evidence: `upnp_inspector/devices.py`)
- MediaServer Browser → MediaRenderer Control: sends media (evidence: `README.txt`)
- Description Extractor → SMTP Mail Service: emails archive (evidence: `upnp_inspector/extract.py`)
- Main Window → About Dialog: opens (evidence: `upnp_inspector/base.py`)
- About Dialog → Icon Resources: loads logo (evidence: `upnp_inspector/about.py`)
- Main Window → Icon Resources: loads icons (evidence: `upnp_inspector/base.py`)
