Skip to main content

Overview

NVDA provides comprehensive support for braille displays, allowing you to read NVDA’s output in braille and enter text using a braille keyboard. Braille settings control which display is used, how information is presented, and how braille input is handled. Access Braille Settings: Press NVDA+control+a or navigate to Preferences > Settings > Braille in the NVDA menu.

Braille Display Selection

Choosing a Display

1

Open Braille Settings

Press NVDA+control+a to open the Braille category directly.
2

Select Display

In the Display dropdown, choose:
  • Automatic (recommended) - Detects connected displays automatically
  • Your specific display model
  • No braille - Disable braille output
3

Configure Connection (if needed)

Some displays require you to specify:
  • Connection port (USB, Bluetooth, Serial)
  • Baud rate (for serial connections)
4

Click OK

NVDA will connect to the selected display immediately.
The Automatic setting uses background detection to find and connect to supported displays automatically. This is the most convenient option for most users.

Supported Displays

NVDA supports a wide range of braille displays, including:
  • Freedom Scientific (Focus, PAC Mate)
  • Handy Tech (various models)
  • HIMS (Braille Sense, Braille Edge)
  • HumanWare (Brailliant, BrailleNote)
  • Papenmeier (BRAILLEX series)
  • Baum/VisioBraille (various models)
  • Eurobraille (Esys, Esytime, b.book)
  • Alva (BC series)
  • And many more…
For a complete list with key assignments, see the Supported Braille Displays section of the User Guide.

Automatic Display Detection

Automatic display detection
feature
When set to Automatic, NVDA continuously scans for supported braille displays in the background.How it works:
  • Checks USB connections
  • Scans Bluetooth devices
  • Automatically connects when a display is found
  • Reconnects if connection is lost
Excluded displays: Some displays are excluded from automatic detection by default due to potential conflicts. You can configure which displays to exclude in Braille Settings under the Automatic section.
Some displays may require driver installation before NVDA can detect them. Check your display manufacturer’s instructions.

Translation Tables

Translation tables define how text is converted to braille and vice versa.

Output Translation Table

Translation table
dropdown
default:"Unified English Braille Grade 1"
The translation table used to convert text to braille for display.Common options:
  • Unified English Braille (UEB) Grade 1 - Uncontracted braille
  • Unified English Braille (UEB) Grade 2 - Contracted braille
  • Computer Braille (8-dot) - Shows all characters including control codes
  • Language-specific tables (e.g., French, German, Spanish)
Grade 2 braille is more compact but requires knowledge of braille contractions.

Input Translation Table

Input table
dropdown
default:"Unified English Braille Grade 1"
The translation table used to interpret braille input from your display’s keyboard.Typical options:
  • Unified English Braille (UEB) Grade 1 - Uncontracted
  • Unified English Braille (UEB) Grade 2 - Contracted
  • Computer Braille (8-dot)
  • Language-specific input tables
The input table can be different from the output table. For example, you might read in Grade 2 but enter text in Grade 1.

Braille Mode

Braille mode
option
default:"Follow cursors"
Controls what information is displayed on the braille display.Options:Follow cursors - Shows text at the cursor position (most common)
  • Displays content at system focus or review cursor
  • Automatically switches context as you navigate
Speech output - Shows what NVDA is currently speaking
  • Displays spoken messages on braille
  • Useful for following speech output in braille

Cursor Settings

Cursor Display

Show cursor
boolean
default:"true"
Shows a cursor on the braille display to indicate position.When enabled, the braille cursor indicates:
  • Focus position (system cursor)
  • Review cursor position
Makes the cursor blink to make it easier to locate.
Range: 200-2000 millisecondsControls how fast the cursor blinks.
  • 200ms: Very fast blink
  • 500ms: Medium speed (default)
  • 2000ms: Slow blink

Cursor Shape

Cursor shape for focus
8-dot pattern
default:"192"
Range: 1-255Defines which dots are raised to show the focus cursor.Default value 192 = dots 7 and 8 (bottom two dots)
This is a binary representation of an 8-dot braille cell where each bit represents a dot.
Cursor shape for review
8-dot pattern
default:"128"
Range: 1-255Defines which dots are raised to show the review cursor.Default value 128 = dot 8 only

Display Behavior

Tethering

Tether to
option
default:"Automatically"
Controls what the braille display follows.Options:
  • Automatically: Follows focus by default, but follows review cursor when explicitly moved
  • Focus: Always follows the system focus/caret
  • Review: Always follows the review cursor
Keyboard shortcut: NVDA+control+t (cycles through options)

Text Presentation

Read by paragraph
boolean
default:"false"
When enabled, braille displays text by paragraphs instead of by lines.Benefits:
  • More natural reading flow
  • Better context when reading
Drawback:
  • May require more panning for long paragraphs
Word wrap
boolean
default:"true"
Prevents words from being split across the edge of the display.When enabled:
  • Words stay together
  • May leave empty cells at line end
When disabled:
  • Uses full display width
  • Words may be split
Expand at cursor
boolean
default:"true"
When reading contracted braille (Grade 2), automatically expands the word at the cursor to uncontracted braille.Example: Shows full spelling at cursor position even when rest of display uses contractions.

Message Display

Show messages
option
default:"Use timeout"
Controls how messages appear on the braille display.Options:
  • Disabled: Don’t show messages on braille
  • Use timeout: Show messages temporarily, then restore previous content
  • Show indefinitely: Messages remain until dismissed
Message timeout
integer
default:"4"
Range: 1-20 secondsHow long messages remain visible when “Use timeout” is selected.

Context Information

Focus context presentation
option
default:"Changed context"
Controls how context information is displayed when focus changes.Options:Changed context - Only shows context that has changed
  • Most efficient use of display space
  • Only shows new information
Fill display - Shows as much context as possible
  • More complete context
  • May obscure focus content
Scroll display - Scrolls context onto display as needed
  • Keeps focus item visible
  • Shows context progressively

Selection Display

Show selection
feature flag
default:"enabled"
When enabled, selected text is indicated using dots 7 and 8.Useful for:
  • Knowing what text is selected
  • Editing operations
  • Visual feedback in braille

Advanced Braille Settings

Unicode Normalization

Unicode normalization
feature flag
default:"disabled"
Normalizes Unicode characters before converting to braille.May improve braille rendering for:
  • Accented characters
  • Special symbols
  • Mathematical notation

Paragraph Markers

Paragraph start marker
option
default:"None"
Marks the beginning of paragraphs in braille.Options:
  • None: No marker
  • Space: Single space before paragraphs
  • Pilcrow (¶): Paragraph symbol

Routing Behavior

Review routing moves system caret
feature flag
default:"Never"
Controls whether routing to a position while in review mode moves the system caret.Options:
  • Never: Routing only moves review cursor
  • Always: Routing also moves system caret
  • When in native focus mode: Context-dependent
Speak on routing
boolean
default:"false"
When enabled, NVDA speaks the character or word you route to.
Speak on navigating by unit
boolean
default:"false"
When enabled, NVDA speaks content when navigating by character, word, or line using braille display keys.

Speech Integration

Interrupt speech while scrolling
feature flag
default:"enabled"
When enabled, scrolling the braille display interrupts speech.Benefits:
  • Reduces audio clutter
  • Lets you read silently in braille
When disabled:
  • Speech continues while scrolling
  • Useful for simultaneous audio and braille feedback

Live Regions

Report live regions
feature flag
default:"enabled"
When enabled, NVDA shows ARIA live region updates in braille.Examples of live regions:
  • Chat messages
  • Stock tickers
  • Social media notifications
  • Dynamic web content

Font Formatting

Font formatting display
feature flag
default:"LibLouis"
Controls how font formatting is shown in braille.Options:
  • LibLouis: Uses LibLouis-based formatting indicators
  • Text attributes: Shows text formatting descriptions
  • Off: No formatting indicators

Braille Input

Many braille displays have braille keyboards for text entry.

Input Methods

Text is entered one character at a time as you type.Benefits:
  • Simple and predictable
  • No need to know contractions
  • Immediate feedback
Use: General text entry, learning braille
Text is buffered until you press space or enter, then translated.Benefits:
  • Faster input for experienced users
  • More efficient
Requirement: Must know braille contractionsUse: Fast note-taking, experienced braille users
Eight-dot braille representing ASCII characters.Benefits:
  • Can enter any character
  • Useful for programming
  • Shows control characters
Use: Programming, technical work

Standard Braille Commands

These are standard braille input commands. Your specific display may have additional keys.
  • Dot 7: Backspace (erases last cell/character)
  • Dot 8: Enter (submit braille input)
  • Dot 7 + Dot 8: Translate without adding space or pressing enter

Braille Viewer

The Braille Viewer shows braille output on screen, useful for:
  • Sighted people learning braille
  • Demonstrations and training
  • Debugging braille output
  • Working without a physical display

Enabling Braille Viewer

From menu: NVDA menu > Tools > Braille Viewer From Braille Viewer settings:
Show Braille Viewer at startup
boolean
default:"false"
When enabled, Braille Viewer opens automatically when NVDA starts.
Should hover route to cell
boolean
default:"false"
When enabled, hovering over a braille cell with the mouse will route to that position.
Seconds of hover to activate
float
default:"1.0"
Range: 0.0+How long to hover before routing activates.
Default cell count
integer
default:"40"
Range: 20-160Number of braille cells to display in the Braille Viewer window.

Troubleshooting Braille

Check:
  1. Display is powered on and connected
  2. USB/Bluetooth connection is active (check Windows device manager)
  3. Display drivers are installed (if required)
  4. Display is not in use by another screen reader
  5. Try “Automatic” in display selection
  6. Try manually selecting your specific display model
For Bluetooth:
  • Pair the display in Windows Bluetooth settings first
  • Some displays require a specific pairing mode
Check:
  1. Correct translation table is selected
  2. Language settings match your content
  3. Unicode normalization setting (try toggling)
  4. Display firmware is up to date
  5. Try Computer Braille to see raw output
For Grade 2 issues:
  • Verify you’re using the correct grade (1 vs 2)
  • Check if “Expand at cursor” helps
Check:
  1. “Show cursor” is enabled
  2. “Cursor blink” is enabled
  3. Cursor shape is properly configured (non-zero value)
  4. Display isn’t in a special mode
  5. Try changing cursor shape to 255 (all dots)
Check:
  1. Input table is configured
  2. Display is in braille keyboard mode (not QWERTY mode)
  3. Display keyboard is enabled in display settings
  4. Try computer braille input table
Note: Some displays can toggle between braille and QWERTY keyboard modes.
Possible causes:
  1. USB power management (disable in device properties)
  2. Bluetooth interference or range issues
  3. Faulty cable
  4. Low battery on wireless displays
  5. USB hub problems (try direct connection)
Solution: Try using “Automatic” display detection for auto-reconnection.

Braille-Specific Keyboard Commands

Global Braille Commands

ActionCommand
Scroll braille display backNVDA+leftArrow
Scroll braille display forwardNVDA+rightArrow
Tether braille toNVDA+control+t
Braille settingsNVDA+control+a
Display-specific commands vary by manufacturer. Consult your display’s documentation for routing keys, scrolling buttons, and other hardware controls.

Build docs developers (and LLMs) love