Skip to main content
BWTAv0.11.0

Help

Braille Translation Web App

Tags & Codes Reference

Complete guide to all tags, control codes, keyboard shortcuts, and BANA formatting rules.

View Reference
Getting Started

BWTA converts documents into braille. Upload a file, choose your translation options, then open the editor to review and refine the output.

To upload a file:

  1. Click the upload area on the home page, or drag and drop a file onto it.
  2. Choose your braille code, grade, and math notation (if applicable).
  3. Click Open Editor to translate and edit.

Supported formats:

  • PDF, DOCX, TXT, HTML, Markdown, EPUB
  • Images (PNG, JPG) — OCR extraction

Maximum file size: 50 MB.

Translation Options

After uploading a file you can configure how it will be translated:

  • Braille CodeUEB (Unified English Braille, the current international standard) or EBAE (English Braille American Edition, the legacy US standard).
  • GradeGrade 1 (uncontracted, letter-for-letter) or Grade 2 (contracted, uses abbreviations for common words).
  • Math Notation (shown when math is detected) —Nemeth Code or UEB Math.

Your selections are saved in your browser and will be remembered the next time you visit.

The Editor

The editor shows your source document and braille output side by side:

  • Left pane (Format) — Your source document with tags that control structure and formatting. Edit the text, add headings, lists, emphasis, and braille control codes. Tags are highlighted in blue, math in purple, and control codes in amber.
  • Right pane (Braille) — The formatted braille output displayed in simulated braille font. Shows page breaks and page numbers matching your page size settings. You can also edit the braille directly.
  • Settings sidebar — Configure page size, page numbering, braille code (UEB/EBAE), grade, and math notation. Click Apply Settings to re-translate with new settings.

Changes in the left pane automatically update the braille on the right. The toolbar provides download buttons for BRF, eBraille, Markdown, and EPUB exports.

Format Pane (Left Side)

The format pane shows your source document with tags that control braille formatting. Select text and apply formatting with keyboard shortcuts:

ShortcutAction
Ctrl+1–6Heading 1–6
Ctrl+PParagraph
Ctrl+BBold
Ctrl+IItalic
Ctrl+LList Item
Ctrl+MMath
Ctrl+ZUndo
Ctrl+Shift+ZRedo

Use the tag buttons in the toolbar to insert or toggle tags. Right-click for options including Remove Tag and Insert Code (for braille control codes like page breaks and grade changes).

See the Tags & Codes Reference for a complete guide to all tags and control codes.

Braille Pane (Right Side)

The braille pane shows the formatted braille output in a simulated braille font. It displays page breaks and page numbers according to your page size settings.

You can edit the braille directly by clicking into a segment and typing. Use the arrow keys to navigate — up/down moves by line, left/right by character.

Page settings (in the sidebar):

  • Page size — LETTER (32 cells × 25 lines) or WIDE (40 cells × 25 lines), or custom
  • Page numbering — position (bottom-right, bottom-left, top-right, top-left, or none)
Exporting

From the editor toolbar, click Export to download your work:

  • BRF — Braille Ready Format. The standard file format for braille embossers. Includes page layout and numbering.
  • eBraille (.ebrl) — A ZIP archive containing the braille content in HTML format. Used for digital braille reading.
  • Markdown — The tagged source document in Markdown format.
  • EPUB — The source document as an accessible e-book.
Saving & Loading

Saving requires an account. Click Sign In in the header to register or log in.

To save your work:

  1. Open the editor with a translated document.
  2. Click Save in the toolbar.
  3. Give your work a name (or keep the auto-generated one).

To load a saved work:

  1. Sign in to your account.
  2. Open the user menu (your name in the header).
  3. Select My Works to see your saved documents.
  4. Click a work to open it in the editor.
Keyboard Shortcuts
ShortcutActionMode
Ctrl+1–6Heading 1–6Format
Ctrl+BBoldFormat
Ctrl+IItalicFormat
Ctrl+LList ItemFormat
Ctrl+QBlockquoteFormat
Ctrl+ZUndoAll
Ctrl+Shift+ZRedoAll
f d sDots 1 2 3Braille
j k lDots 4 5 6Braille
FAQ & Tips

Can I use BWTA without an account?

Yes. You can upload, translate, edit, and export without signing in. An account is only needed to save and load works.

My PDF didn't parse correctly. What can I do?

Scanned PDFs (image-only) may not extract text well. Try exporting the document to DOCX or TXT from the original application before uploading.

What braille tables does BWTA use?

BWTA uses liblouis, the open-source braille translation library, with official UEB and EBAE tables.

How do I report a bug or request a feature?

Use the button in the bottom-left corner of any page to submit bug reports, feature requests, or general feedback.

Send Feedback