# Contacts

<figure><img src="https://1453621892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyhORwVwuIgJMLsQRqN3S%2Fuploads%2FVqEz7mP52FXtT1Lq1zlf%2Fimage.png?alt=media&#x26;token=12c8e6da-71ed-4605-88b8-35c00e382603" alt=""><figcaption></figcaption></figure>

The contacts application lets you list your contacts that are imported from the contacts folder found under the `KSContactsImport` folder. It shows you basic information about your contacts.

The contacts application is usually found in your computer under the form of a feature in your favorite mail client or under the form of a standalone application. It's also found in your smartphone in which you can make phone calls and send SMS messages.

***

## <mark style="color:$primary;">Usage</mark>

Nitrocid contains this standalone application and can be executed by invoking the `contacts` command.

You can also perform contact management without the contacts interactive TUI by using one of the following four commands:

| Command          | Description                                                      |
| ---------------- | ---------------------------------------------------------------- |
| `contactinfo`    | Shows you contact information                                    |
| `importcontacts` | Imports the contacts from either a MeCard string or a vCard file |
| `listcontacts`   | Lists all the contacts                                           |
| `loadcontacts`   | Loads all the contacts                                           |

{% hint style="info" %}
Please note that Nitrocid KS is unable to make phone calls and send SMS messages to your contacts as it requires a special device, such as Voice over IP (VoIP) phones, to be able to make calls from your computer, and we don't intend to simulate that.
{% endhint %}

***

## <mark style="color:$primary;">Controls</mark>

This application currently supports the following keystrokes:

<table><thead><tr><th width="130">Keybinding</th><th>Description</th></tr></thead><tbody><tr><td><code>F1</code></td><td>Deletes a selected contact</td></tr><tr><td><code>F2</code></td><td>Deletes all contacts</td></tr><tr><td><code>F3</code></td><td>Imports contacts from your exported contact files found under the <code>KSContactsImport</code> folder</td></tr><tr><td><code>F4</code></td><td>Imports contacts from a selected path to your contact file</td></tr><tr><td><code>F5</code></td><td>Shows extra information about your contacts</td></tr><tr><td><code>F6</code></td><td>Searches the contact list for a specified name</td></tr><tr><td><code>F7</code></td><td>Searches the contact list for a next occurrence of a name</td></tr><tr><td><code>F8</code></td><td>Searches the contact list for a previous occurrence of a name</td></tr><tr><td><code>F9</code></td><td>Gets raw information about a selected contact's card based on the saved VCard data generated by VisualCard</td></tr><tr><td><code>F10</code></td><td>Imports contacts from MeCard</td></tr><tr><td><code>F11</code></td><td>Opens the contact editor infobox to edit your selected contact</td></tr><tr><td><code>F12</code></td><td>Saves all contacts</td></tr><tr><td><code>A</code></td><td>Adds a new contact</td></tr><tr><td><code>ESC</code></td><td>Exits the application</td></tr></tbody></table>

***

## <mark style="color:$primary;">Importing contacts</mark>

The contact application can import your contacts from the `KSContactsImport` folder if your contacts file is one of the supported formats by the powerful VisualCard library:

* VCF contact files holding a single contact (version 2.1, 3.0, 4.0)
* VCF contact files holding multiple contacts (same version, mixed versions)
* Android contacts database file (`contacts2.db`)

To import MeCard contacts, expand the below section.

<details>

<summary>Importing MeCard contacts</summary>

<figure><img src="https://1453621892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyhORwVwuIgJMLsQRqN3S%2Fuploads%2F6ysyahix8RrL7m0U6GWS%2Fimage.png?alt=media&#x26;token=19865f51-dab5-4bfd-8476-db2fe6e305b6" alt=""><figcaption></figcaption></figure>

The contact application can also import your contact through a short MeCard syntax given to you by a QR code behind it. Below is an example of a complete MeCard syntax:

```
MECARD:N:Sanders,John,,,;TEL:495-522-3560;EMAIL:john.s@acme.co;ADR:,,Los Angeles,,,,USA;NOTE:Note test for VisualCard;;
```

</details>

***

## <mark style="color:$primary;">Editing a contact</mark>

You can edit a contact by pressing `F11` and making changes to the following contact properties:

* Name
* Address
* Mail
* Organization
* Telephone
* URL
* Geo
* IMPP
* Nickname
* Role
* Title
* Note
* Profile picture

***

## <mark style="color:$primary;">Learn more</mark>

To learn more about how VisualCard works, consult the below link named `How it works` and it'll take you to the VisualCard manual.

{% content-ref url="broken-reference" %}
[Broken link](https://aptivi.gitbook.io/aptivi/nitrocid-ks-manual/fundamentals/simulated-kernel-features/extra-features/common-programs/broken-reference)
{% endcontent-ref %}