# Address book for NVDA #

Introduction

Welcome to the NVDA Address Book Addon! This is a plugin specially designed to help visually impaired people manage their contact list more easily and efficiently. With our Addon you can add, edit and delete contacts as well as search for names and contact information quickly and simply. In addition, we also provide you with the ability to export and import your contact list, so that you can share it or migrate it to another device. NVDA's Address Book Addon is easy to use and offers an intuitive interface, making it an ideal choice for anyone needing to manage their contact list efficiently.

Installation

Here are step-by-step instructions for installing the Address Book Add-on in NVDA:

  1. Download the Add-on installation file Contact Book.
  2. Press enter on the add-on you downloaded.
  3. Follow the on-screen instructions to install the Add-on.
  4. Restart NVDA.
  5. Press "NVDA + N" to open the settings menu and check if the Address Book Add-on is listed in the plugins list. You are now ready to use the Address Book Add-on and save your contacts directly from NVDA. Be sure to check out the Add-on's documentation for additional information on how to use it and customize it to your needs.

Settings

In the Preferences menu, Settings... of NVDA in the Contact directory option for NVDA. You can configure the following options, which are unchecked by default:

  1. Do not use phone formatting, checkbox not checked. Alt+n. This option adds or removes phone number formatting. for the time being, only formatting (+55) for Brazil is available.
  2. Display the option to delete all phonebook, unmarked checkbox. Alt+e. when enabled, it allows deleting all contents of the agenda.
  3. Display button Import CSV file, checkbox not checked. Alt+e. Allows import of csv files. Note: all fields must be compatible with the agenda.
  4. Display button Export CSV file, checkbox not checked. Alt+e. Saves all phonebook contacts in a csv file.

Usage

You can call up the Address Book in two ways:

  1. By shortcut, Windows+Alt+L;
  2. Through NVDA's menu Tools Contact Book.

you will have access to the main window of the addon. In this window you can register, edit, remove and search contacts. It also has the options to import csv, export csv and delete the entire agenda. These three options are disabled by default.

Registering a new contact

To register a new contact:

  1. Access Contact Directory, NVDA menu, Tools, Directory, Contact List. or by shortcut (windows+Alt+L);
  2. In the Contact List window, press Alt+N to add a new contact.
  3. In the New Contact window, fill in all fields and press Alt+LT+E,, to save and Alt+F to exit without saving;

Editing a contact

To edit a contact:

  1. Select a contact from the list;
  2. Press ALT+E;

The editing window will open with focus on the name field. Just edit and press ALT+E to save changes or ALT+F to cancel.

Search

In the Contact List window you can use the search field to find a particular contact. You can search by fields:

After selecting the field, just inform the search item, and press the ALT+B shortcut, which will display the search result in the list. If nothing is returned, just update using the shortcut ALT+A.

Tips and Shortcuts

Contact List window:

Edit Window:

All windows of the Contact Agenda add-on are closed with the escape key.

Known issues

When performing a search and the search item is not found, NVDA does not announce the message ('No record was found!')) that appears in the display list.

License

This file is covered by the GNU General Public License. See the file COPYING for more details.

Thanks

This add-on was inspired by the agenda created by Abel Passos do Nascimento Jr. abel.passos@gmail.com, Rui Fontes rui.fontes@tiflotecnia.com and Ângelo Abrantes ampa4374@gmail.com.