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 Browser is one download and a normal install. Nothing else is needed on your computer.

macOS

  1. Download the disk image from the download page.
  2. Open it and drag Ham Browser 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 Browser.

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.

Your account

Browsing, the maps, the Radio Programmer and rig control need no account at all. One free account unlocks the parts that have to know who you are: the logbook, Grid Rush, QSL cards and the CW Room. It is a QSL World account, so if you already have one, use it.

  1. Open Operator Profile from the dashboard, or click the person icon in the toolbar.
  2. Sign in, or choose Create profile and give your email, a password and your callsign.
  3. Fill in your station details — grid square, name, QTH. Press Locate me and it fills the grid from where you are.

Forgotten the password? Choose Forgot password and a six-digit code is emailed to you.

Your account signs in one computer at a time. Signing in on the laptop signs the shack computer out.

Getting around

Ham Browser is a normal browser with a second toolbar. The top row is the address bar and your tabs. The row under it is the ham bar: a search box on the left and the tools on the right.

The ham bar

Dashboard, Mail, Logbook, Map, Spots, Grid Rush, CW Room, Grey Line and Settings. On the right sit your callsign, the CAT badge showing whether a radio is connected, and a clock that is always UTC.

The search box searches the web, or looks up a callsign — use the selector beside it to choose. Typing a bare callsign in the main address bar looks it up too.

Hide the whole bar with ⇧⌘H (Shift+Ctrl+H on Windows) and bring it back with the same keys, or the small chevron it leaves behind.

The menu

The hamburger at the right end of the toolbar opens the same menu on every platform, with the shortcuts written for your system. On a Mac the menu bar at the top of the screen has everything too. Tools holds Contest Check, Watch, the Radio Programmer, the CAT console, Passwords and Extensions; Integrations deep-links to the QRZ, LoTW and CAT settings.

Shortcuts worth knowing

  • ⌘T new tab · ⌘N new window · ⇧⌘P private window
  • ⇧⌘T reopen the tab you just closed · ⌘W close this one
  • ⌘L jump to the address bar · ⌘F find on the page
  • F9 the Speed Log sidebar · F10 the AI sidebar
  • ⌘D bookmark · ⌘J downloads · ⌘Y history (Ctrl+H on Windows)

Use Ctrl in place of ⌘ on Windows.

The logbook

Open it from the ham bar, or press F9 for the Speed Log sidebar beside whatever you are reading. Everything is stored in your QSL World account and mirrored to this computer, so it keeps working when the network does not.

Log a contact

  1. Type the callsign in the box at the top left and press Add QSO.
  2. Band, mode, date and time fill themselves in. If a radio is connected they follow the rig.
  3. Add the reports, and anything else you want to keep.
  4. Press Save. The contact appears at the top of the list.

Country, name, grid and distance fill in by themselves from the callsign where they can be found. What you type is never overwritten — only blanks are filled.

Find one again

The search box takes a callsign or a name. The dropdowns filter by country, band and mode, and the column headers sort. Click any row to open the full record, with tabs for the QSO, the other operator, your station and the QSL details.

The columns

The icons on the right of each row are the confirmations: LoTW, eQSL, QRZ and QSL World. Filled means confirmed. The star marks a contact you flagged.

Logbook templates

A template changes the entry form to suit the operating you are doing. Choose one in the logbook settings, under the gear icon.

  • Classic — the everyday form.
  • POTA activator — the park reference fills in from your location. POTA hunter for working them.
  • SOTA — summit names and points fill themselves in.
  • WWFF and IOTA — reference fields for each.
  • Contest — serial numbers that increment by themselves, and the sent and received exchange fields Cabrillo needs.
  • Satellite — the bird, the satellite mode, and six-character grids for both ends.
  • VHF/UHF weak signal — propagation mode, both grids and the distance.
  • DXpedition / portable and Rag chew / net.

Changing template never changes contacts you have already logged; it only changes which fields the form shows you next.

Speed Log

Press F9. A narrow logging panel docks to the side of whatever page you are on, so you can log while reading the cluster, a contest page or QRZ.

It is the same log: a contact saved here appears everywhere else immediately, and Grid Rush lights up the square without waiting for anything.

Press F9 again to put it away.

Import and export

Bring a log in

  1. In the logbook, open Import / Export above the list.
  2. Choose your ADIF file, or drag it onto the page.
  3. Check the summary before confirming — it reports how many records it read and any it could not.

If the file was logged under a different callsign than the one you are signed in as, it asks rather than guessing.

Take it out

The same panel exports the whole log, or just what your filters are showing, as ADIF. Contest Check exports Cabrillo as well.

Squares you worked years ago count in Grid Rush the day you log them. Importing an old ADIF is the fastest way to move that score.

Logbook of The World

Uploading runs through the ARRL’s own TrustedQSL program on your computer, so your certificate and its private key never leave it.

Set it up

  1. Install TrustedQSL from the ARRL and set up your callsign certificate in it, as you would anyway.
  2. In the logbook settings, open the LoTW card. Ham Browser finds TrustedQSL by itself and lists the station locations you have already defined in it.
  3. Add your LoTW website login as well if you want to download confirmations.

Upload

Press Upload to LoTW. It signs and sends everything not sent yet, and tells you what happened. If TrustedQSL asks for your certificate passphrase, Ham Browser asks you for it then — not before.

Download

Import from LoTW fetches your matches and ticks the LoTW column on every contact that has one.

QRZ.com

QRZ needs an API key from a QRZ Logbook subscription.

  1. On QRZ.com open your logbook settings and copy the API key.
  2. In Ham Browser, logbook settings, open the QRZ.com card and paste it.

Import from QRZ pulls your QRZ logbook in. Upload to QRZ pushes contacts that are not there yet. The QRZ column then shows which are confirmed.

eQSL

  1. In the logbook settings open the eQSL card.
  2. Enter the callsign and password you use at eqsl.cc and save.
  3. Press Upload to eQSL.

It goes in batches, showing progress as it works, and you can stop it at any point and pick up later. A batch is only marked as sent when every contact in it is accounted for, so nothing is ever ticked that eQSL did not take.

“No match on eQSL_User/Pswd for date…” is not a password problem — the login already worked. It means no account on your eQSL profile covers that date. Fix the QTH date ranges on eqsl.cc, or set the QTH nickname, and run it again.

QSL cards

Your card is your identity, drawn for every contact the moment it is logged. Nobody has to send anything, and redesigning it changes every card you have ever “sent”.

Design it

  1. Open QSL Cards from the dashboard, then the Editor tab.
  2. Start from Templates — twenty of them, including the classic designs.
  3. The rail on the left adds things: Insert for text, pictures and a map of the path; Library for frames, flags, emoji and service logos; Fields for the contact details; Ground for the background.
  4. Anything in curly braces, like {CALL}, fills itself in per contact. Press Real QSO to see it with a genuine contact’s details.
  5. Save card.

What is on it

Drag to move, drag a corner to resize, double-click text to edit it. Pick a piece and its properties appear on the right; the layers list underneath shows everything on the card and lets you reorder or hide a piece.

Your album

The Album tab holds every card other operators have for you — one pile per operator, newest on top, drawn with their design.

  • Everyone who worked me is every contact another operator logged with you. Nothing needs sending; a card appears as soon as their log reaches QSL World.
  • Paper cards is the ones you hold. Add cards received via mail files a photograph against the contact it confirms, and can log the contact if it is missing.
  • Filter by Received, Sent, Confirmed or Not in your log.

Click a card to open it large, with the distance, the bearing, a map of the path and the operator’s details. If the contact is missing from your log, Add to my contacts logs it and confirms it both ways.

Open the album book turns it into a real book: full screen, page turns by click or drag, ← and → to move, Esc to close.

Grid Rush

The world is 32,400 grid squares, and every contact you have logged already claims one. Open it from the ham bar; the first visit walks you through the rules.

How the score works

  • 10 for holding a square at all.
  • +1 per 500 km from your station, up to +40.
  • +5 for each extra band into it, up to +30, and +3 per extra mode, up to +15.
  • +1 per contact after the first, up to +25.
  • × 1.5 if any contact there is confirmed.
  • +25 for every field where you hold three squares or more.

The Score tab shows every term, and clicking any square spells out its own arithmetic.

Getting around the board

  • The tabs are Grids, Recent, Fields, Badges, Ladder and Score.
  • Switch between the globe and the flat map with the buttons above it, and pick from six map styles. 3D raises each square by its score.
  • Colour by points, contacts, bands or how recently you worked them.
  • Frontier draws every unworked square touching one you hold — that is where to point the antenna.
  • F for full screen, Esc to come back.

Recon

Open a square and press Recon to see what is actually down there: the town, the weather right now, whether they are in daylight or on the grey line, everyone you have worked there, and the short and long path from your antenna.

If it says the copy of your log on this computer is short, press Copy my log to this computer. The board is scored from that copy, so a short copy scores short.

Spots

Live activity as a list and on a map. The tabs across the top are the sources: DX from the cluster, Live from your own cluster connection, POTA and WWFF.

  • Filter by band and mode, or search for a callsign or a park.
  • Paths draws a line from each spotter to the station they heard.
  • Click a spot to look the operator up, or to start a contact.
  • Spot a station posts to the DX cluster from this computer, under your callsign.
  • Spot me self-spots on POTA. Self-spotting is normal there; on the DX cluster it is not, so it is not offered.

Set your own cluster node in Settings, under DX Cluster.

Watch

Callsigns you want to be told about. Open it from Tools or the dashboard.

  1. Type a callsign and press add. Partial prefixes work — VP8 matches every Falklands station.
  2. Choose how fresh a spot has to be to count, from 15 minutes to 4 hours.
  3. To be emailed as well, pick one of your own mail accounts and the address to send to, then press Send test to prove it works.

When one of them appears on any feed, a chip appears beside the clock. Currently spotted shows what from your list is on the air now.

CW Room

Live Morse over the internet, sent and copied by ear. No licence and no radio needed, and nothing is transmitted on an amateur band.

Sending

Hold the space bar, or the CW KEY button, as a straight key: short for a dit, long for a dah. Stop for a moment and what you sent is decoded and transmitted automatically. There is no send button.

The channels

Forty of them. Channel 1 is for calling — work someone there, then move to a free channel, exactly as you would move off a calling frequency. Channel 2 is ELMER, for slow CW and learners. Channel 3 is for rag chews. The arrow keys tune.

Practising

Switch to TRAINING and you get a private channel nobody else can hear, where HAMILTON — an AI operator — will answer you. It is patient with a poor fist and happy to be your first ever contact. The coach panel translates what came in, suggests what to send, and can play it before you send it.

The knobs set speed, tone and volume, and are remembered between sessions. Drag them up and down, or scroll on them.

Contest Check

Check a contest log before you submit it. Everything runs on your own computer; nothing is sent anywhere unless you choose to.

  1. Open Contest Check from Tools or the dashboard.
  2. Drop your Cabrillo or ADIF file on the page, or choose it.
  3. Read the Checks tab.

It looks for missing or malformed headers, frequencies outside the amateur bands, reports that do not match the mode, duplicates, contacts out of time order, a sent exchange that varies between lines, implausible callsigns, working yourself, and rates that cannot be right.

The other tabs show your rate, bands, modes and hours, and a map of where you were heard. Submit links the sponsor’s own robot, matched from the contest name in your file, and separately lists the places to upload for confirmations — which are not the same thing as entering.

Export writes Cabrillo, ADIF, CSV or the findings as text. Duplicates are marked, never removed: taking a contact out is your decision.

Maps and the globe

Map in the ham bar plots every contact in your log. The buttons at the top left change the view:

  • A flat map, or a 3D globe you can spin.
  • A day and night view.
  • A Lambert projection centred on your station.
  • An azimuthal map centred on your station — the one that shows the true beam heading to everywhere, and the one to use when pointing an antenna.

Choose a basemap from the layers button, filter to one logbook, and use the expand button for full screen. The view you leave it in is the view you come back to.

Grey line and satellites

Open Grey Line / Sat Tracker from the ham bar or the dashboard.

  • The day and night line, drawn in real time over terrain, satellite, street or night maps.
  • Tick Satellites to plot the amateur birds with their footprints, and Ground track for where they are heading.
  • My QSOs and Grid fields overlay your own log.
  • Underneath: solar flux, the K index, the estimated MUF, sunspot number, X-ray flare level and aurora, and a band-by-band forecast for your station right now.

When a satellite is workable from where you are, a chip appears beside the clock with its name and how long the pass lasts. Click it to open the map.

Mail

A full mail client for any IMAP mailbox. Your card manager sends cards through it, and Watch sends its alerts from it.

  1. Open Mail from the ham bar.
  2. Choose your provider — Gmail, Outlook, iCloud, Yahoo, Fastmail, Zoho, Purelymail, or Other for anything else.
  3. Follow the steps it shows. Most providers need an app password rather than your normal one, and the page explains how to get one for the provider you picked.

For any other server, choose Other and it works the settings out from your address; you can correct them by hand.

Mail connects from your computer straight to your provider over an encrypted connection. Remote images in a message are blocked until you allow them, message by message.

Radio Programmer

Program a radio’s channels over a USB programming cable, with the CHIRP engine and its 551 radio models, in a tab.

  1. Open Radio Programmer from the dashboard or the Tools menu.
  2. Pick your make and model.
  3. Plug the programming cable in and choose the port, or leave it on Automatic.
  4. Press Read from Radio first — always — and keep the file. That is your way back.
  5. Edit the channels: frequency, mode, tone, offset, name, scan settings. Every field is checked against what your radio can actually do.
  6. Press Write to Radio.

Read before you write, every time. A radio written with settings from a different model can be left in a state that needs a factory reset.

Repeater Map shows your channels geographically. Import and export .img files to keep or share a configuration.

Rig control

Open the CAT Console from the dashboard, or click the CAT badge in the toolbar.

  1. Choose your radio from the list — Icom and Xiegu CI-V, Yaesu, Kenwood, Elecraft, FlexRadio, QRP Labs and (tr)uSDX are covered, 67 models in all.
  2. Set the baud rate to match the one in your radio’s own menu. This is the setting that catches people out.
  3. For an Icom, check the CI-V address matches too. The console fills in the default for the model.
  4. Press PWR to connect.

Frequency, mode, band, split and the levels are all there, and everything sent and received is logged at the bottom if you need to see it.

Once connected, the badge beside the clock turns green and the logbook fills band and frequency from the radio as you log.

The AI assistant

Bring your own account. Nothing is sent anywhere until you set one up.

  1. Open AI Assistant from the Tools menu.
  2. Choose Anthropic or OpenAI and paste an API key from that provider.

The key is kept on your computer and requests go directly to the provider you chose. Summarize current page reads the page in the active tab.

F10 opens a sidebar with your own Claude or ChatGPT account beside whatever you are reading. Selecting text on any page and right-clicking also offers to proofread it, improve it, shorten it or make it more formal.

Passwords and private windows

When you sign in to a site, Ham Browser offers to remember it. Saved sign-ins are encrypted on your computer, and filling one in asks for Touch ID, Windows Hello or your confirmation first. Manage them under Tools, Passwords, where you can search, reveal and delete.

Choose Never for this site in the save prompt to stop being asked for that site.

⇧⌘P opens a private window. Its cookies, its sign-ins and its cache are thrown away when you close it, and nothing goes into your history.

Make it your default

Open the menu and choose Set as default.

  • macOS: the setting lives in System Settings, under Desktop & Dock, as Default web browser. Ham Browser opens that pane for you.
  • Windows: open Settings, Apps, Default apps, find Ham Browser and set it for HTTP and HTTPS.

Updates

Ham Browser checks for a new version shortly after it starts and tells you when there is one. Nothing is installed behind your back.

To check by hand, open the Help menu and choose Check for Updates. Installing a new version keeps your log, your settings, your bookmarks and your saved passwords.

When something is not working

The logbook will not load

Check you are signed in — the person icon in the toolbar shows your callsign when you are. If qslworld.com is unreachable the logbook works from the copy on your computer and says so; contacts you log meanwhile are sent when the connection returns.

The radio will not connect

Nine times out of ten the baud rate in the CAT console does not match the one in the radio’s menu. After that: the wrong port, a cable that is charge-only rather than data, or another program already holding the port — close WSJT-X or your other logger and try again.

The map is blank

Maps need the network. If the rest of the web is working and a map is not, reload the page.

Grid Rush shows fewer squares than I expect

It scores from the copy of your log on this computer. Open Local Logbook from the File menu and press Sync now.

Still stuck

Write to hello@hambrowser.com with what you did, what you expected and what happened. Your version number is in the menu under About Ham Browser.