How nvaccess/nvda works
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: __init__.py NVDA Objects · inputCore.py Input Handling · cursorManager.py Cursor Manager · dataManager.py Add-on Data Manager
Components 28
Runtime Orchestration
- Input Handling
source/inputCore.py - Event Handling
source/eventHandler.py - NVDA Core
source/core.py - Cursor Manager
source/cursorManager.py
Accessibility and Text
- IAccessible Bridge
source/IAccessibleHandler/__init__.py - UIA Bridge
source/UIAHandler/__init__.py - NVDA Objects
source/NVDAObjects/__init__.py - Virtual Buffers
source/virtualBuffers/__init__.py - Text Tree Storage
nvdaHelper/vbufBase/storage.cpp
Output Channels
- Speech Manager
source/speech/manager.py - Synth Drivers
source/synthDrivers/__init__.py - Braille Handler
source/braille/brailleHandler.py - Braille Drivers
source/brailleDisplayDrivers/__init__.py
Vision Assistance
- Magnifier
source/_magnifier/magnifier.py - Focus Manager
source/_magnifier/utils/focusManager.py - Content Recognition
source/contentRecog/__init__.py
Extensions and Connectivity
- Add-on Store UI
source/gui/addonStoreGui/__init__.py - Add-on Data Manager
source/addonStore/dataManager.py - Add-on Cache
source/addonStore/dataManager.py - Remote Client
source/_remoteClient/client.py - Remote Relay
source/_remoteClient/server.py - Native Controller API
nvdaHelper/local/nvdaController.cpp
Other components
- User
- Windows Apps
- Remote Peer
- Speech Synthesizer
- Braille Display
- Add-on Service
Connections 29
- 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