HAMORA Bridge for Windows

HAMORA Bridge 0.5 only reads: it reads your radio’s frequency, mode and meters, listens to WSJT-X, and receives the APRS your radio hears. It doesn’t transmit or change your radio.

• Windows 10 or 11, 64-bit.
• For your radio: Hamlib for Windows, so HAMORA Bridge can run Hamlib for you, a radio Hamlib supports and its USB cable.
• Icom, Kenwood and Yaesu USB radios need the Silicon Labs CP210x driver, which Windows Update often installs.
• Your phone and the computer on the same network.
• Optional: WSJT-X for FT8 and FT4, and Dire Wolf with a receiver and a sound interface for APRS RF.

For the free programs HAMORA Bridge works with, see Compatibility.

1. Run the installer

   Download the code-signed installer (.exe) from this page, check its checksum (see Verifying your download), and run it.

2. What it installs

   HAMORA Bridge, with its own copy of Python, in Program Files. It runs as a Windows service that starts automatically and restarts if it stops. Your settings and paired phones are kept in ProgramData.

3. Open the setup page

   From the Start menu, open HAMORA Bridge Setup. It shows a 6-digit setup code and opens the setup page in your browser.

4. Allow it on private networks

   When Windows Defender Firewall asks about Python, which runs HAMORA Bridge, allow it on Private networks only.

Running, updating and removing

1. Updating

   Run the newer installer: your settings and paired phones are kept.

After installing, everything happens on HAMORA Bridge’s setup page, in a browser. HAMORA Bridge serves it itself, on your own network: no HAMORA account and no internet are needed. The first visit opens a guided setup in five steps. Everything technical, such as Hamlib models, serial speeds and ports, waits under Advanced, and a normal setup never needs it.

1. Station computer

   Give your station a name, such as “Shack”.

2. Detect radio

   Plug in your radio’s USB cable and turn the radio on. The page shows what it found, such as “Possible radio: Icom IC-7300”. Press Test Radio; when it shows your frequency and mode, press Use This Radio. If Hamlib’s rigctld already runs on the computer, choose Use it. No radio yet? Press Next and add it later.

3. Station software

   WSJT-X appears by itself when it sends to HAMORA Bridge; otherwise the page shows the two settings to type into WSJT-X. Dire Wolf on the same computer is found by itself. Both are optional.

4. Pair HAMORA

   Press Pair HAMORA. Scan the QR code with your phone’s camera, which opens HAMORA, or in HAMORA open More→HAMORA Bridge and type the 6-digit code.

5. Ready

   A last check of everything. Press Finish.

Pairing by QR code or 6-digit code

Only phones you pair can see your station. A pairing code is 6 digits, works once and expires after 10 minutes. HAMORA shows HAMORA Bridge’s address to compare with the page before you confirm. Each phone gets its own pairing, kept in the phone’s secure storage, and you can remove any phone at any time: in HAMORA, or on the setup page under Devices.

Check Station

The setup page shows HAMORA Bridge’s health: Ready, Needs setup or Needs attention. Check Station tests the whole chain and lists each part with what to do, for example “Radio · Not responding — check that the radio is on and its USB cable is connected”. Optional things that are off, such as WSJT-X or MQTT, never count as problems. In HAMORA, More→HAMORA Bridge shows the same health.

For support, Advanced → Download diagnostics saves a file with HAMORA Bridge’s version, settings and recent log. It never contains passwords, codes, tokens or radio traffic.

More in the HAMORA Bridge guide.

• HAMORA Bridge hasn’t been built or tested on Windows yet.
• A USB radio appears as a COM port, such as COM3.
• The installer will be code-signed. You’ll never be asked to bypass a security warning to install HAMORA Bridge.
• HAMORA hasn’t been tested with physical radios yet, so no radio model is listed as supported. See Compatibility.
• Keep HAMORA Bridge on your own network. Never forward its port (8765) on your router.

A checksum shows that the file you downloaded is exactly the file HAMORA published, unchanged on the way. Each release on this page is published with the SHA-256 checksum of every file, next to the file.

1. Work out the file’s checksum

   In PowerShell, in the folder you saved the file in:

   Get-FileHash .\<file name> -Algorithm SHA256

   Copy

   Replace <file name> with the name of the file you downloaded.

2. Compare it with the published checksum

   It prints a long string of letters and digits. It must match the SHA-256 published here for that file exactly. If it doesn’t, don’t open the file: delete it and download it again from this page.

Published checksums

Checking on another computer

If you download the file on a different computer, check it there before copying it:

• On Linux or a Raspberry Pi, in a terminal: sha256sum <file name>
• On a Mac, in Terminal: shasum -a 256 ~/Downloads/<file name>