Troubleshooting

Most problems have a quick fix. Find yours below. If it doesn't help, contact us and we'll sort it out.

The sign-in code doesn't arrive

When you sign in to your Almanac Account, we email you a 6-digit code. If it doesn't arrive:

1. Wait a minute or two. Emails sometimes take a little while.
2. Check your spam or junk folder, and any “Promotions” or “Updates” tabs.
3. Check the email address. It has to be the address you used at checkout. Click Use a different email in Settings › Licence to correct it.
4. Request a new code. Click Resend code. Use the code from the latest email: each code expires after 10 minutes.

If you see “That code is incorrect or has expired”, check the most recent email or send a new code.

“Too many attempts. Try again in an hour.”

To protect your account, only a few codes can be requested for each email address per hour, and there's a limit on wrong attempts. If you see a message like “Too many codes requested for this email. Try again in an hour”, wait an hour and try again. Requesting more codes in the meantime won't help.

“All your licences are in use”

Each licence covers one Mac. This message means every seat on your account is already used by another Mac. You can:

• Free a seat: click Remove next to a Mac you no longer use in Settings › Licence, or Deactivate it on your account page. Then sign in again on this Mac.
• Add a seat: click Buy Another Licence…, or increase the number of Macs under Manage billing on your account page.

See Licence and billing for more.

“This Almanac Account has no active licence”

• Make sure you signed in with the same email you used at checkout. A different address creates a separate, empty account.
• If your subscription was cancelled or a payment failed, check its status on your account page.
• If you've just bought, wait a moment and click Refresh in Settings › Licence.

Almanac says it's read-only

Creating and editing are paused when there's no valid licence. The banner tells you why:

• “Your free trial has ended” or “Your licence has expired”: sign in or buy a licence in Settings › Licence.
• “Reconnect to the internet to renew this Mac's activation”: Almanac needs to check in with your Almanac Account at least every 30 days. Connect to the internet and open Settings › Licence. It renews automatically.

You can still view your calendars and join meetings in the meantime.

“Almanac can't be opened” or “Apple could not verify…”

Some builds of Almanac aren't yet notarised by Apple, so macOS warns you the first time you open them. To open Almanac anyway:

1. In Finder, open your Applications folder.
2. Right-click (or Control-click) Almanac and choose Open, then click Open in the dialog.

On macOS 15 and later, if there's no Open option, try to open Almanac once, then go to System Settings › Privacy & Security, scroll down and click Open Anyway next to the message about Almanac. You only need to do this once.

An account isn't syncing

An account with a problem shows a warning in Settings › Accounts. Select it to see the error, then try these steps:

1. Check your internet connection and click Sync Now.
2. iCloud: make sure you used an app-specific password from account.apple.com, not your Apple ID password. If you've changed your Apple ID password, app-specific passwords may stop working. Create a new one, remove the account and add it again.
3. Fastmail: use an app password with CalDAV access.
4. Google or Microsoft: remove the account and add it again to sign in afresh. If some Google calendars are missing, use the Choose which calendars sync link in the account's details.
5. CalDAV or Nextcloud: check the server address, user name and password.
6. Todoist: if you reset your API token in Todoist, add the account again with the new token.

Removing an account only removes Almanac's copy on your Mac. Nothing is deleted from the service.

Widgets don't appear

• Make sure Almanac is in your Applications folder, not running from the disk image or Downloads.
• Open Almanac once after moving it, then look for the widgets again in Edit Widgets….
• If they still don't appear, restart your Mac.

Alerts or meeting pop-ups don't show

• Check that notifications for Almanac are allowed in System Settings › Notifications.
• Check that the calendar's alerts aren't muted in Settings › Calendars & Lists.
• Keep Run in background on in Settings › General, so Almanac keeps working after you close its windows.

Contact support

Email [email protected] or use the contact form. In the app, Contact Support… in Settings › Licence starts an email with your licence ID filled in.

It helps if you tell us:

• your macOS version and Mac model;
• which account type is affected (for example iCloud or Google);
• the exact error message, or a screenshot.

Please never send us your passwords or app-specific passwords.