# nvaccess/nvda architecture

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

- Interactive diagram: https://gitdiagram.com/nvaccess/nvda
- Repository: https://github.com/nvaccess/nvda

## Overview

NVDA is a Windows screen reader. The principal workflow is user or application activity entering NVDA’s input/event and accessibility layers, becoming navigable text or object information, then being rendered through speech, braille, or visual assistance. The repository also contains add-on distribution, remote relay, OCR/content recognition, and magnification subsystems. Several arrows reflect explicit sampled calls; unsampled integrations are shown only where the tree and documented module roles support the capability.

Main entry points: [`source/NVDAObjects/__init__.py`](https://github.com/nvaccess/nvda/blob/master/source/NVDAObjects/__init__.py) (NVDA Objects), [`source/inputCore.py`](https://github.com/nvaccess/nvda/blob/master/source/inputCore.py) (Input Handling), [`source/cursorManager.py`](https://github.com/nvaccess/nvda/blob/master/source/cursorManager.py) (Cursor Manager), [`source/addonStore/dataManager.py`](https://github.com/nvaccess/nvda/blob/master/source/addonStore/dataManager.py) (Add-on Data Manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Runtime Orchestration"]
  node_input_core["Input Handling<br/>[inputCore.py]"]
  node_event_handler["Event Handling<br/>[eventHandler.py]"]
  node_nvda_core["NVDA Core<br/>[core.py]"]
  node_cursor_manager["Cursor Manager<br/>[cursorManager.py]"]
end

subgraph group_access["Accessibility and Text"]
  node_iaccessible["IAccessible Bridge<br/>[__init__.py]"]
  node_uia_handler["UIA Bridge<br/>[__init__.py]"]
  node_nvda_objects["NVDA Objects<br/>[__init__.py]"]
  node_virtual_buffers["Virtual Buffers<br/>[__init__.py]"]
  node_vbuf_storage["Text Tree Storage<br/>[storage.cpp]"]
end

subgraph group_output["Output Channels"]
  node_speech_manager["Speech Manager<br/>[manager.py]"]
  node_synth_drivers["Synth Drivers<br/>[__init__.py]"]
  node_braille_handler["Braille Handler<br/>[brailleHandler.py]"]
  node_braille_drivers["Braille Drivers<br/>[__init__.py]"]
end

subgraph group_vision["Vision Assistance"]
  node_magnifier["Magnifier<br/>[magnifier.py]"]
  node_focus_manager["Focus Manager<br/>[focusManager.py]"]
  node_content_recognition["Content Recognition<br/>[__init__.py]"]
end

subgraph group_extensions["Extensions and Connectivity"]
  node_addon_gui["Add-on Store UI<br/>[__init__.py]"]
  node_addon_manager["Add-on Data Manager<br/>[dataManager.py]"]
  node_addon_cache[("Add-on Cache<br/>[dataManager.py]")]
  node_remote_client["Remote Client<br/>[client.py]"]
  node_remote_relay["Remote Relay<br/>[server.py]"]
  node_native_controller["Native Controller API<br/>[nvdaController.cpp]"]
end

node_user(("User"))
node_windows_apps(("Windows Apps"))
node_remote_peer(("Remote Peer"))
node_synthesizer["Speech Synthesizer"]
node_braille_display["Braille Display"]
node_addon_service["Add-on Service"]

node_user -->|"provides input"| node_input_core
node_windows_apps -->|"exposes events"| node_iaccessible
node_windows_apps -->|"exposes UIA"| node_uia_handler
node_input_core -->|"dispatches input"| node_nvda_core
node_nvda_core -->|"runs handlers"| node_event_handler
node_event_handler -->|"updates objects"| node_nvda_objects
node_iaccessible -->|"creates objects"| node_nvda_objects
node_uia_handler -->|"creates objects"| node_nvda_objects
node_nvda_objects -->|"provides text"| node_virtual_buffers
node_virtual_buffers -->|"stores fields"| node_vbuf_storage
node_input_core -->|"dispatches gestures"| node_cursor_manager
node_cursor_manager -->|"speaks text"| node_speech_manager
node_speech_manager -->|"queues speech"| node_synth_drivers
node_synth_drivers -->|"renders speech"| node_synthesizer
node_cursor_manager -->|"updates output"| node_braille_handler
node_braille_handler -->|"drives displays"| node_braille_drivers
node_braille_drivers -->|"renders braille"| node_braille_display
node_user -->|"controls magnifier"| node_magnifier
node_magnifier -->|"tracks focus"| node_focus_manager
node_focus_manager -->|"reads positions"| node_windows_apps
node_user -.->|"requests recognition"| node_content_recognition
node_user -->|"manages add-ons"| node_addon_gui
node_addon_gui -->|"requests data"| node_addon_manager
node_addon_manager -.->|"fetches metadata"| node_addon_service
node_addon_manager -->|"reads and writes"| node_addon_cache
node_user -.->|"starts remote"| node_remote_client
node_remote_client -.->|"opens channel"| node_remote_relay
node_remote_peer -.->|"joins channel"| node_remote_relay
node_windows_apps -.->|"calls API"| node_native_controller

click node_input_core "https://github.com/nvaccess/nvda/blob/master/source/inputCore.py"
click node_event_handler "https://github.com/nvaccess/nvda/blob/master/source/eventHandler.py"
click node_nvda_core "https://github.com/nvaccess/nvda/blob/master/source/core.py"
click node_cursor_manager "https://github.com/nvaccess/nvda/blob/master/source/cursorManager.py"
click node_iaccessible "https://github.com/nvaccess/nvda/blob/master/source/IAccessibleHandler/__init__.py"
click node_uia_handler "https://github.com/nvaccess/nvda/blob/master/source/UIAHandler/__init__.py"
click node_nvda_objects "https://github.com/nvaccess/nvda/blob/master/source/NVDAObjects/__init__.py"
click node_virtual_buffers "https://github.com/nvaccess/nvda/blob/master/source/virtualBuffers/__init__.py"
click node_vbuf_storage "https://github.com/nvaccess/nvda/blob/master/nvdaHelper/vbufBase/storage.cpp"
click node_speech_manager "https://github.com/nvaccess/nvda/blob/master/source/speech/manager.py"
click node_synth_drivers "https://github.com/nvaccess/nvda/blob/master/source/synthDrivers/__init__.py"
click node_braille_handler "https://github.com/nvaccess/nvda/blob/master/source/braille/brailleHandler.py"
click node_braille_drivers "https://github.com/nvaccess/nvda/blob/master/source/brailleDisplayDrivers/__init__.py"
click node_magnifier "https://github.com/nvaccess/nvda/blob/master/source/_magnifier/magnifier.py"
click node_focus_manager "https://github.com/nvaccess/nvda/blob/master/source/_magnifier/utils/focusManager.py"
click node_content_recognition "https://github.com/nvaccess/nvda/blob/master/source/contentRecog/__init__.py"
click node_addon_gui "https://github.com/nvaccess/nvda/blob/master/source/gui/addonStoreGui/__init__.py"
click node_addon_manager "https://github.com/nvaccess/nvda/blob/master/source/addonStore/dataManager.py"
click node_addon_cache "https://github.com/nvaccess/nvda/blob/master/source/addonStore/dataManager.py"
click node_remote_client "https://github.com/nvaccess/nvda/blob/master/source/_remoteClient/client.py"
click node_remote_relay "https://github.com/nvaccess/nvda/blob/master/source/_remoteClient/server.py"
click node_native_controller "https://github.com/nvaccess/nvda/blob/master/nvdaHelper/local/nvdaController.cpp"

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_input_core,node_event_handler,node_nvda_core,node_cursor_manager,node_user toneBlue
class node_iaccessible,node_uia_handler,node_nvda_objects,node_virtual_buffers,node_vbuf_storage toneAmber
class node_speech_manager,node_synth_drivers,node_braille_handler,node_braille_drivers toneMint
class node_magnifier,node_focus_manager,node_content_recognition toneRose
class node_addon_gui,node_addon_manager,node_addon_cache,node_remote_client,node_remote_relay,node_native_controller,node_windows_apps,node_remote_peer,node_synthesizer,node_braille_display,node_addon_service toneIndigo
```

## Components

### Runtime Orchestration

- [Input Handling](https://github.com/nvaccess/nvda/blob/master/source/inputCore.py): `source/inputCore.py`
- [Event Handling](https://github.com/nvaccess/nvda/blob/master/source/eventHandler.py): `source/eventHandler.py`
- [NVDA Core](https://github.com/nvaccess/nvda/blob/master/source/core.py): `source/core.py`
- [Cursor Manager](https://github.com/nvaccess/nvda/blob/master/source/cursorManager.py): `source/cursorManager.py`

### Accessibility and Text

- [IAccessible Bridge](https://github.com/nvaccess/nvda/blob/master/source/IAccessibleHandler/__init__.py): `source/IAccessibleHandler/__init__.py`
- [UIA Bridge](https://github.com/nvaccess/nvda/blob/master/source/UIAHandler/__init__.py): `source/UIAHandler/__init__.py`
- [NVDA Objects](https://github.com/nvaccess/nvda/blob/master/source/NVDAObjects/__init__.py): `source/NVDAObjects/__init__.py`
- [Virtual Buffers](https://github.com/nvaccess/nvda/blob/master/source/virtualBuffers/__init__.py): `source/virtualBuffers/__init__.py`
- [Text Tree Storage](https://github.com/nvaccess/nvda/blob/master/nvdaHelper/vbufBase/storage.cpp): `nvdaHelper/vbufBase/storage.cpp`

### Output Channels

- [Speech Manager](https://github.com/nvaccess/nvda/blob/master/source/speech/manager.py): `source/speech/manager.py`
- [Synth Drivers](https://github.com/nvaccess/nvda/blob/master/source/synthDrivers/__init__.py): `source/synthDrivers/__init__.py`
- [Braille Handler](https://github.com/nvaccess/nvda/blob/master/source/braille/brailleHandler.py): `source/braille/brailleHandler.py`
- [Braille Drivers](https://github.com/nvaccess/nvda/blob/master/source/brailleDisplayDrivers/__init__.py): `source/brailleDisplayDrivers/__init__.py`

### Vision Assistance

- [Magnifier](https://github.com/nvaccess/nvda/blob/master/source/_magnifier/magnifier.py): `source/_magnifier/magnifier.py`
- [Focus Manager](https://github.com/nvaccess/nvda/blob/master/source/_magnifier/utils/focusManager.py): `source/_magnifier/utils/focusManager.py`
- [Content Recognition](https://github.com/nvaccess/nvda/blob/master/source/contentRecog/__init__.py): `source/contentRecog/__init__.py`

### Extensions and Connectivity

- [Add-on Store UI](https://github.com/nvaccess/nvda/blob/master/source/gui/addonStoreGui/__init__.py): `source/gui/addonStoreGui/__init__.py`
- [Add-on Data Manager](https://github.com/nvaccess/nvda/blob/master/source/addonStore/dataManager.py): `source/addonStore/dataManager.py`
- [Add-on Cache](https://github.com/nvaccess/nvda/blob/master/source/addonStore/dataManager.py): `source/addonStore/dataManager.py`
- [Remote Client](https://github.com/nvaccess/nvda/blob/master/source/_remoteClient/client.py): `source/_remoteClient/client.py`
- [Remote Relay](https://github.com/nvaccess/nvda/blob/master/source/_remoteClient/server.py): `source/_remoteClient/server.py`
- [Native Controller API](https://github.com/nvaccess/nvda/blob/master/nvdaHelper/local/nvdaController.cpp): `nvdaHelper/local/nvdaController.cpp`

### Other components

- **User**
- **Windows Apps**
- **Remote Peer**
- **Speech Synthesizer**
- **Braille Display**
- **Add-on Service**

## Connections

- User → Input Handling: provides input
- Windows Apps → IAccessible Bridge: exposes events
- Windows Apps → UIA Bridge: exposes UIA
- Input Handling → NVDA Core: dispatches input
- NVDA Core → Event Handling: runs handlers
- Event Handling → NVDA Objects: updates objects
- IAccessible Bridge → NVDA Objects: creates objects
- UIA Bridge → NVDA Objects: creates objects
- NVDA Objects → Virtual Buffers: provides text
- Virtual Buffers → Text Tree Storage: stores fields
- Input Handling → Cursor Manager: dispatches gestures
- Cursor Manager → Speech Manager: speaks text
- Speech Manager → Synth Drivers: queues speech
- Synth Drivers → Speech Synthesizer: renders speech
- Cursor Manager → Braille Handler: updates output
- Braille Handler → Braille Drivers: drives displays
- Braille Drivers → Braille Display: renders braille
- User → Magnifier: controls magnifier
- Magnifier → Focus Manager: tracks focus
- Focus Manager → Windows Apps: reads positions
- User → Content Recognition: requests recognition
- User → Add-on Store UI: manages add-ons
- Add-on Store UI → Add-on Data Manager: requests data
- Add-on Data Manager → Add-on Service: fetches metadata
- Add-on Data Manager → Add-on Cache: reads and writes
- User → Remote Client: starts remote
- Remote Client → Remote Relay: opens channel
- Remote Peer → Remote Relay: joins channel
- Windows Apps → Native Controller API: calls API
