Skip to content

Canute with BRLTTY on Windows 10

pachpict edited this page Jul 29, 2021 · 8 revisions

N.B. Reasonably high level of technical competence recommended for attempting the following, including familiarity with the Windows Command Prompt and Devices Manager.

Find BRLTTY here: https://brltty.app/index.html

Instructions for setting up

N.B. These install instructions assume a fresh install of BRLTTY. This has not yet been tested for clashes with other screen-readers, such as NVDA or Narrator.

  • Ensure Windows 10 is up-to-date.

  • Install BRLTTY, making sure to use a version no older that v6.1.

  • Set BRLTTY up to talk to Canute 360, following the instructions from the BRLTTY Reference Manual

  • $> brltty -d cn

(Instruction set TBA. Meanwhile please contact enquiries@bristolbraille.co.uk.)

Instructions for developers using BRLTTY to drive Canute

Useful commands for controlling BRLTTY+Canute for specific applications:

  • FREEZE (because Canute can only refresh one line per second, roughly 9 seconds per page, so in some circumstances better to avoid rapid window changes being reflected on the Canute until you choose).

  • WINUP/WINDN (to specify changes by nine lines).

  • SIXDOTS (Canute is 6-dot).

  • FollowFocus=No (so a GUI application can update a console window in the background, thus allowing the user to use GUI applications while Canute continues to read from the in-focus console in the background).

Instructions for developers using BrlAPI to drive Canute

"Brltty has an API known as BrlAPI that works over TCP/IP or over a local socket (on Windwos that'd be a naemd pipe). The best way, therefore, would be to run brltty, telling it to use its Canute driver, and to communicate with brltty via BrlAPI. NVDA on Windows, and Orca on Linux, are examples of applications that use BrlAPI." --- D Mielke


See BRLTTY