Adding accounts
Cheaha Contacts
Cheaha Contacts shows the contacts from as many accounts as you like, side by side. Changes you make are saved to the account, so they appear on your phone and your other devices too.
Adding an account
- Click Add Account at the bottom of the left column. You can also choose Add Account… from the More menu (the three dots at the top right), from the File menu on a Mac, or click Add in Settings, on the Accounts page.
- Choose the account type: iCloud, Google, Microsoft 365, Exchange Server, Fastmail, Yahoo or Other CardDAV.
- Fill in what that type asks for (below), and click the button at the bottom.
Before it saves the account, Cheaha Contacts checks that it can sign in and find your address books, and tells you if something is wrong. If the server simply didn't answer (it may be down, or you may be offline), Save Without Checking saves the account anyway, and the app tries again on the next refresh.
The Description field is the account's name in the left column, such as "Personal" or "Work". Leave it empty and the app uses the provider's name.
iCloud
iCloud needs an app-specific password, not your usual Apple Account password.
- Click Make an app-specific password… to open your Apple Account page in your browser. Under Sign-In and Security, choose App-Specific Passwords and make one.
- In Cheaha Contacts, enter your Apple Account email address as the User name and paste the app-specific password as the Password.
- Click Sign In.
iCloud keeps one address book per account, so you can't make more address books in it.
Google (Gmail and Google Workspace)
You sign in to Google on Google's own page, in your web browser. Cheaha Contacts never sees your Google password.
- Choose Google and click Sign In with Google.
- Your browser opens Google's sign-in page. Sign in, and allow access to your contacts.
- When the page says "You're signed in", close the tab and go back to Cheaha Contacts. It finds your address book and adds the account.
Cheaha Contacts reaches Google Contacts over CardDAV, the standard way to sync contacts. A few things to know:
- Google keeps one address book per account.
- Google's labels (its contact groups) aren't shown, and you can't make groups in a Google account.
- If the app later says your Google sign-in has expired, open the account (see "Changing or removing an account" below) and click Sign In Again….
Microsoft 365 and Outlook.com
Use Microsoft 365 for Outlook.com and Hotmail addresses, and for work or school accounts on Microsoft 365 (Exchange Online). As with Google, you sign in on Microsoft's own page in your browser, so the app never sees your password.
- Choose Microsoft 365 and click Sign In with Microsoft.
- Sign in in your browser and allow access to your contacts. When the page says "You're signed in", go back to Cheaha Contacts.
Your Contacts folder, and the folders inside it, each appear as an address book. Microsoft 365 stores contacts in its own fixed format, so a few things work differently:
- A contact can have up to three email addresses; one mobile, two home and two work phone numbers (no other kinds, such as fax or pager); one home, one work and one other address; and one web address.
- Of related names, only a spouse and children are kept. Of dates, only a birthday, and it needs a year.
- There's no place for maiden names or social profiles.
- Instant messaging addresses are kept (up to three), but without the name of the service.
- You can't make groups in a Microsoft 365 account.
- If a card has something Microsoft 365 can't store, Cheaha Contacts tells you what to change instead of quietly dropping it.
Pictures are downloaded the first time you open a card after it has changed.
Exchange Server
Choose Exchange Server for an Exchange server your organization runs itself. (For Exchange Online, choose Microsoft 365 instead.)
- Enter your email address as the User name (or DOMAIN\user), and your network password.
- Leave Server empty: Cheaha Contacts finds your server from your email address, as Outlook does. If it can't, it says so; ask your IT department for the server's address, or look in Outlook's account settings, and type it in.
- If you sign in as DOMAIN\user, you need to type the server's address yourself.
Each contact folder in your mailbox appears as an address book. Exchange, like Microsoft 365, stores contacts in a fixed format: up to three email addresses, a limited number of each kind of phone number, one home, one work and one other address, one web address, and among related names only a spouse, children, an assistant and a manager. It has no place for maiden names or social profiles, and you can't make groups in an Exchange account. If a card has something Exchange can't store, Cheaha Contacts tells you what to change. Pictures are downloaded the first time you open a card after it has changed. Deleted contacts and address books go to Deleted Items in your mailbox.
Fastmail
Fastmail needs an app password. In Fastmail, go to Settings, then Privacy & Security, then App passwords, and make one with access to contacts (CardDAV). Enter your Fastmail address and that app password, and click Sign In.
Yahoo
Use Yahoo for Yahoo and AOL contacts. Yahoo needs an app password: in your Yahoo account security settings, choose Generate app password. Enter your Yahoo address and that app password, and click Sign In.
Other CardDAV servers
Other CardDAV works with Nextcloud, Radicale, Baïkal, Synology, Zoho, mailbox.org, Posteo and any other server that offers CardDAV.
- Enter your user name and password.
- Enter the server's address in Server, such as carddav.example.com. You don't need the exact path to your address books: Cheaha Contacts finds them.
- Click Sign In.
Many providers want an app-specific password rather than your usual one. If your password is turned down, check your provider's help for "app password" or "CardDAV".
Local Contacts
Local Contacts is always there. Its cards are kept only on this computer: they aren't sent anywhere, and they don't appear on your other devices. It's useful when you don't want an online account, or for cards you want to keep private. Local Contacts can't be removed, and has no settings to change.
You can copy or move cards between Local Contacts and your other accounts at any time. See Adding and editing contacts.
Changing or removing an account
- Right-click an account's name or address book in the left column and choose Account Settings…, or open Settings, go to Accounts, select the account and click Edit… (or double-click it).
- To change a password, type the new one. Leave Password empty to keep the one you saved.
- For Google and Microsoft 365, click Sign In Again… if the app says your sign-in has expired.
- The account type can't be changed once it's added; add a new account instead.
To remove an account, open Settings, go to Accounts, select it and click Remove. Its contacts are removed from this computer, along with its saved password or sign-in. They stay on the server and on your other devices.
The order of the accounts on the Accounts page is the order in the left column. Use Move Up and Move Down to change it.
Keeping up to date
Cheaha Contacts checks your accounts for changes when it opens, and then every 15 minutes. You can change how often, or turn it off, in Settings. To check now, click Refresh contacts in the header bar, or press Cmd+R (Mac) or Ctrl+R (Windows, Linux).
Only what changed is downloaded. When you change a card that someone has also changed on another device, Cheaha Contacts doesn't overwrite their change: it says so, refreshes the card, and you can make your change again.
If an account has a problem, such as a wrong password or an expired sign-in, a warning sign appears beside its name in the left column; point at the name to read the message. Settings shows it on the Accounts page too. See Troubleshooting for more help.
Passwords and sign-ins
Passwords for iCloud, Fastmail, Yahoo, Exchange and other CardDAV accounts, and your Google and Microsoft sign-ins, are kept in your computer's secure storage: the Keychain on a Mac, encrypted with your Windows account on Windows, and the desktop keyring on Linux. On a Linux desktop without a keyring, they're kept in a file that only your user account can read. See Settings, shortcuts and your data.