Rehnuma Awaz

Natural Urdu speech for NVDA. User Guide, version 2.0.7.

Introduction

Rehnuma Awaz gives NVDA natural, neural voices for Urdu. Urdu text is read by an Urdu voice, and English words in the same sentence by an English voice, so mixed Urdu and English is read naturally without you switching synthesizers.

Rehnuma Awaz is developed by Centangle Interactive, funded by Ignite (National Technology Fund) and supported by the Ministry of IT & Telecom, Government of Pakistan.

Highlights:

Back to contents

Getting started

  1. Install the add-on and restart NVDA.
  2. Press NVDA+Control+S to open the Select Synthesizer dialog, choose Rehnuma Awaz and press Enter.
  3. Rehnuma Awaz comes with an Urdu voice (Zainab) and an English voice (Akbar English), so it speaks straight away. More voices can be downloaded with the voice manager.

The voices take a few seconds to load when NVDA starts. Until they are ready, the synthesizer you used before Rehnuma Awaz speaks and says that Rehnuma Awaz is loading.

Back to contents

Voice settings

Open them with NVDA+Control+V. Most of them are also in the synth settings ring (NVDA+Control+Left Arrow and NVDA+Control+Right Arrow to choose a setting, NVDA+Control+Up Arrow and NVDA+Control+Down Arrow to change it).

Voice
The Urdu voice. In single-voice mode (see English synthesizer) the list also has Rehnuma's English voices.
Rate, Rate boost, Pitch
For the Urdu voice.
Volume
For all speech, Urdu and English.
English synthesizer
What reads English: Rehnuma Awaz itself, or another synthesizer installed in NVDA. The last choice, Off (single voice), turns language switching off: the voice chosen under Voice reads all text, Urdu and English, in its own language. In this mode the English voice, English rate and English pitch settings are hidden. The English synthesizer is not in the settings ring, because loading another synthesizer takes a moment.
English voice
The voices of the chosen English synthesizer. For another synthesizer, the voice you set for it in NVDA is selected at first.
English rate, English pitch
For English. With another synthesizer, 50 is exactly that synthesizer's rate and pitch as you set them in NVDA; lower or higher values make it slower or faster, lower or higher from there. Volume works the same way: 100 keeps that synthesizer's own volume. Its other settings (variant, inflection and so on) are used as you set them, and using it inside Rehnuma never changes them.

Back to contents

How text is divided between voices

Back to contents

Rehnuma Awaz settings

In NVDA's settings dialog (NVDA+N, Preferences, Settings), choose the Rehnuma Awaz category.

SettingWhat it doesDefault
Pause between sentences (ms)Silence after each sentence.150
Pause at a commaSilence at a comma, or the voice's own pause.100 ms
Add phrase breaks in long Urdu sentencesReads long Urdu sentences in phrases, with a short pause before words such as اور، لیکن، کیونکہ.On
Pause at a phrase break (ms)Length of that pause.100
Read numbersIn the language of the surrounding text, always in Urdu, or always in English.Surrounding text
Read short English (up to 2 words) inside Urdu with the Urdu voiceSee How text is divided between voices.On
Use NVDA's language switching for text without lettersLets NVDA's language information choose the voice for text such as numbers.On
Voice expressiveness, Rhythm variationHow varied the neural voices sound. 50 is each voice's natural setting.50
Natural speed-upAt higher rates, the voice itself speaks faster before the rest of the speed-up is applied, which sounds more natural.On
Open voice managerOpens the Rehnuma Voice Manager.
Check for add-on updates when NVDA startsLooks for a new version at most once a day.On
Check for updates nowLooks for a new version straight away.

Back to contents

Characters, symbols and punctuation

When you type, or move by character, Rehnuma Awaz names each character in Urdu: letters (ب is "bay"), letter forms such as ك and ي, diacritics (zabar, zer, pesh, tashdeed and the others), Quranic marks, Urdu punctuation, the half space and other invisible characters, and religious ligatures such as ﷺ and ﷽. Letters copied from PDF files in their joined shapes are named as the letter they stand for.

The Urdu symbol dictionary

Rehnuma Awaz adds an NVDA symbol dictionary, Rehnuma Awaz Urdu symbols, with Urdu names for punctuation and symbols: for example ، (سکتہ)، ؛ (وقفہ)، ؟ (سوالیہ) and ۔ (ختمہ). With it, these are spoken in Urdu by the Urdu voice, and how much is spoken follows NVDA's punctuation level, which you change with NVDA+P. The Urdu marks stay in the text at every level, so the voice still pauses at them.

For the dictionary to be used:

  1. Open NVDA's settings (NVDA+N, Preferences, Settings) and choose Speech.
  2. Check Trust voice's language when processing characters and symbols. This is on unless you have turned it off.
  3. Under Extra dictionaries for character and symbol processing, check Rehnuma Awaz Urdu symbols.

Without it, NVDA names these marks itself, in its own interface language.

Back to contents

Moving by sentence in Microsoft Word

In Microsoft Word, Alt+Down Arrow and Alt+Up Arrow move to the next and previous sentence. Word itself does not end a sentence at the Urdu full stop, so Rehnuma Awaz adds it: sentences also end at ۔ and ؟. ؛ is a pause inside a sentence, as ; is in English. English sentences work as before.

Back to contents

Rehnuma Voice Manager

Open it from NVDA's Tools menu (Rehnuma Voice Manager), with NVDA+Shift+Alt+R, or from the Rehnuma Awaz settings. The shortcut can be changed in NVDA's Input Gestures dialog, under Rehnuma Awaz.

Without an internet connection the voice manager still lists your installed voices. Downloaded voices are kept in your NVDA configuration folder, so they are kept when the add-on is updated.

Back to contents

Updates

When NVDA starts, Rehnuma Awaz looks for a new version at most once a day; you can turn this off, or check at any time, in the Rehnuma Awaz settings. When a new version is available, a dialog shows what has changed. Update now downloads it, checks it, and hands it to NVDA, which asks you to confirm and then to restart. Updates do not include voices: your voices and settings are kept.

Voices and updates are only installed when their information is signed by Rehnuma Awaz, so changed or older files from anyone else are refused.

Back to contents

Using other synthesizers with Rehnuma Awaz

Back to contents

Keyboard commands

CommandKeys
Open the Rehnuma Voice ManagerNVDA+Shift+Alt+R
Next and previous sentence in Microsoft WordAlt+Down Arrow, Alt+Up Arrow
Voice settingsNVDA+Control+V
Choose a synthesizerNVDA+Control+S
Synth settings ringNVDA+Control+Arrow keys
Punctuation levelNVDA+P

This guide, in English and Urdu, is in NVDA's Help menu under Rehnuma Help.

Back to contents

Requirements and privacy

Back to contents

About Rehnuma Awaz

Rehnuma Awaz is developed by Centangle Interactive, funded by Ignite (National Technology Fund) and supported by the Ministry of IT & Telecom, Government of Pakistan. Its speech engine, Urdu pronunciation and NVDA driver are Rehnuma's own work, built from the ground up.

It uses open-source components, whose licences come with the add-on (in the NOTICES folder of the synthesizer): ONNX Runtime, Sonic, and the CMU Pronouncing Dictionary. Some voices in the voice manager come from the Piper community.

Back to contents