[[Image:KAddressBook.png|thumb|500px|center|KAddressBook is a powerful address book application integrated in the KDE-PIM suite.'''
{{Info|This page is related to '''KAddressBook''' version 4.4. If you have a different version of '''KAddressBook''' then you may find a page for that version [[Special:myLanguage/KAddressBook/index|here]].
]]
}}
{|style="text-align:center" cellpadding="2"
|[[Image:KAddressBook.png|thumb|300px]]||'''KAddressBook reborn to make your data available to all your applications'''
|}
==Introduction==
==Introduction==
KAddressBook is a work-in-progress. That doesn't mean that it's unstable but it does mean that it's not complete. The layout you see in this version is very different from the older version, and it's quite possible that the next version will be different again, as we see more features being available to us again.
[https://kontact.kde.org/components/kaddressbook.html KAddressBook] stores all the personal details of your family, friends and other contacts. It supports large variety of services, including NextCloud, Kolab, Google Contacts, Microsoft Exchange (EWS) or any standard CalDAV server.
<span id="Setting up your New AddressBook"></span>
==Setting up your New AddressBook==
===Automatic Migration===
== Tutorials ==
If you have previously been using KAddressBook you are probably aware that it was stored in ~/.kde/share/apps/kabc/std.vcf. When you install KDE SC 4.4 the automatic migration tool will examine that file and set up an Akonadi resource using the data that it contains. However, you may find that a number of other things need checking. As this is entirely new technology, the distributions may not have been able to set up everything to perfection.
=== Getting started ===
===Initial Requirements===
* [[Special:myLanguage/KAddressBook/Tutorials/How to create a new address book?|How to create a new address book?]]
* [[Special:myLanguage/KAddressBook/Tutorials/How to add a new contact?|How to add a new contact?]]
'''Nepomuk''' must be running. Open SystemSettings > Advanced tab > Desktop search and enable Nepomuk. '''Strigi''' may be too heavy on resources if your hardware struggles, but enabling Strigi is optional. Turn it off if it gives you problems, though lack of indexing will necessarily impact the extent to which Nepomuk can work. '''MySQL''' must be working. This has been problematic on some distributions. If you have problems you will probably benefit from reading the [[Special:myLanguage/Akonadi_4.4/Troubleshooting|Akonadi Troubleshooting page]].
=== Connect to an external service? ===
===Enabling Resources===
* [https://docs.nextcloud.com/server/13/user_manual/pim/sync_kde.html Synchronizing NextCloud with KDE PIM] (NextCloud Documentation)
Again, your distribution may have already done this for you, but check SystemSettings > Advanced tab > KDE Resources. Make sure that the resources listed there are enabled, then use the 'Set as Standard' button on 'akonadi-resource Personal'. This will make the Personal Contacts addressbook available to KMail.[[Image:AkonadiResource1.png|thumb|400px|center]]
===Backing up your Data===
The page [[Special:myLanguage/Akonadi_and_AddressBook|Akonadi and AddressBook]] helps you understand the structure of KAddressBook, so that you can be sure that you have backed up all that you need.
Explore a little further, with the Manage Addressbook Sources button, and you will see that you can examine the settings for your resources:[[Image:AkonadiResource2.png|thumb|400px|center]]
{{KontactInstall|KAddressBook}}
The resources on your system may not match the list you see in this image - that is of no consequence. Personal Contacts is the one of importance for working with KAddressBook and KMail.
In KDE SC 4.5 the path is slightly different although the process is the same. SystemSettings has been redesigned, so KDE resources is now found under Personal Information.
[[Image:Systemsetting45.png|thumb|400px|center]]
==Status of this release==
'''Distribution Lists''' - the migration tool for your existing distribution lists is not yet released. It is work-in-progress. Where appropriate you can create a new Group - Groups will replace Distribution Lists. Auto completion makes it quite easy to add entries to the group. In KDE SC <= 4.4.2 you can't use the group quite like a distribution list, typing the name and expecting it to be expanded into a list of names. You can, though, copy and paste the list of names from the right-hand panel.
This is not final functionality, but it is a work-around that is possible in some situations.
'''Update''' - for KDE SC 4.4.3 the alias expansion for Contact Groups from KAddressBook has been backported. Contact Groups still may not be selected in the recipients picker, though.
'''Invisible fields''' - some users have been worried because they knew that information was in fields not currently visible. If you check any record in ~/.local/share/contacts/ you will see that the data is not lost. We can expect to see the data becoming visible again in the coming version releases.
==Backing up your Data==
The page [[Special:myLanguage/Akonadi_and_AddressBook|Akonadi and AddressBook]] helps you understand the structure of KAddressBook, so that you can be sure that you have backed up all that you need.
==Troubleshooting==
== More Information ==
A number of common 'teething problems' have been reported in versions shipped with KDE SC 4.4. Many of them disappeared with the advent of 4.4.1, but if you still get error messages, [[Special:myLanguage/Akonadi_4.4/Troubleshooting|Akonadi 4.4 Troubleshooting]] has solutions to many problems.
KAddressBook is a powerful address book application integrated in the KDE-PIM suite.
Introduction
KAddressBook stores all the personal details of your family, friends and other contacts. It supports large variety of services, including NextCloud, Kolab, Google Contacts, Microsoft Exchange (EWS) or any standard CalDAV server.
The page Akonadi and AddressBook helps you understand the structure of KAddressBook, so that you can be sure that you have backed up all that you need.
Download
KAddressBook is available in all major Linux distribution repositories, as tarballs, and soon a Flatpak version will also be available. Ancient versions were compatible with Windows, the Kontact team is looking for help to improve Windows support. For more information look at the Kontact download page.
