# gnome/at-spi2-core architecture

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

- Interactive diagram: https://gitdiagram.com/gnome/at-spi2-core
- Repository: https://github.com/gnome/at-spi2-core

## Overview

AT-SPI is a multi-process accessibility stack: applications expose accessible objects through ATK, the adaptor translates them to AT-SPI over D-Bus, and assistive technologies use libatspi to query and interact with them. The registry tracks applications and supports communication among them; a session bus launcher and device-event services provide additional stack capabilities. The README documents the main component boundaries. Source excerpts also show application registration and event translation, but do not establish every runtime call between sampled modules.

Main entry points: [`atk-adaptor/bridge.c`](https://github.com/gnome/at-spi2-core/blob/main/atk-adaptor/bridge.c) (ATK Bridge), [`atspi`](https://github.com/gnome/at-spi2-core/tree/main/atspi) (libatspi Bindings), [`atk-adaptor/adaptors`](https://github.com/gnome/at-spi2-core/tree/main/atk-adaptor/adaptors) (Interface Adaptors), [`registryd/registry.c`](https://github.com/gnome/at-spi2-core/blob/main/registryd/registry.c) (Application Registry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app_api["Application Accessibility"]
  node_atk["ATK API"]
end

subgraph group_adaptation["ATK Adaptation"]
  node_bridge["ATK Bridge<br/>[bridge.c]"]
  node_adaptors["Interface Adaptors"]
  node_event_translation["Event Translation<br/>[event.c]"]
  node_object_refs["Object References<br/>[object.c]"]
end

subgraph group_client["Assistive Technology Client"]
  node_atspi["libatspi Bindings"]
  node_atspi_device["Device APIs"]
end

subgraph group_services["Session Services"]
  node_registry[("Application Registry<br/>[registry.c]")]
  node_device_controller["Device Event Controller"]
  node_x11_controller["X11 Backend"]
  node_bus_launcher["Bus Launcher"]
end

subgraph group_internals["IPC Internals"]
  node_dbus(("D-Bus"))
  node_dbind["D-Bus Utilities"]
  node_droute["D-Bus Routing"]
end

node_application(("Accessible Application"))
node_assistive_tech(("Assistive Technology"))

node_application -->|"implements access"| node_atk
node_atk -->|"translates through"| node_bridge
node_bridge -.->|"dispatches interfaces"| node_adaptors
node_bridge -->|"registers application"| node_registry
node_bridge -->|"communicates over"| node_dbus
node_adaptors -->|"translates to"| node_atspi
node_event_translation -->|"emits events"| node_dbus
node_object_refs -.->|"encodes references"| node_adaptors
node_assistive_tech -->|"uses bindings"| node_atspi
node_atspi -->|"discovers applications"| node_registry
node_atspi -->|"uses utilities"| node_dbind
node_atspi_device -.->|"calls services"| node_dbus
node_registry -->|"coordinates over"| node_dbus
node_device_controller -.->|"handles events"| node_dbus
node_device_controller -.->|"uses backend"| node_x11_controller
node_bus_launcher -->|"launches session bus"| node_dbus
node_bridge -->|"uses routing"| node_droute

click node_atk "https://github.com/gnome/at-spi2-core/tree/main/atk"
click node_bridge "https://github.com/gnome/at-spi2-core/blob/main/atk-adaptor/bridge.c"
click node_adaptors "https://github.com/gnome/at-spi2-core/tree/main/atk-adaptor/adaptors"
click node_event_translation "https://github.com/gnome/at-spi2-core/blob/main/atk-adaptor/event.c"
click node_object_refs "https://github.com/gnome/at-spi2-core/blob/main/atk-adaptor/object.c"
click node_atspi "https://github.com/gnome/at-spi2-core/tree/main/atspi"
click node_atspi_device "https://github.com/gnome/at-spi2-core/blob/main/atspi/atspi-device-a11y-manager.c"
click node_registry "https://github.com/gnome/at-spi2-core/blob/main/registryd/registry.c"
click node_device_controller "https://github.com/gnome/at-spi2-core/blob/main/registryd/deviceeventcontroller.c"
click node_x11_controller "https://github.com/gnome/at-spi2-core/blob/main/registryd/deviceeventcontroller-x11.c"
click node_bus_launcher "https://github.com/gnome/at-spi2-core/blob/main/bus/at-spi-bus-launcher.c"
click node_dbind "https://github.com/gnome/at-spi2-core/tree/main/dbind"
click node_droute "https://github.com/gnome/at-spi2-core/tree/main/droute"

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_atk toneBlue
class node_bridge,node_adaptors,node_event_translation,node_object_refs toneAmber
class node_atspi,node_atspi_device toneMint
class node_registry,node_device_controller,node_x11_controller,node_bus_launcher toneRose
class node_dbus,node_dbind,node_droute,node_application,node_assistive_tech toneIndigo
```

## Components

### Application Accessibility

- [ATK API](https://github.com/gnome/at-spi2-core/tree/main/atk): `atk`

### ATK Adaptation

- [ATK Bridge](https://github.com/gnome/at-spi2-core/blob/main/atk-adaptor/bridge.c): `atk-adaptor/bridge.c`
- [Interface Adaptors](https://github.com/gnome/at-spi2-core/tree/main/atk-adaptor/adaptors): `atk-adaptor/adaptors`
- [Event Translation](https://github.com/gnome/at-spi2-core/blob/main/atk-adaptor/event.c): `atk-adaptor/event.c`
- [Object References](https://github.com/gnome/at-spi2-core/blob/main/atk-adaptor/object.c): `atk-adaptor/object.c`

### Assistive Technology Client

- [libatspi Bindings](https://github.com/gnome/at-spi2-core/tree/main/atspi): `atspi`
- [Device APIs](https://github.com/gnome/at-spi2-core/blob/main/atspi/atspi-device-a11y-manager.c): `atspi/atspi-device-a11y-manager.c`

### Session Services

- [Application Registry](https://github.com/gnome/at-spi2-core/blob/main/registryd/registry.c): `registryd/registry.c`
- [Device Event Controller](https://github.com/gnome/at-spi2-core/blob/main/registryd/deviceeventcontroller.c): `registryd/deviceeventcontroller.c`
- [X11 Backend](https://github.com/gnome/at-spi2-core/blob/main/registryd/deviceeventcontroller-x11.c): `registryd/deviceeventcontroller-x11.c`
- [Bus Launcher](https://github.com/gnome/at-spi2-core/blob/main/bus/at-spi-bus-launcher.c): `bus/at-spi-bus-launcher.c`

### IPC Internals

- **D-Bus**
- [D-Bus Utilities](https://github.com/gnome/at-spi2-core/tree/main/dbind): `dbind`
- [D-Bus Routing](https://github.com/gnome/at-spi2-core/tree/main/droute): `droute`

### Other components

- **Accessible Application**
- **Assistive Technology**

## Connections

- Accessible Application → ATK API: implements access (evidence: `README.md`)
- ATK API → ATK Bridge: translates through (evidence: `README.md`)
- ATK Bridge → Interface Adaptors: dispatches interfaces (evidence: `atk-adaptor/bridge.c`)
- ATK Bridge → Application Registry: registers application (evidence: `atk-adaptor/bridge.c`)
- ATK Bridge → D-Bus: communicates over (evidence: `atk-adaptor/bridge.c`)
- Interface Adaptors → libatspi Bindings: translates to (evidence: `README.md`)
- Event Translation → D-Bus: emits events (evidence: `atk-adaptor/event.c`)
- Object References → Interface Adaptors: encodes references
- Assistive Technology → libatspi Bindings: uses bindings (evidence: `README.md`)
- libatspi Bindings → Application Registry: discovers applications (evidence: `README.md`)
- libatspi Bindings → D-Bus Utilities: uses utilities (evidence: `README.md`)
- Device APIs → D-Bus: calls services
- Application Registry → D-Bus: coordinates over (evidence: `README.md`)
- Device Event Controller → D-Bus: handles events
- Device Event Controller → X11 Backend: uses backend
- Bus Launcher → D-Bus: launches session bus (evidence: `README.md`)
- ATK Bridge → D-Bus Routing: uses routing (evidence: `README.md`)
