- MBraille - lists.mpaja.com

Dialing phone numbers with extensions
by Joseph Garcia Aug. 15, 2026

Aug. 15, 2026

Hi Harry, How can I get the new Mbraille to dial a phone number with an extension? Using previous version of Mbraille I was able to create an alias with a phone number and extension and use it to call someone. For example, .Dial 8442223333,12222 With the new version of Mbraille I go into command mode to make my phone call, but I am told "Failed to look up phone number for 8442223333,12222." This is a total show-stopper. How can I make my calls with extensions using the new version of Mbraille? Thanks

1 0

Version 26.3.1 available
by Harri Pasanen July 26, 2026

July 26, 2026

Hi, This version with some fixes is now available in appstores both for Android and iOS. Best regards, Harri

1 0

MBraille web pages updated
by Harri Pasanen July 19, 2026

July 19, 2026

Hi all, Just heads up, that I updated https://mpaja.com/mbraille/ web pages to have localized versions for all languages MBraille supports. There is also a link to gesture cheat sheet for a quick reference which may be handy. Best regards, Harri

1 0

MBraille Desktop for Windows
by Harri Pasanen July 3, 2026

July 3, 2026

Hi all, I updated MBraille Desktop for Windows. It is now fully self-voicing, as NVDA and JAWS had trouble navigating it fully. So the advice is to suspend those while using MBraille. https://apps.microsoft.com/detail/9pc8z5m4vnz1 Windows version is a free application, meant for learning Braille, so suitable for educators, students, etc. Like mobile versions, it is localized to 24 languages. Best regards, Harri

1 0

MBraille acting weird
by Joseph Garcia June 27, 2026

June 27, 2026

HI all, I'm a long time user of Mbraille. It has proven itself to be very, very stable for the 10 or so years I've used it. That is, until maybe a few weeks ago. I think Mbraille has been updated because many gestures and swipes have changed. If it has been updated, then this might be the source of my problems. I can't seem to get the .dial command to work. That is, when I try to dial a number and flick down to have the phone app open, nothing happens other than a return character is being entered. Normally I would type the following: .dial 5554443322 I would then flick down and the Phone app showed. Now, like I said, nothing happens. I would be grateful for any explanation. 😊 THANK YOU Joseph

2 1

To Do items
by Harri Pasanen June 18, 2026

June 18, 2026

Hi, Just a quick note on things I'm planning to work on next: - Need to fix the ai command, as someone "stole the key", is using it and I'm paying the bills for that usage. So until I get it fixed, the AI command main not work at all. - Some users have trouble initializing the keyboard. One should not need to do it often, as the keyboard layout is saved, and small deviations in finger positions are automatically adjusted for. Nevertheless, I will bring back the fixed away layout as an option. Those are the first priorities for me, but there are plenty of other development items left for me to work on once those are out of the way. Best regards, Harri

1 0

from gmail, does this come through
by Harri Pasanen Oct. 5, 2025

Oct. 5, 2025

Does this work for you?

1 0

testing
by Harri Pasanen Oct. 5, 2025

Oct. 5, 2025

mailing list test Best regards, Harri

1 0

List test
by Harri Pasanen Oct. 5, 2025

Oct. 5, 2025

Check if the list is working

1 0

First post
by Harri Pasanen Sept. 26, 2025

Sept. 26, 2025

As a test, below is the full MBraille development version help as of Sep 26. # Introducing the Braille keyboard Before you can start typing, you have to first set the buttons for each braille dot. You decide how to place the dots. You need to enter each dot position in order from one to six. MBraille remembers the position of each dot, but you can always reprogram the dots if you have forgotten. Reinitialize the layout with a long swipe with one finger. Note that in the layout the dot positions are not entirely fixed but allow for your hand positions to drift while still keeping the input accurate. # Using the keyboard The braille key input begins when one finger goes down and ends when all fingers are lifted. You can tap all the dots simultaneously or in sequence as long as at least one finger remains on the screen. iPhone has the small restriction that it does not distinguish 6 simultaneous touches, so the contraction for the word "for" requires some finger gymnastics. For example, you can put down fingers on dots 1, 2, 3, 4, 5, lift any of the previous fingers, then hit dot 6, and finally lift all fingers. The order of hitting the dots does not matter. By default, contracted Braille is used, but it can be turned off from settings. To quickly turn contractions on and off while entering text, hold down dot 6 with one finger and flick up or down with another finger. ## Swipe gestures MBraille swipe gestures work best when they are short and fast. Only the gesture requiring a long swipe is the one-finger swipe to reinitialize the smart layout. If you are accidentally reinitializing the smart layout or have trouble dismissing the keyboard, try using shorter and faster swipes. ## Swipe directions To refer to swipe direction confusion can arise depending on how you hold your phone or tablet. So the directions are taken from the Braille characters themselves and the following convention is used: Right: Direction from dot 1 to dot 4 Left: Direction from dot 4 to dot 1 Down: Directly to right from the line from dot 1 to dot 4 Up: Directly to left from the line from dot 1 to dot 4 ## One-finger swipes Swipe right to enter a space. Swipe down to enter a newline. Both space and newline trigger the expansion of contractions in the preceding word. Swipe left to delete the previous character. Swipe up to hear what you have written. ## Two-finger swipes Two finger swipe left to delete last word. Two finger swipe right for newline. This is the same a swipe down in MBraille, but provided for compatibility with iOS and Android braille input. Two finger swipe down to read from cursor to end of text. Two finger swipe up to hear number of characters and words in the text. ## Three-finger swipes Three-Finger Swipe Left: Undo Reverses recent actions, including text edits (cuts, deletions, clearing), and closes read-only files. Three-Finger Swipe Down: Erase/Close Erases all current writing. Alternatively, shake the device to erase. For read-only files, this closes the file and restores the previous content. Three-Finger Swipe Up: Command Mode Opens the command interface for advanced actions, such as sending text messages, and managing files (open, save). See "Commands" below for details. ## Clipboard If you switch to another application from MBraille, the current text is automatically copied to the clipboard. You can then paste the text in the other application. Then just open the app switcher and select MBraille to get back. To copy just a given block of text from MBraille to another application, mark and copy your block as described in the next topic and and invoke the app switcher. # Editing text You can do simple editing with MBraille, preview what you have written, and move text around by selecting, cutting, and pasting. You can even paste text from other applications into MBraille for editing. All editing gestures work on the same principle: use one hand to press and hold one or more braille dots to select the gesture, then swipe up, down, left, or right with your other hand to activate the selected gesture. When editing existing words or entering punctuation, it is often more convenient to use uncontracted Braille. To quickly toggle contractions on and off while entering text, hold down dot 6 with one finger and flick up or down with another finger. ## Previewing text and moving the insertion point Hold down braille dot 3 with one finger. Use another finger to flick left or right to have your text read word by word. Flick up or down to change the granularity of movement. You can move in the text by character, by word, by sentence, by line or by paragraph. To quickly read to the end of text from the cursor, flick right with two fingers while holding dot 3. Flick left with two fingers to read from beginning to cursor. The cursor position is not changed when you do this. You can move to the beginning of text by holding dots 1 and 3 and flicking left. You can move to the end of text by holding dots 1 and 3 and flicking right. ## Selecting, cutting, copying and pasting text Navigate in the text using the preview function. Once you have found your spot, press down dot 2 while still holding dot 3. With dots 2 and 3 held, moving around with flicks selects the text that is passed over. VoiceOver announces the selected text as you move. To hear the full selection, swipe up with two fingers while still holding dots 2 and 3. To copy the selected text, swipe up with dots 2 and 3 still held down. To cut the selected text, swipe down. To paste text at the insertion point, hold down dot 2 and flick down with another finger. Hold down dot 2 and flick up to hear what currently is in the clipboard. You can paste text you copied with MBraille copy or cut function, or text that you copied from another application. To quickly extend the selection to beginning or end of text, hold down dots 1,2,3 and swipe left or right. ## Searching Hold dots 4,5,6 and swipe up or down to enter search mode. The swipe direction determines the search direction: down for forward, up for backwards. Type your search string and swipe down for newline, at which point the string you entered is searched from current point to direction chosen. If found, the cursor is placed at beginning of match and line number and sentence it is in is announced. Swipe down again to find the next match. The search automatically wraps around at end or beginning. If it wraps you will hear an announcement. To get out of search mode hold dots 4,5,6 again and swipe up or down again. The input cursor is left at the position of last match. ## Spelling You can configure spelling aids in the MBraille settings. You have 3 options for spelling in settings: 1. Check spelling after each word, beeps on misspelled word. This is the master switch, if it is not on, you will not get spelling. 2. Only check spelling during preview by word. This modifies the spelling behavior so that you will not be interrupted by beeps when writing. 3. Spell out the suggested word. This affects how the proposed corrections are announced. So the first switch in settings is the master switch for enabling / disabling spelling. ### Correcting spelling mistakes When MBraille detects a spelling mistake, it can also suggests a list of possible corrections. You can select a suggestion with a gesture: When you hear a beep for a mistake while typing or previewing, you can immediately pick a suggestion from a list by holding down dot 1 and swiping up or down. The first choice in the list is the mistyped word, in case you wish to keep it. As soon as you lift your fingers, the correction is done and you can resume typing. If in the settings you have selected to automatically spell out the suggestions, you'll hear each suggestion similar to hello below. "hello, h,e,l,l,o" Regardless of the setting, you can force spelling out a suggestion by holding dot 1 and swiping right. That will also report the number of suggestions, like hello, h,e,l,l,o, 4 of 14 ### User spelling dictionary You can add the word you wrote to spelling dictionary by holding dot 1 for the first suggestion, which is the word that caused the beep, and swiping left. You will be asked for a confirmation to add the word to the spelling dictionary. .dict dot command will list the words in your user dictionary, allowing you to remove words. # Commands from the keyboard You can at any time execute commands from the braille keyboard. Swipe up with 3 fingers to enter the command mode and type your command followed by possible arguments, followed by a newline to run the command. In command mode you can type and edit your command as usual with braille, but the command buffer is kept completely separate from your regular text. So if you go to beginning of text or end of text in command mode, you will get to beginning or end of your command. Note that when in the command mode, you can use the preview gestures move by line to go back or forward through the command history. A shortcut is holding dot 4 and swiping up to got to previous command in history, or swiping down to go forward. Even if you are not in command mode, holding dot 4 and swiping up will directly get you to the last command you ran. ## Usage Some commands target the text you have written. For example, to send a text message, you first type your message. Then you can send it away using a command mail, sms. without having to go back to the menu. You can also create a calendar event with .cal command. The dot commands you enter in MBraille are saved, so you can browse and re-execute old commands. For example, if you keep texting the same handful of persons, it is convenient not having to type the command again. At the beginning of line, hold dot 4 and swipe up to go back in history, down to go forward. When you lift your finger from dot 4, it is as if you had typed again the old command. Just swipe down for newline to play it again. You can also search from the command history. Type a dot followed by a space and the search keyword. Then hold dot 4 and swipe up. Only those dot commands are retrieved that have the search keyword. ## Twitter You can send tweets directly from the braille keyboard. To send a tweet, first type your message, then add a newline (swipe down), then enter .tweet at the beginning of line. So period, followed by the word "tweet" at the beginning of line. Then swipe down again and the text from preceding lines is tweeted. You can send a direct message by adding the recipient's twitter name after the tweet command, separated by a space. ## Sending mail Rather that going to mail screen via menu, a dot command can also be used. The advantage of a dot command is that you can type the subject and recipient names in Braille. So you first type your mail message, then add the dot command. Usage: .mail "Hello there" Jack Follow this with a newline and the send mail form is brought up with the Subject set to "Hello there" and To: pre-filled with the email address for Jack. Subject needs to be quoted if it contains spaces. Recipient emails are looked up from contacts by their first or last name. You can add multiple recipients. .mail "Hello there" Jack Jill will send the mail to both Jack and Jill. For the recipient you don't need to write out the full name, a prefix is enough. You just need to use enough letters to tell the names apart. For example, to send an email to Jill when you have both Jane and Jill in your address book, you would need to type just ji. The name lookup is not case sensitive and you can add as many recipients as you wish. If you have not typed enough letters to tell multiple recipients apart, you will be warned. To use both first name and last name to specify the recipient, you must separate the names with a period. So if you have in your contacts Jill Jones, and Jill Smith, you need to use the last name to tell the two Jill's apart. You can address an email to Jill Jones by abbreviating her name to jill.j or even just to j.j, if you have no other people in contacts whose first and last name both start with j. Note that if you are using contracted English Braille, to type the period between the first and last name you escape it with dot 4 before it. So a.b would be dots 1 4 256 12. An alternative is to toggle to uncontracted Braille on the fly to enter the arguments. You can also give an explicit email address instead of a contact name. To type @ sign, switch to uncontracted braille by holding dot 6 and flicking up or down. ## SMS text messages .sms On a line by itself will launch the SMS send screen with the current text pre-pasted. You can also pre-fill the recipient numbers in the same way as for the .mail command. Just give the first few letters of the recipient name as parameter. For example .sms Joh Would pre-fill the number for John. You can also give the full telephone number as an argument. If your recipient has multiple telephones, you will be asked which one to use in a selection list. To directly pick the first mobile or iPhone number from the list, you can prefix your recipient name with "m:" as follows: .sms m:john ## Dialing a number or contact .dial name or number Calls given contact or number. The contact can be abbreviated as for .sms or .mail commands. The call is opened as soon as you swipe down for a new line. ## Facetime calls You can place both Facetime audio and Facetime Video calls with MBraille. .ft name or number or email is used for Facetime Audio calls. .ftv name or number or email is used for Facetime Video calls. The contact can be abbreviated as for .sms or .dial commands. The call is opened as soon as you swipe down for a new line. ## Adding Calendar entries You can create a new Calendar item from MBraille with the dot cal command. The current text is added to the calendar entry as notes. The arguments to specify the time follow the .cal command. Usage: .cal title starts [ends] [alert [time]] [location: place] Examples: .cal "Pickup laundry" "2017-06-07 13:00" alert 30 min Would add a calendar entry for June 7, 2017 at 1 PM, with title "Pickup laundry", and add an alert to the event 30 minutes before. .cal Paris 2017-08-08 Since there is no time, this is automatically an all day event. As title and date don't have spaces, no quotes are required. .cal "Piano lesson" "2017-07-07 14:00" "2017-07-07 15:00" alert 1 hour Adds an event with starting and ending time, with and alert 1 hour before the event. .cal Meeting 17:30 Schedules an event with title Meeting for 17:30. If now is before 17:30, the meeting is for today, if it is already past 17:30, the date it is automatically set for tomorrow. .cal Meeting 5pm location: lobby Schedules a meeting for 5 pm, location being lobby. Different formats for specifying date are supported. In the USA MM.DD.YY format is understood, outside USA the order is day, month year; DD.MM.YY. For time, 24 hour clock is always supported, but so is "1:00 PM" format. To avoid typing quotes to give a date-time, following examples go around that, as no spaces are in the date-time. .cal Coffee 2017-05-16-16:00 .cal Coffee 21/3/14-10am You can also leave out the year, in which case the current year is used, or the following year if the date has passed. ## Adding Reminders You can create a new Reminder from MBraille with the dot rem command. The current text is added to the reminder entry as notes. Usage: .rem title [due-date] You can add a an optional due-date. Example: .rem "Write Thank You Note" 2017-10-30 ## Typing Speed Test To practice your typing speed, you can use the .tst command. Usage: .tst seconds or .tst phrase When you start a test, you'll hear a tone. When you stop a test, you'll hear the same tone as in the start. If you make a mistake when testing with a sample sentence, you'll hear a different tone after a word to signal a typo. Examples: .tst 10 swipe down, you'll hear the starting tone. Type for 10 seconds and you'll hear the same tone to signal 10 seconds have elapsed. Hold dot 3, swipe up to preview by sentence and swipe left to hear your results. .tst sample text to type swipe down, you'll hear the starting tone. Type "sample text to type" and end with space or newline. If you make a typo, you'll hear a different tone and need to correct your mistake. Once you have entered the text again without mistakes, you'll hear a tone to signal you are finished. Hold dot 3, swipe up to preview by sentence and swipe left to hear your results. .tst wr is a shorthand for typing: .tst The razor-toothed piranhas of the genera Serrasalmus and Pygocentrus are the most ferocious freshwater fish in the world. In reality they seldom attack a human. This is the official phrase used in the Guinness World Records texting attempt, see [Records_and_competition][1] for more information. [1]: http://en.m.wikipedia.org/wiki/Text_messaging#Records_and_competition "Records_and_competition" ## Using Web Search Engines You can at any time do Google, DuckDuckGo or StartPage searches. The search will open your default browser to display the search results. ### Google Usage: .google word1 word2 You can abbreviate the command to .goo Example: .goo "Albert Einstein" Note that you can quote search terms, as you can with a regular Google search. If you don't give any parameters, all of your current text is used as search keywords. ### DuckDuckGo Usage: .ddgo word1 word2 Example: .ddgo "Michael Jordan" Note that you can quote search terms, as you can with a regular DuckDuckGo search. If you don't give any parameters, all of your current text is used as search keywords. ### StartPage You can do a StartPage search at any time with dot spage. Usage: .spage word1 word2 Example: .spage "Pablo Picasso" Note that you can quote search terms, as you can with a regular StartPage search. If you don't give any parameters, all of your current text is used as search keywords. ## Opening the web browser You can open an arbitrary url in Safari browser with .web command. Usage: .web url Example: .web dr-carter.com You don't need to add the http:// in the beginning, but you can, for instance if you are pasting a link. If the url does not seem to make sense, it is passed to Google to ponder upon. ## Getting help To consult help directly from the Braille keyboard, you can give the dot help command. Usage: .help [topic] Examples: .help Without any arguments takes you to the top of full help. .help sms Will give you help for .sms command. .help help Will give you this section. Common topics for .help command are: editing, tweet, mail, sms, dial, cal, google, web, help, feedback and applications. ## File Management & Dropbox support .open filename Opens filename.txt from MBraille folder. If you use another suffix than .txt, you need to specify it. .open Without filename will let you browse the files in /MBraille folder. If you don't remember the filename, but remember it at the letter A in it, you can do ".open A" and you'll get a list of all files with letter A in the name. Swipe left/right or up/down to go through the list, double tap when you have the file you wish to open. At bottom of screen there is a cancel button if you wish to cancel the action. .save Saves the current buffer with the name it was opened with. If a new buffer, the default name is notes.txt .save filename Saves the current buffer as filename.txt. It is saved under /MBraille folder which you can see with a file explorer, or when you connect to your PC. .del filename Deletes the file, asking for a confirmation. If you leave the filename out, or give partial filename, you will be presented a list of matching filenames. ### Dropbox In the settings you can turn on Dropbox file sync. All the file management commands will then work against the Dropbox files. At Dropbox, the files will be under applications/MBraille. Note: if Dropbox sync does not seem to work properly after MBraille is updated to a new version, the fix is to toggle Dropbox off and back on from MBraille settings, so that you are prompted to give MBraille access rights to Dropbox. ## Alias command to create text aliases With alias you can create shorthand forms for arbitrary text. The alias is expanded when you swipe for space or newline. Examples: .alias myname: Harri Pasanen Now I would need to type just myname and it would be expanded to Harri Pasanen. You don't need quotes if your expansion does not contain leading or terminating spaces. In the cases you need them, you can do it, like .alias ans: " Your signature here: " If you desire newlines in your alias, you denote them with \n (backslash n). For example the following alias mailsig .alias mailsig: "\nHugs and Kisses,\n\nLuke\n\nSent with MBraille -- http://mpaja.com/mbraille\n" mailsig would expand to: Hugs and Kisses, Luke Sent with MBraille -- http://mpaja.com/mbraille However, MBraille does not have a backslash in all the Braille tables and editing those long strings with \n is not so convenient. So there is a better way: .alias myalias That will take the existing MBraille text buffer and use it as the alias. Note that there is no colon after the alias name, myalias in this case. Hint: you can create new dot commands based on existing ones, for example: .alias .sh: .sms harry That would enable you to just type .sh to send sms to harry. You can also add unicode characters, such as emojis to aliases. For example .alias smi: U+1f600 Will add a grinning face smiley when you type smi and swipe for space. See http://www.unicode.org/emoji/charts/emoji-list.html for a list of emojis. Note: in English contracted braille dots 56-235 will give you the plus sign. ### Listing aliases .alias Will list you all the aliases you have defined. ### Saving and loading .alias save Will save the aliases to a file called alias.mb. Aliases defined in this file are automatically loaded at MBraille start. Note that if you are using Dropbox, your aliases are automatically synced between devices. As alias.mb is a simple text file, you can just open alias.mb in any editor to make modifications, or send a useful alias.mb file to your friends. The file can be transferred from-to MBraille either through iTunes or Dropbox. You can of course edit alias.mb in MBraille itself, using ".open alias.mb" and .save commands. During the editing of alias.mb, the aliases are disabled. The file format is: myalias1: definition myalias2: another alias definition Empty lines are ignored, as well as lines starting with # Instead of colon, you can also use '=' sign to denote the start of definition. The leftmost sign matters. (Not all braille tables have '=', so I chose ':' as the default.) .alias load Will load alias.mb without having to exit MBraille. This way you can edit your alias.mb on a PC, save to Dropbox MBraille folder and just load it on the phone for testing. ### Notes Alias expansion happens before any contracted braille expansion. If you include an alias in an alias definition, the alias included will not be expanded. In the alias.mb file, you don't need to prefix the lines with ".alias " command. ## Working with third party applications MBraille can also access the following third party applications using the dot commands. Use .help application name to get app specific help. In alphabetical order * BlindSquare * Drafts * Fantastical * InstaBrowser * NoteMaster * Skype * Spotify * Whatsapp ### BlindSquare functions [BLINDSQUARE] ### Drafts You can create a new note in Drafts with the .drafts command, or .da for short. For Drafts 4 use .draftsfour, or .daf for short. Usage: .drafts If you are in Drafts and want to open up an existing note in MBraille, you can install the following URL action for MBraille. <pre> mbraille://x-callback-url/edit?text=[[draft]] </pre> After your edits, you can return to Drafts with the edited version as a new note with typing period da and swiping down. To keep editing the same note in Drafts, you need to use clipboard to transfer your changes. ### Fantastical You can create calendar entries with Fantastical using natural language for dates. For Fantastical use .fantastical or .fan for short. Usage: .fantastical Examples: .fan Without arguments tries to parse date from the text and adds calendar entry. .fan date-time With date-time adds text as notes for the given date-time entry. .fan show date-time Shows the calendar for a given date-time. ### InstaBrowser If you use InstaBrowser, you can open an arbitrary url in it with .ibr command. Usage: .ibr url Example: .ibr mpaja.com You don't need to add the http:// in the beginning, but you can, for instance if you are pasting a link. ### NoteMaster You can open NoteMaster with .notemaster command, or .nm for short. Usage: .nm [name] If you provide a name, an existing note with the given name is opened. If the name contains spaces, you need to quote it. For example: .nm "Sofa Shopping" Your text written in MBraille is in the clipboard, ready to be pasted to NoteMaster. ### Skype call If you have Skype installed, you can call directly to a skype contact. Usage: .skype skype-id Opens Skype and calls the given skype id. ### Spotify search You can do a Spotify search with .spotify command, or .spfy for short. Usage: .spotify search-term Opens Spotify to the search results. ### Whatsapp message If you have Whatsapp installed, you can send a message to a Whatsapp contact. Usage: .whatsapp contact Opens Whatsapp and automatically fills the receiver and message text from MBraille. .wup is a shortcut for .whatsapp. If you want to select the contact in Whatsapp itself, but still pass the message text from MBraille, you can launch Whatsapp without the contact argument. # Odds and Ends ## Additional Symbols MBraille supports the following multi cell symbols. If you are using the setting where all characters are announced, the voice feedback is a little confusing, as separate cells are announced in braille ASCII until the word is complete. ### UEB symbols supported by MBraille | Symbol | Dots | | ------ | ---- | " | 6-2356 # | 456-1456 $ | 4-234 % | 46-356 & | 4-12346 ( | 5-126 ) | 5-345 * | 5-35 + | 5-235 - | 5-36 ... | 256-256-256 / | 456-34 < | 4-126 = | 5-2356 > | 4-345 @ | 4-1 [ | 46-126 \ | 456-16 ] | 46-345 ^ | 4-26 _ | 46-36 { | 456-126 } | 456-345 ~ | 4-35 ¢ | 4-14 £ | 4-123 ¥ | 4-13456 § | 45-234 © | 45-14 « | 456-236 ® | 45-1235 ° | 45-245 ¶ | 45-1234 » | 456-356 × | 5-236 è | 46-16-15 é | 45-34-15 ÷ | 5-34 α | 46-1 β | 46-12 γ | 46-1245 δ | 46-145 ε | 46-15 ζ | 46-1356 η | 46-156 θ | 46-1456 ι | 46-24 κ | 46-13 λ | 46-123 μ | 46-134 ν | 46-1345 ξ | 46-1346 ο | 46-135 π | 46-1234 ρ | 46-1235 σ | 46-234 τ | 46-2345 υ | 46-136 φ | 46-124 χ | 46-12346 ψ | 46-13456 ω | 46-2456 — | 6-36 —— | 5-6-36 ‘ | 6-236 ’ | 6-356 “ | 45-236 ” | 45-356 † | 4-6-1456 ‡ | 4-6-12456 • | 456-256 ₣ | 4-124 ₦ | 4-1345 € | 4-15 ™ | 45-2345 ← | 1256-246 ↑ | 1256-346 → | 1256-135 ↓ | 1256-146 ♀ | 45-1346 ♂ | 45-13456 ♭ | 3456-126 ♮ | 3456-16 ♯ | 3456-146 〃 | 5-2 ### For older English Braille MBraille supports | Symbol | Dots | | ------ | ---- | # |456-1456 % |4-25-1234 & |4-12346 ' |6-236 ' |356-3 * |5-35 * |35-35 + |5-235 - |5-36 . |3-3-3 / |456-34 : |4-156 = |5-2356 @ |4-1 [ |6-2356 ] |2356-3 ¢ |4-14 £ |4-123 $ |4-234 ¥ |4-13456 © |45-14 ® |45-1235 × |5-236 ÷ |5-34 – |36-36 – |36-36-36-36 ″ |4-35 € |4-15 ™ |45-2345 ## Self Voicing You can use the Braille keyboard without VoiceOver turned on. MBraille will detect that VoiceOver is not running and automatically use self voicing. Self voicing brings additional features: * You can choose the English voice used. * The dot lang command will automatically change the voice to the corresponding language. * Deletions are announced with a lower pitch. * Voice rate and volume can be modified separately from VoiceOver, and those are specific to the language or accent. ### Self voicing specific commands The Voice language is automatically changed following the .lang command. You can also set the voice separately without changing the braille table with ".set voice" command. Usage: .set voice [lang-code] Where lang-code is the two letter language code, such as en,es,fr,de,pt,... etc. To select a specific accent, you can use the following iOS voice names, for example .set voice daniel British English. .set voice allison US English .set voice moira Irish English. .set voice tessa South-African English .set voice karen Australian English You can also specify the voice using the BCP 47 language tag, for example .set voice fr-CA would set the voice to Canadian French. To specify the voice rate and volume, you can use the commands. .set speed 1-10 to change the self voicing speed for the currently active language. .set vol 0-10 to change self voicing volume for the currently active language. Voice speed and volume are language and dialect specific. So if you are learning a foreign language, it is often easier to understand if the volume is a bit louder and the speed of speech is lower. ## Giving feedback To post to MBraille mailing list, you can give the dot feedback command. Usage: .feedback [subject] Examples: .feedback Thanks for a job well done! Without any arguments .feedback uses the default Subject: "MBraille feedback." ## Change Braille table language If your phone language does not match the Braille table you would like to use, or if you know Braille in multiple languages, you can change the Braille table on the fly with .lang command. Usage: .lang [language code] [save] Examples: .lang da Would change the braille table to Danish for the current session. .lang da save Saves the language table used, so that MBraille remembers to start with Danish braille after restart. ### Gesture to change language You can quickly toggle between languages by holding dots 1,2,3 and swiping up. If your phone language not English, by default the braille table, self voicing language and spelling language is changed to English. If your phone language is English, the language changed to is determined by ".lang code save" command. Examples: Your phone is in English, but you often write in French. Do .lang fr save Then by holding dots 1,2,3 and swiping up you can toggle between English and French. Note that this gesture works both in MBraille App and MBraille Keyboard, but the ".lang code save" command must be given first in the app. ## Change MBraille settings You can controls some MBraille settings with .set command Usage: .set [setting-name] [value] Available settings in alphabetical order: .set auto-caps [on|off] If turned on, the next word after punctuation will be automatically capitalized. .set clear-clipboard [on|off] If turned on, putting MBraille to background will automatically clear the MBraille buffer, so that the entered text will only be available in the clipboard. .set nlclick [on|off] Turns the newline click sound on or off. .set sensitivity [value] Adjust swipe sensitivity, with values between 18 to 50. The smaller the value, the higher the sensitivity. Default value is 28. Warning, if you set it to 18 and your fingers are a bit jittery, you may have trouble changing the value. .set shake-to-clear [on|off] Allows you to clear the text by shaking the device. It is on by default. .set toggle-swipe-dir Toggles the up and down swipe direction when screen is facing away. .set Reports current values. # MBraille as a third party keyboard If you are running iOS 8.3 or higher, you can use MBraille as a third party keyboard. Configure it from devices Settings, General, Keyboard, Keyboards: Add New Keyboard. Once you see MBraille in list of keyboards, click on it to allow full access. ## Using the custom keyboard You type normally as you would with MBraille proper. To dismiss the keyboard, you can swipe left with 3 fingers. To advance to next keyboard swipe right with 3 fingers. Normally MBraille keeps the text you type in its own memory and synchronizes it with the edit field when you dismiss the keyboard or advance to next keyboard. If MBraille can deduce that the keyboard should be dismissed on return swipe, it will do that. Sometimes it is useful to have MBraille to update the edit field after each keystroke. To do that you can toggle the direct input mode by holding dot 6 and swiping right. Then each key you type is automatically echoed to the edit field. (Or each word if contractions is on). ## Custom keyboard layouts On iPad the MBraille custom keyboard does not take up the full screen, but only covers the area occupied by the standard keyboard. This leaves rest of the screen visible to VoiceOver. For iPhone, there is an option in MBraille settings to restrict the keyboard area to 2/3 of the screen height. This way 1/3 of the screen is left visible for VoiceOver. On iPhone, the piano layout covers only half the screen in landscape while in custom keyboard. This again leaves some of the screen visible to VoiceOver. Note however, that if the orientation is locked to portrait, the piano keyboard does cover the full screen, but is rotated to landscape. On iPhone you can briefly toggle the keyboard layout to/from piano by holding dot 6 and swiping left. # Credits ## Testers MBraille would not be there without the team of testers who provided invaluable feedback along the road. In alphabetical order: * Ikrami Ahmad * Manolo Alvarez * Michael Charlton * Caroline Congdon * Thomas Byskov Dalgaard * Angela Fisher * Suleyman Gokyigit * Christopher Hallsworth * Johanna Herranen * Rebecca Ilniski * Cliff Isaksen * Søren Jensen * Megan Kelly * Tangela Mahaffey * Joona Malinen * Paweł Masarczyk * Matthieu Méric * Eileen Misrahi * Gordan Radic * Bruce Toews * Richard Turner * Engin Yılmaz ## Translators Special mention goes to translators. * Arabic, Ikrami Ahmad * Croatian, Gordan Radić & Danijela Marušić * Czech, Lukáš Hosnedl & Marek Salaba * Danish, Søren Jensen & Thomas Byskov Dalgaard * Finnish, Harri Pasanen & Virpi Jylhä * French, Harri & Jukka Pasanen * German, Miika Virtanen & Sandra Pilz & Alexandra Backof * Norwegian, Cliff Isaksen * Polish, Paweł Masarczyk * Spanish, Manolo Alvarez * Swedish, Eeva & Harri Pasanen * Turkish, Engin Yılmaz ## Design and coding + Harri Pasanen Copyright 2013-2024 MPaja.com ## Software used Hunspell https://hunspell.github.io/ Liblouis https://github.com/liblouis/liblouis Best regards, Harri

1 0