Settings, shortcuts and your data
Cheaha Contacts
Opening Settings
Click the gear in the header bar, or choose Settings… from the More menu (the three dots). On a Mac, you can also choose Settings… from the Cheaha Contacts menu, or press Cmd+comma.
Settings has two pages, General and Accounts. Changes take effect straight away; there's nothing to save.
General
Names
- Show first name: Before last name ("Jane Appleseed") or Following last name ("Appleseed, Jane").
- Sort by: Last Name or First Name. The part of the name the list is sorted by is shown in bold. Company cards sort by their company name.
New contacts
Default address book is where new cards go when All Contacts is selected. With an address book or group selected, new cards go there instead. You can also right-click an address book in the left column and choose Use for New Contacts.
Refresh contacts
How often Cheaha Contacts checks your accounts for changes: every 5, 10, 15 or 30 minutes, every hour, or Manually. It starts at every 15 minutes. The app always checks when it opens, and you can check at any time with Refresh contacts in the header bar.
Accounts
The Accounts page lists your accounts, with any problem beside each one.
- Add adds an account.
- Edit… (or a double-click) changes the selected account's password, description or sign-in.
- Remove removes it from Cheaha Contacts. Its contacts stay on the server.
- Move Up and Move Down change the order of the accounts in the left column.
See Adding accounts for each kind of account.
Appearance
Cheaha Contacts follows your system's light or dark appearance. To make more room for the list and the card, hide the left column with Show or hide groups at the left of the header bar, or press Cmd+Option+L (Mac) or Ctrl+Alt+L (Windows, Linux). The app remembers whether it was hidden.
Keyboard shortcuts
On a Mac, use Cmd; on Windows and Linux, use Ctrl. Where a shortcut uses Option on a Mac, use Alt on Windows and Linux.
- New card: Cmd+N
- New group: Cmd+Shift+N
- New smart group: Cmd+Option+N
- Edit the card, and Done: Cmd+L (in the list, Return also starts editing; while editing, Cmd+Return saves)
- Cancel editing: Esc
- Delete the selected cards: Delete or Backspace, in the list
- Go to My Card: Cmd+Shift+M
- Undo: Cmd+Z
- Redo: Cmd+Shift+Z (also Ctrl+Y on Windows and Linux)
- Import vCards: Cmd+O
- Export vCards: Cmd+Shift+E
- Refresh: Cmd+R
- Show or hide groups: Cmd+Option+L
- Search: Cmd+F (Esc clears the search; Return or the down arrow goes to the list)
- Settings (Mac only): Cmd+comma
The More menu lists every command with its shortcut.
Where your data is kept
Cheaha Contacts keeps a copy of every account's contacts on your computer, so it opens quickly and works offline. Each card is kept as an ordinary vCard file, along with your settings, the list of your accounts and your smart groups. These files aren't encrypted, so they're as safe as your user account on this computer. Edit your contacts in the app, not in these files.
- Mac (from the App Store): in the app's own container, under Library/Containers in your home folder.
- Windows: in the Contacts folder of your user profile's application data.
- Linux: in ~/.config/Contacts.
Passwords and sign-ins are not in these files. They're kept in your computer's secure storage:
- Mac: the Keychain.
- Windows: a file encrypted with your Windows account (Windows Data Protection).
- Linux: your desktop's keyring (Secret Service). On a desktop without a keyring, they're kept in a file in the app's data folder that only your user account can read.
Google and Microsoft sign-ins happen on their own pages in your browser, so Cheaha Contacts never sees those passwords. It keeps only the sign-in that lets it reach your contacts. Removing an account removes its contacts from this computer and forgets its password or sign-in.
Cheaha Contacts connects only to your own accounts' servers (and, on Linux, to check for updates). It has no ads, analytics or tracking. Opening an address on a map, a web page or a social profile hands it to your map app or browser, only when you click it. For details, see the privacy policy.
Updates
- Linux (AppImage): Cheaha Contacts checks for a new version half a minute after it starts and then once a day. When there is one, an Update to… button appears at the bottom right of the window. Click it to download and install the update; the app checks the update's signature, replaces itself and restarts. To check now, or to stop it checking by itself, click About Cheaha Contacts (the "i" in the header bar) and use Check for Updates… or Check automatically.
- Copies installed from the Microsoft Store or the Mac App Store are updated by the store, and don't check for updates themselves.
See Installing and updating for more.
Getting help
If something isn't working, see Troubleshooting, or contact support.