MBraille Gesture Cheat Sheet

Swipe Direction Convention:
MBraille uses the braille cell itself to define directions:
• Right: Direction from dot 1 to dot 4
• Left: Direction from dot 4 to dot 1
• Up/Down: You choose this when you initialize the keyboard

One-Finger Swipes

Swipe Right

Insert a space (triggers contraction expansion)

Swipe Left

Delete previous character (backspace)

Swipe Down

Insert newline (triggers contraction expansion)

Swipe Up

Read what you have written

Two-Finger Swipes

Two-Finger Swipe Left

Delete previous word

Two-Finger Swipe Right

Insert newline (iOS/Android compatibility)

Two-Finger Swipe Up

Repeat last thing spoken

Three-Finger Swipes

Three-Finger Swipe Left

Undo (reverses edits, closes read-only files)

Three-Finger Swipe Down

Erase/clear all text (or close read-only file)

Three-Finger Swipe Up

Enter command mode

Four-Finger Swipes

Four-Finger Swipe Up

Return to previous screen

Four-Finger Swipe Right

Reset keyboard layout

Four-Finger Swipe Left

Close file

Hold Dot 1 + Swipe (Spelling Corrections)

Hold Dot 1 + Swipe Up

Previous spelling suggestion

Hold Dot 1 + Swipe Down

Next spelling suggestion

Hold Dot 1 + Swipe Right

Spell out current suggestion (reports count)

Hold Dot 1 + Swipe Left

Add word to spelling dictionary

Hold Dot 1 + Two-Finger Swipe Up

Context-sensitive help

Hold Dot 2 + Swipe (Clipboard)

Hold Dot 2 + Swipe Down

Paste text at insertion point

Hold Dot 2 + Swipe Up

Hear what's in clipboard

Hold Dot 3 + Swipe (Preview & Navigation)

Hold Dot 3 + Swipe Left

Move to previous item (word/character/etc.)

Hold Dot 3 + Swipe Right

Move to next item (word/character/etc.)

Hold Dot 3 + Swipe Up

Change preview granularity up / Read character & word count

Hold Dot 3 + Swipe Down

Change preview granularity down

Hold Dot 3 + Two-Finger Swipe Left

Read from beginning to cursor

Hold Dot 3 + Two-Finger Swipe Right

Read from cursor to end

Hold Dot 4 + Swipe (Command History)

Hold Dot 4 + Swipe Up

Previous command in history (or enter last command)

Hold Dot 4 + Swipe Down

Next command in history

Hold Dot 5 + Swipe (Alias Shortcuts)

Hold Dot 5 + Swipe Up

Execute alias bound to 5u (configurable in alias.mb)

Hold Dot 5 + Swipe Right

Execute alias bound to 5r (configurable in alias.mb)

Hold Dot 5 + Swipe Down

Execute alias bound to 5d (configurable in alias.mb)

Hold Dot 5 + Swipe Left

Execute alias bound to 5l (configurable in alias.mb)

Hold Dot 6 + Swipe (Contractions)

Hold Dot 6 + Swipe Up

Toggle contracted braille on/off

Hold Dot 6 + Swipe Down

Toggle contracted braille on/off

Hold Dots 1 & 3 + Swipe (Navigation & Bookmarks)

Hold Dots 1 & 3 + Swipe Left

Jump to beginning of text

Hold Dots 1 & 3 + Swipe Right

Jump to end of text

Hold Dots 1 & 3 + Two-Finger Swipe Down

Drop bookmark at current position

Hold Dots 1 & 3 + Two-Finger Swipe Right

Jump to next bookmark in current file

Hold Dots 1 & 3 + Two-Finger Swipe Left

Jump to previous bookmark in current file

Hold Dots 2 & 3 + Swipe (Text Selection)

Hold Dots 2 & 3 + Swipe Left

Select previous item (extends selection left)

Hold Dots 2 & 3 + Swipe Right

Select next item (extends selection right)

Hold Dots 2 & 3 + Swipe Up

Copy selected text

Hold Dots 2 & 3 + Swipe Down

Cut selected text

Hold Dots 2 & 3 + Two-Finger Swipe Up

Speak the current selection

Hold Dots 1, 2 & 3 + Swipe (Quick Selection)

Hold Dots 1, 2 & 3 + Swipe Left

Select from cursor to beginning of text

Hold Dots 1, 2 & 3 + Swipe Right

Select from cursor to end of text

Note: The order of pressing dots 1, 2, and 3 doesn't matter - any combination (123, 321, 132, 213, 231, 312) works the same way.

Hold Dots 4, 5 & 6 + Swipe (Search)

Hold Dots 4, 5 & 6 + Swipe Up

Enter search mode (search backwards)

Hold Dots 4, 5 & 6 + Swipe Down

Enter search mode (search forwards)

In Search Mode: Type your search string and swipe down for newline to execute the search. Swipe down again to find next match. Hold dots 4, 5 & 6 and swipe again to exit search mode.

Special Gestures

Two-Finger Scrub (Right-Left-Right)

Go back / Close file / Exit (ESC), same as 4 finger swipe up.

Shake Device

Clear all text (alternative to 3-finger swipe down)

Additional Features

Automatic Clipboard Copy

When you switch from MBraille to another application, your current text is automatically copied to the clipboard, making it easy to paste elsewhere.

Preview Granularity

While previewing with dot 3 held, you can cycle through different reading granularities:

Character by character
Word by word
Sentence by sentence
Line by line
Paragraph by paragraph
Spelling errors (if enabled in settings)
Headings (for Markdown files)

MBraille - A powerful braille keyboard for iOS and Android

For more information, see the built-in help in main menu, (Or command: help)

🔤 MBraille Gesture Cheat Sheet