Home / SimpleHPSDR User Guide

Install and first start

Download, install, the first-start tuning, your band plan and your radio.

Download

Packages for every system are on the Releases page. Take the newest release and the file for your computer:

SystemFile
macOS 14 or laterThe .dmg
Ubuntu, Debian, Raspberry Pi OSThe .deb: amd64 for a PC, arm64 for a Pi
FedoraThe .rpm
ArchThe .pkg.tar.zst
Windows 10 or 11 (x64)SimpleHPSDR-<version>-win-x64-setup.exe

Install on macOS

  1. Open the DMG and drag SimpleHPSDR to Applications.
  2. The app isn't signed by Apple, so the first time, open Terminal and run:
    xattr -dr com.apple.quarantine /Applications/SimpleHPSDR.app
  3. Start SimpleHPSDR. When macOS asks whether it may find devices on your local network, allow it. Without that the radio can't be found.

Install on Linux

Download the package for your distribution, then in a terminal in the folder it's in:

sudo apt install ./simplehpsdr_*.deb        # Ubuntu 26.04, Debian
sudo dnf install ./simplehpsdr-*.rpm        # Fedora
sudo pacman -U ./simplehpsdr-*.pkg.tar.zst  # Arch

SimpleHPSDR is then in the applications menu, or run simplehpsdr. To update, install the new package the same way.

Raspberry Pi

Use the 64-bit Raspberry Pi OS (Trixie or Bookworm) on a Pi 4 or Pi 5, or a CM4 or CM5. The 32-bit edition can't run it. Download the arm64 .deb, then:

cd ~/Downloads
sudo apt update
sudo apt install ./simplehpsdr_*_arm64.deb

apt fetches anything else it needs. To remove it later: sudo apt remove simplehpsdr. The first-start tuning described below takes much longer on a Pi than on a desktop computer, so leave it running.

On a small screen, SimpleHPSDR opens in its touch layout. See Touch screens and small screens, which also covers starting it at login and running it on an ANAN G2's own Pi.

Install on Windows

  1. Run SimpleHPSDR-<version>-win-x64-setup.exe. It installs for you alone, with no administrator password, and adds SimpleHPSDR to the Start menu and to Settings > Apps for uninstalling.
  2. The app isn't signed, so SmartScreen warns the first time. Choose More info, then Run anyway.
  3. If Windows Firewall asks about StationEngine.exe, or asks to let it change your device, say yes, or the radio won't be found.

For a new version, run its setup. Your settings are kept in %LOCALAPPDATA%\SimpleHPSDR, so they carry over to new versions and stay if you uninstall. The .NET and Visual C++ runtimes are included.

To use ASIO, install your audio interface's driver, then pick ASIO under Config > Audio. The driver must be able to run at 48 kHz.

Windows is a preview

Fewer people use the Windows build than the others, so please report what you find.

The first start

The very first start takes a while. The signal processing is measured and tuned for your computer, which takes around 8 minutes on a fast machine and longer on an older one. A window shows the progress. A Raspberry Pi skips this: its package brings the tuning ready-made.

The first-start window: Getting ready for first use, with a progress bar and a note to leave SimpleHPSDR open
The first start. It's slow, not stuck.

Leave the app open until it finishes. If you do quit, it carries on from where it stopped next time (on Windows it starts again). This only happens again after some updates.

Choose your band plan

Next, SimpleHPSDR asks for the band plan for your region or licence class. Pick yours and press Continue.

The welcome window with a list of band plans: IARU Regions 1 to 3, Ireland, United Kingdom, and the US FCC licence classes
Choosing a band plan on the first start.

The plan does three things:

  • It colours the band strip along the top of the panadapter: green where your licence lets you transmit, red where the band is kept for another licence class, and grey for broadcast bands, CB and WWV.
  • It decides what happens when you transmit outside the plan. To start with you get a warning. You can make it block transmit instead in Config > Station.
  • PA calibration uses it to pick its test frequencies, and needs a plan with every HF band including 60 m: US FCC General, Advanced or Extra, United Kingdom or Ireland.

General Coverage has no restrictions, so staying legal is up to you. You can change the plan at any time in Config > Station.

Choose your radio

The radio picker opens next and searches your network. Pick your radio and press Connect.

The Choose a radio window listing two radios found on the network, with an address box, a Radio model list, a tick box to connect automatically, and Firmware, Cancel and Connect buttons
The radio picker. The radios shown here are examples.
  • Radio model. Several radios report the same ID on the network (the ANAN-G2, G2-1K, 7000DLE, 8000DLE, Orion MkII, Anvelina Pro3 and Red Pitaya all look alike), so choose yours when the list appears. It sets the S-meter calibration and the power amplifier and PureSignal defaults. You can change it later in Config > Radio.
  • Connect to this radio automatically next time skips the picker from then on.
  • IN USE beside a radio means another program is controlling it. Taking over stops it there, including any transmission in progress.
  • Or by address. If your radio isn't listed, type its IP address. Leave Protocol 2 lit for a Protocol 2 radio.
  • Firmware… opens the firmware loader for Protocol 2 radios. Read the warning first.

Brick SDRs (Brick2 and Brick3) are recognised and named in the list.

If no radio appears

Check that the radio is on and on the same network, then press Search again, or type its address. If it still isn't found, a firewall is probably dropping its packets. The picker's Network help… button lists exactly what has to be allowed.

The Network help window listing what the radio needs: UDP only, radio ports 1024 to 1044 in both directions, and the StationEngine program to allow
Network help, from the radio picker.

Firewalls

The radio uses UDP only, on radio ports 1024 to 1044 in both directions. This computer's port is 1025 with Protocol 2 and random with Protocol 1, so where your firewall can allow a program rather than a port, allow the StationEngine program.

  • macOS: turn on SimpleHPSDR in System Settings > Privacy & Security > Local Network.
  • Windows: answer yes when asked about StationEngine. If the picker finds nothing and no rule exists, it offers to add the rule again.

TCI and CAT are TCP, on the ports set in Config > CAT & TCI, and only need opening if another computer uses them.

Your first few minutes

  1. Click BAND at the top left and choose a band, then MODE: LSB for voice below 10 MHz, USB above.
  2. Click a signal on the panadapter, or roll the mouse wheel over the frequency to tune.
  3. Set the volume with the AF slider at the bottom left.
  4. If you hear nothing, open Config > Audio and choose your speakers under Speaker output.

The next chapter, The main window, shows what everything on screen is.

Where things live

Settings, the engine's database and its logs are in the app data folder:

macOS~/Library/Application Support/SimpleHPSDR
Linux~/.local/share/SimpleHPSDR
Windows%LOCALAPPDATA%\SimpleHPSDR

engine.log is the log from this start and engine.previous.log the one before. The engine's detailed log is logs/simplehpsdr-app.log. The tuning file from the first start (wdspWisdom01) is there too. Recordings are WAV files in Music/SimpleHPSDR.

To move to another computer, or before trying something risky, use Back up in Config > Station: it saves all your settings to one file.