Thunderbird - Synchronize Addressbook
=====================================

Addressbook
-----------

As someone who is new to Nextcloud, new to SoGo Connector, and new to Thunderbird Addressbook... here is what you need in excruciating pithy detail to make this work (for all the other lost souls out there):

#. `Thunderbird <https://www.mozilla.org/en-US/thunderbird/>`_ for your OS unless it comes with your OS distribution (Linux)
#. `Sogo Connector <https://sogo.nu/download.html#/frontends>`_ (latest release)
#. `Lightning <https://addons.mozilla.org/en-US/thunderbird/addon/lightning/>`_ (a Thunderbird calendar add-on. At the time (Aug 14), syncing your contacts only works with this add-on installed.)

With an installed Thunderbird mailtool, an installed SoGo Connector, and an installed Lightning add-on:

#. Thunderbird Addressbook is in the Thunderbird "Tools" Menu
#. In the Thunderbird Addressbook application:

   -  "File > New > **Remote Addressbook**" (SoGo Connector added this)
   -  "**Name:**" is the name you want to give your Addressbook in the Thunderbird addressbook bar area
   -  "**URL:**" is found in your Nextcloud Contacts area, that little Gear symbol

.. image:: ../images/contact_thunderbird-Symbol_Gear.jpg

in the bottom left of the Contacts View (same symbol as found in the top right in the Calendar view). Then look for a little impeller symbol

.. image:: ../images/contact_thunderbird-Symbol_Impeller.jpg

which will display the URL you need for your installation to work.

.. image:: ../images/contact_thunderbird-URL_config.jpg

Once installed, synchronize (right click on your newly made remote address book and select "Synchronize").
You'll see your address book populate from Nextcloud! Don't click "read only" above unless you don't want to
modify your Nextcloud server addressbook, like it contains a listing of corporate contacts and is shared with
lots of people, and you don't want a new user dragging it somewhere unintended.

The rest of the details of dealing with Thunderbird addressbook are left to the reader... First thing I learned
is dragging a contact to a different addressbook is a "move" operation. If you are worried about losing the
contact, save it to a VCF file using Nextcloud (Or LDIF using Thunderbird Addressbook) first! Like dragging
from "Nextcloud Addressbook" to "Personal Address Book" removes the contact from Nextcloud Server
(*deleting it from all the other synchronized installations*) and puts it in your Local Machine -only-
Address Book. So be careful or you'll have unintended consequences where you might have intended a "copy" operation.

Contact *Pictures* are also sync'ed!
