Command Reference

The Menu Bar
Here is a rundown of the seven menus appearing on 's Menubar.

The File Menu
A screenshot of 's File menu.
A screenshot of 's File menu.
's File menu after clicking the File button on the Menubar.
 
The File menu lets you access six main functions, three of which have several options.
 
N File New  > New Contact 	This has exactly the same effect as clicking the   + New Contact  button on the Toolbar. See chapter 2 above for complete details.
G File New  > New Group 	Opens a dialog in which you may define a new group, or mailing list. See  the appendix for a detailed explanation of this function.
File New  > Add Address Book 	This opens the Add Address Book dialog, which is fully documented in  chapter 2 above.
File Import  > Import from LDAP server ... 	This function allows you to import data from an LDAP server. The server must be configured before you can use this function. See the appendix for full details.
File Import  > Import CSV file ... 	This function allows you to import contact data from a comma separated values (csv) file. A dialog ensues, in which you may associate each field in the input file with a named field in 's internal storage record. See the appendix for a more detailed explanation.
File Import  > Import vCard ... 	This function facilitates the importation of vcf, or vCard, data. All three versions of vCard are supported. You can learn more about the vCard formats at this web site.
File Export  > Export CSV file ... 	This function allows you to export selected contact data as a Comma Separated Values (csv) file. There are 47 fields in the output record. Please refer to the appendix for a list of those data fields.
File Export  > Export vCard 4.0 ... 	This function allows you to export selected contact data as a file in vCard 4.0 format. See this Wikipedia article for more information.
File Export  > Export vCard 3.0 ... 	This function allows you to export selected contact data as a file in vCard 3.0 format. This format is similar to vCard 4.0 format.
File Export  > Export vCard 2.1 ... 	This function allows you to export selected contact data as a file in vCard 2.1 format. This format is similar to vCard 3.0 format.
P File Print 	Opens a printer selection dialog. Use the Print Preview dialog below to set up the range of names and the print format before you select this function.
File Print Preview 	Opens a print preview dialog, which also permits you to format the report, select which items to include, and specify a sort order, See  the appendix for further details.
Q File Quit 	Closes the application.
 

The Edit Menu
A screenshot of 's Edit menu.
A screenshot of 's Edit menu.
's Edit menu after clicking the Edit button on the Menubar.
 
The Edit menu lets you access eight main functions, two of which have multiple options.
 
Edit Edit Contact ... 	This has nearly the same effect as clicking the  + New Contact  button on the Toolbar. The difference is that this menu item allows you to edit a contact record that already exists, instead of creating a brand new one. See chapter 2 above for complete details.
X Edit Cut Contact ... 	Performs a Cut operation on the selected contact. A copy of this contact, in vCard 3.0 format, is placed on the clipboard. The Cut will be completed when you Paste this contact somewhere.
Edit Copy Contact ... 	Places a copy of this contact on the clipboard, so you can paste it somewhere else.
V Edit Paste 	Pastes the cut or copied contact at the current location. This may be in the same address book you did the Cut or Copy from, or in another address book. Since the preceding operations placed the contact information on the system's clipboard, you may also paste it somewhere else besides (⪚ into a text editor, or as a vCard 3.0 file in your home folder).
Edit Copy Contact To   > (a variable list) 	Combines the Copy and Paste operations into a single click of the . The list of destinations displayed depends on how many address books you have created.
Edit Move Contact To   > (a variable list) 	Works just like the Copy Contact To operation described above, except that it combines Cut and Paste into a single click of the .
∇Edit Delete Contact 	Delete the selected contact from the current address book.
Edit Delete Address Book 	Delete the current address book. Be careful with this command -- you could lose some data! In theory, this function simply removes the symbolic link between and the associated vCard file or directory (or the hyperlink to a cloud-based service), and the real data will not be altered. Still, it's probably wisest to make a backup copy of this address book somewhere before you delete it.
 

The View Menu
A screenshot of 's View menu.
A screenshot of 's View menu.
's View menu after clicking the View button on the Menubar.
 
The View menu lets you access four main functions, and one experimental feature which doesn't really do anything yet.
 
View Themes   > 	This menu item doesn't really do anything. It will open a Themes dialog, but that dialog is broken in release 5.10.3.
1 View Simple (one column) 	Changes the default three panel layout into a single column. For more details, see  the appendix.
2 View Two columns 	Changes the default three panel layout into two panels. For more details, see  the appendix.
3 View Three columns 	Switches back to the default three panel layout.
View Show QR Codes 	Check this box to display contact information as a QR code. Uncheck it to suppress QR codes.
 

The Action Menu
A screenshot of 's Action menu.
A screenshot of 's Action menu.
's Action menu after clicking the Action button on the Menubar.
 
The Action menu lets you access two data transmission functions.
 
Action Send vCards... 	This option is similar to Send an email..., below, except that after you select some contacts with and your mouse, the message composition window will open with a blank list of addressees, and with files attached (the selected contacts, in vCard 3.0 format). This makes it easy to share selected information with your friends and business associates.
Action Send an email... 	This option provides an alternate method for setting a new email message's recipient list. Press (or ) and select the people to whom you wish to send the new message, by using your . Then click on Send an Email...; this will open a composition window. All the selected contacts will be listed as To addressees.
 

The Tools Menu
A screenshot of 's Tools menu.
A screenshot of 's Tools menu.
's Tools menu after clicking the Tools button on the Menubar.
 
The Tools menu lets you access two data management functions.
 
Tools Merge Contacts... 	This tool allows you to merge the contents of two or more records. To activate it, you must first select two or more contacts (hold or and left-click contacts to make your selection). A dialog box will appear, asking you to verify which contacts you wish to combine, and where the merged record should be saved. Click merge to complete the operation.
Tools Search Duplicate Contacts... 	This tool will search one or more address books for duplicate entries, and offer you the option of merging any duplicate records it finds.
 

The Settings Menu
A screenshot of 's Settings menu.
A screenshot of 's Settings menu.
's Settings menu after clicking the Settings button on the Menubar.
 
 
The Settings menu offers you five options for fine-tuning the way operates.
 
Settings Show Menubar M 	This option allows you to show or hide the Menubar.
Settings Show Toolbar 	This option allows you to show or hide the Toolbar.
Settings Configure Shortcuts... 	This option allows you to customize the keyboard shortcuts available within . See the appendix for more details.
Settings Configure Toolbars... 	This option allows you to customize the contents of 's Toolbar. See the appendix for more details.
Settings Configure ... , 	This option allows you to configure several advanced options. See the appendix for more details.
 

The Help Menu
A screenshot of 's Help menu.
A screenshot of 's Help menu.
's Help menu after clicking the Help button on the Menubar.
 
The Help menu offers seven options.
 
Help Handbook F1 	This option displays a copy of The Handbook via the utility program.
Help What's This? F1 	This is 's built-in help tool. Left-click this option, then move your cursor and click on any one of the first four items on the Toolbar. A brief description of that tool's function will be displayed.
Help Report Bug 	This option opens a dialog that helps you file a bug report at bugs.kde.org, 's main bug tracking page.
Help Donate 	This opens a web page in your browser, where you may donate money to support . We accept euros, dollars, rubles, sterling, yen, yuan, pesos,
Help Switch Application Language 	This option lets you change the language that is used to label the various menu items and built-in help screens. You must quit and restart it before the new language takes effect.
Help About 	Click on this item to learn which release of you're running, which libraries were used to compile / build the executable code, and who the lead programmer is.
Help About 	This option displays information about . Be free!

The Tool Bar
There are five separate tools available on 's Toolbar: New Contact, New Group, Edit Contact, Search..., and a category filter. Here's a picture. (Note that I have only documented the default version of 's Toolbar. You may alter the Toolbar layout by using the Settings menu, if you so desire.)
A closeup of 's Toolbar.
A closeup of 's Toolbar.
's standard Toolbar, up close and personal.
 
New Contact 	This Toolbar button opens the Add New Contact dialog documented in chapter 4, above.
New Group 	This Toolbar button opens the Add New Group dialog documented in the appendix.
Edit Contact 	This Toolbar button opens the Edit Contact dialog documented in chapter 4, above.
[ Search... Q ] 	This tool searches through all the contacts in selected address books as you type. Pressing Q simply positions the cursor inside the Search... box. Be aware that this function searches the entirety of each contact record; a search for and may return not only Andy Brown and Andrew Jones, but also Bill Smith (who happens to work for Brown and Root Construction Company).
A screenshot of 's Search function.
A screenshot of 's Search function.
's Search function in action.
 
[ (All)  ] 	This tool performs a filtering function, based on categories. The two default categories are Untagged and Groups. You can create new categories by associating Tags of your own devising with particular contact records (see Add New Contact in chapter 4, above). Clicking either button will set the selected categories to None; the button will reset the selection criteria to All.
A screenshot of 's Filter function.
A screenshot of 's Filter function.
's Filter function in action.

The Context Menus
When you click the anywhere inside the main Text Area, a context menu will appear, as illustrated below. The particular menu that appears depends on both the panel within which the right-click occurred and the particular data item that was selected, if any.

The Address Book Context Menu
A screenshot of 's Address Book context menu.
A screenshot of 's Address Book context menu.
's Address Book context menu.
 
Add Address Book Folder... 	This context menu option does not perform a useful function in release 5.10.3.
Delete Address Book Folder 	This context menu option does not perform a useful function in release 5.10.3.
Add Address Book... 	This context menu option launches the Add Address Book dialog that is documented in chapter 2, above.
Delete Address Book 	Choosing this context menu option will delete the selected address book. Be careful!
F5 Update Address Book Folder 	This context menu option forces to reload the contact data associated with the selected address book.
Folder Properties... 	This context menu option displays summary information about the selected address book.
Address Book Properties... 	This context menu option displays summary information about the selected address book.
Serverside Subscription... 	This context menu option may or may not perform a useful function in release 5.10.3; so far as I can tell, it is permanently grayed out. If you understand what it does, please let me know (davidbryant AT gvtc.com).
 

The List of Contacts Context Menu
A screenshot of 's Contact List context menu.
A screenshot of 's Contact List context menu.
's Contact List context menu.
 
N New Contact 	Choosing this context menu option has exactly the same effect as clicking the  + New Contact  button on the Toolbar. See chapter 2 above for complete details.
G New Group 	Choosing this context menu option opens a dialog in which you may define a new group, or mailing list. See  the appendix for a detailed explanation.
Edit Contact ... 	Choosing this context menu option has exactly the same effect as clicking the Edit Contact... button on the Toolbar. See chapter 2 above for complete details.
Export  > 	This context menu function allows you to export selected contact data in either vCard or csv format.
Copy Contact To   > 	This context menu choice lets you copy the selected contact(s) to a variable destination. The list of destinations displayed when this option is chosen depends on how many address books you have created.
Move Contact To   > 	Works just like the Copy Contact To operation described above, except that it deletes the source data, instead of creating an extra copy of it.
P Print 	Choosing this context menu item opens a printer selection dialog. Use the Print Preview dialog below to set up the range of names and the print format before you select this function.
Print Preview 	This context menu option opens a print preview dialog, which also permits you to format the report, select which items to include, and specify a sort order, See  the appendix for further details.
∇Delete Contact 	Delete the selected contact(s) from the current address book.
 

The Individual Contact Context Menu
A screenshot of 's Individual Contact context menu.
A screenshot of 's Individual Contact context menu.
's Individual Contact context menu.
 
Depending on which data item you select, the caption in this context menu may vary. But in every case, the function is the same: the selected data item is copied to the clipboard.