Help Center

How every part of it works. Each section has its own link — copy one out of the address bar to send someone straight to it.

Install it

Ham Email is one download and a normal install. Nothing else is needed on your computer.

macOS

  1. Download the disk image from the Download.
  2. Open it and drag Ham Email onto the Applications folder shown beside it.
  3. Open it from Applications or Launchpad. The first launch takes a few seconds longer than the rest.

It runs on macOS 11 and later, on both Apple Silicon and Intel. One download covers both.

Windows

  1. Download the installer. Take the 64-bit one unless you know your PC is 32-bit — almost every machine sold since 2010 is 64-bit.
  2. Run it. The installer is signed, so Windows installs it without a warning.
  3. It appears in the Start menu as Ham Email, with its own menu bar: File, Edit, View, Mailbox, Window and Help.

Which one am I on? On Windows, open Settings, System, About and look at System type. If it says 64-bit, take the 64-bit installer.

Linux

  1. Download the AppImage: x64 for most PCs, ARM for a Raspberry Pi 4 or 5 and other 64-bit ARM machines.
  2. Mark it as executable, in the file’s Properties or with chmod +x in a terminal.
  3. Run it. Ham Email appears with its own menu bar: File, Edit, View, Mailbox, Window and Help.

An AppImage needs no installation and leaves nothing behind but your mail and settings. Some distributions need the libfuse2 package before an AppImage will start.

The setup screen

The first time Ham Email opens it asks you to sign in with your QSL World profile, or to create one, exactly as Ham Browser does. A qslworld.com member signs in with the same email and password, or with Google. Then it offers two ways in.

  • A mailbox you already have. Pick the provider and follow the steps shown for it. This is the usual answer.
  • Your callsign as your address. Choose name@CALLSIGN.com and its ending, pay for QSL World Pro Max in a checkout window, and Ham Email sets it up and adds it. If your callsign already has a domain, through Pro Max or QTH Page, it is listed here instead.

The profile is free and is the only account Ham Email asks for; every mailbox you add is yours, with its own provider.

Adding a mailbox

Ham Email works with any mailbox that offers IMAP for reading and SMTP for sending, which is nearly all of them.

  1. Choose Add account.
  2. Pick your provider — Gmail, Outlook, Yahoo, iCloud, Fastmail, Zoho, Purelymail — or Other for anything else.
  3. Enter your address and your password. For the providers that need an app password rather than your normal one, the screen says so and shows where to get it.
  4. Press Connect. The mailbox appears in the left pane and its folders fill in.

For Other, the servers are worked out from your address, and you can correct the IMAP and SMTP host and port by hand if your provider uses unusual ones. Ham Email uses the implicit-TLS ports, 993 and 465, unless you say otherwise.

Add as many mailboxes as you have. Each keeps its own folders, and Sent, Drafts, Junk and Trash are recognized from the roles the server gives them.

App passwords

Several providers refuse a mail program that offers your normal password, and issue a separate one for the purpose instead. It is a password that works only for mail, and it can be revoked on its own without touching your main sign-in.

  • Gmail: turn on 2-Step Verification in your Google account, then create an app password under Security. It is sixteen characters; paste it where Ham Email asks for the password.
  • Outlook and Microsoft accounts: usually an app password, and some work and school tenants have IMAP switched off entirely, in which case no mail program can connect.
  • iCloud, Yahoo, Fastmail: an app-specific password, generated in the account’s security settings.

If a provider rejects your sign-in, an app password is the first thing to try. The setup screen tells you when it believes that is the cause.

Your callsign as your address

name@CALLSIGN.com is a real mailbox on a domain that is your callsign, provided by QSL World as part of QSL World Pro Max. The domain is registered, a station page is put on it and the mailbox is created for you.

  1. Choose File, Get Your Callsign Email.
  2. Pick the name before the @, then the domain ending. Only endings still free for your callsign are offered.
  3. Pay for QSL World Pro Max in the checkout window that opens.
  4. Choose the mailbox password. The mail service has to accept it, and the line under the field says whether it does; Suggest a strong password always passes.
  5. Confirm the owner details the domain registry needs. Ham Email shows the progress and opens the mailbox when it is live, usually within minutes.

From then on it is one more mailbox in the same window. Everything on this page applies to it. Forgot its password? Get Your Callsign Email lists your callsign mailboxes, each with Reset password.

How callsign email works

Reading

Mailboxes and folders are on the left, the message list in the middle and the open message on the right.

  • Replies and forwards are gathered into a conversation, shown as one row with a count. Open it and the messages read oldest first.
  • A callsign in a sender’s name or address is recognized and shown as one. Click it to look the operator up.
  • Images hosted elsewhere are held back. The message offers to load them, for that message only, when you want them.
  • Sender photos come from Gravatar when the setting is on. Switch it off in Settings and nothing is fetched.

Writing

Press New message, or reply from an open message. Drafts are saved as you write and reopen with every recipient and Cc intact. A message you send from a draft takes the draft with it.

  • Reply, reply all and forward keep the conversation together.
  • Attachments go with the message; drafts keep them too.
  • Your signature, if you set one in Settings, goes on the end.

The writing assistant

Nothing is sent anywhere until you press the button, and the assistant is easy to ignore if you never want it.

  • Your own key. Paste an API key from your provider in Settings. The key is kept on your computer and requests go straight from here to that provider. With a key set, nothing goes through QSL World.
  • The free tier. Sign in with a QSL World profile and you have a metered allowance each day with no key at all. The counter in Settings shows what is left.

Ask it to draft a reply, shorten what you wrote or tidy the wording. What it sends is the text you hand it, and it comes back as a suggestion you can take or leave.

What leaves your computer, and what does not

Mail is kept in a database on your own disk. Ham Email connects from your computer straight to your provider over TLS; nothing is routed through any Ham Email or QSL World server. Your password is encrypted on this computer and sent only to your provider.

  • Remote images are blocked until you ask, so a sender cannot learn when you opened their mail.
  • Sender photos are optional. Off means Gravatar is never contacted.
  • The writing assistant is the one thing that sends text elsewhere, and only when you press the button.

The full list of services the app contacts is in the Privacy Notice.

Updates

Ham Email checks for a new version when it starts and every half hour. When there is one, a notice appears at the bottom of the sidebar with a download button, and stays until you install it. Help, Check for Updates asks at any time, and Help, About Ham Email shows the version you have. Nothing is installed behind your back.

Installing a new version keeps your mailboxes, your mail and your settings.

Your default mail app

Choose File, Make Ham Email the Default Mail App, and email links in other programs open a new message in Ham Email. On macOS and Linux the change is made at once. On Windows the menu opens Settings, Default apps: click the app under Email and pick Ham Email there, because Windows lets only you make that choice.

When something is not working

The sign-in is rejected

Nine times out of ten the provider wants an app password rather than your normal one; see the section above. After that: a typo in the address, or a Microsoft tenant with IMAP switched off.

The servers were not found

Choose Other and enter the IMAP and SMTP host names your provider publishes, with ports 993 and 465. Most providers list them on a page called something like “IMAP settings”.

Pictures in a message are missing

That is the remote-image block doing its job. Choose to load them for that message and they appear.

An old message is not in search

Search looks through what has been fetched to your computer. Choose Search all mail to have the server search everything.

Still stuck

Write to hello@hamemail.com with what you did, what you expected and what happened, your operating system, the version number from About Ham Email, and which provider the account is with. Never send a password.