Contact Manager for NVDA

Author: Edilberto Fonseca (edilberto.fonseca@outlook.com)
Created on: 11/04/2024
License: GPL 2.0

Introduction

Welcome to the Contact Manager for NVDA!

This add-on was developed to help blind or visually impaired users manage their contact list in a practical, accessible, and efficient way.

With this tool, you can:

• Add, edit, delete, and search for contacts;
• Import and export contact lists in CSV format;
• Apply custom phone number formatting;
• Choose a custom location to store your contact database;
• Navigate an intuitive and fully keyboard-accessible interface.

Installation

1. In NVDA, open the Tools menu and go to the Add-on Store.
2. Under the Available Add-ons tab, use the Search field and look for Contact Manager.
3. Select it, press Enter or click Apply, and choose Install.
4. Restart NVDA to complete the installation.

Once installed, the add-on is ready to use.

When you select a contact in the list, their details will be shown in a read-only text box. You can navigate the list using the first letter of the contact’s name.

Configuration

Access the settings panel from:
NVDA Menu > Preferences > Settings > Contact Manager for NVDA

Available options:

1. Phone number masking: Use # to apply a formatting mask (e.g., for Brazilian numbers).
2. Allow clearing all contacts (Alt+T): Enables a button to delete all entries in the contact list.
3. Enable CSV import (Alt+I): Shows a button to import contacts from CSV files.
4. Enable CSV export (Alt+X): Shows a button to export the contact list to a CSV file.
5. Contact file directory: Set a custom path for storing your agenda file.

Accessing the Add-on

You can open the Contact Manager in two ways:

1. Keyboard shortcut: Windows+Alt+L
2. NVDA Menu: NVDA+N > Tools > Contact Manager

In the main window, you can:

• Add, edit, and delete contacts;
• Search for specific contacts;
• Import and export CSV files;
• Delete all records in the contact list (if enabled).

Adding a New Contact

1. Open the Contact Manager (Windows+Alt+L or via menu).
2. Press Alt+N to add a new contact.
3. Fill out the fields.
4. Press Alt+O to save or Alt+C to cancel.

Note: Use Enter to navigate between fields.
The Tab key may behave unpredictably due to a known issue.

Editing a Contact

1. Select a contact from the list.
2. Press Alt+E or F2.
3. Make your changes.
4. Press Alt+O to save or Alt+C to cancel.

Searching Contacts

1. Type a search term (name, phone, or email).
2. Press Alt+P to filter the results.
3. Press Alt+A or F5 to refresh the full list.

If no match is found, a message will inform you.

Keyboard Shortcuts

Main Window

Action	Shortcut
Add new contact	Alt+N
Edit selected contact	Alt+E or F2
Remove selected contact	Alt+R or Delete
Search	Alt+P
Refresh contact list	Alt+A or F5
Import CSV file	Alt+I
Export to CSV	Alt+X
Delete all contacts	Alt+T
Exit	Alt+S

To edit or remove a contact, make sure it is selected in the list.
If no contact is selected, a warning message will be shown.

Add/Edit Contact Window

Action	Shortcut
Confirm	Alt+O
Cancel	Alt+C

You can close all windows with Esc or Alt+F4.

Acknowledgements

This add-on was inspired by the contact manager originally developed by:

• Abel Passos do Nascimento Jr. (abel.passos@gmail.com)
• Rui Fontes (rui.fontes@tiflotecnia.com)
• Ângelo Abrantes (ampa4374@gmail.com)

Translators

• Portuguese (Brazil) – Edilberto Fonseca
• Portuguese (Portugal) – Edilberto Fonseca
• Ukrainian – George‑br
• Turkish – Umut KORKMAZ