Skip to content

Installation

Jump to bottom
Rick de N8SDR edited this page Apr 6, 2026 · 1 revision

Installation Guide

This page walks you through everything you need to get SDRLogger+ up and running — from downloading the installer to your first logged QSO.

Download

Get the latest installer from the GitHub Releases page:

https://github.com/N8SDR1/SDRLoggerPlus/releases/latest

Download the .exe installer file listed under Assets.

Step-by-Step Installation

  1. Run the installer — Double-click SDRLoggerPlus_Setup_vX.XX.exe.
  2. Accept the UAC prompt — Windows will ask if you want to allow the app to make changes. Click Yes.
  3. Choose an install path — The default is C:\SDRLoggerPlus. You can change this, but the default is recommended.
  4. Optional shortcuts — Choose whether to create a Desktop shortcut and/or a Start Menu entry.
  5. Complete the install — Click Install and wait for the progress bar to finish.
  6. Launch SDRLogger+ — Leave the "Launch SDRLogger+" checkbox checked and click Finish, or launch it later from your Desktop or Start Menu.

Tip: Your user data (log database and settings) is stored in %APPDATA%\SDRLoggerPlus, not in the install folder. This keeps your data safe even if you reinstall or change the install path.

First Run

When SDRLogger+ launches for the first time:

  1. A browser window opens automatically to http://127.0.0.1:5000 — this is the SDRLogger+ interface.
  2. A system tray icon appears in the Windows notification area (bottom-right). Right-clicking it gives you options to open the browser, or exit the app.
  3. The Settings panel is accessible from the main navigation. On first run, fill in at minimum:
    • Your Callsign and Name under My Station
    • Your TCI Host/Port if using Thetis (defaults are usually correct)
    • Any lookup or upload service credentials you want to use

Note: If your browser does not open automatically, navigate manually to http://127.0.0.1:5000.

Upgrading from a Previous Version

Upgrading SDRLogger+ is safe — your log database and settings are never touched by the installer or uninstaller.

  1. Download the new installer from the releases page.
  2. Exit SDRLogger+ (right-click the tray icon → Exit).
  3. Run the new installer. It will install over the existing version automatically.
  4. Launch SDRLogger+ — your settings and contacts are exactly where you left them.

Your data lives in:

%APPDATA%\SDRLoggerPlus\

This folder contains hamlog.db (your log), config.json (your settings), and any other app data.

Uninstalling

To uninstall SDRLogger+:

  1. Open Windows Settings → Apps → Installed apps (or Add/Remove Programs on older Windows).
  2. Search for SDRLogger+ and click Uninstall.
  3. Follow the prompts.

Important: Uninstalling SDRLogger+ does NOT delete %APPDATA%\SDRLoggerPlus. Your log database and settings are preserved. If you want to fully remove all data, delete that folder manually after uninstalling.

Running from Source

If you prefer to run SDRLogger+ directly from the Python source (useful for development or if you want to run on an unsupported platform):

Prerequisites

  • Python 3.10 or newer
  • Git (optional, to clone the repo)

Steps

# Clone the repository (or download and extract the ZIP)
git clone https://github.com/N8SDR1/SDRLoggerPlus.git
cd SDRLoggerPlus

# Install dependencies
pip install -r requirements.txt

# Launch the app
python launcher.py

The app will start and your browser should open to http://127.0.0.1:5000 automatically.

Tip: Consider using a Python virtual environment (python -m venv venv) to keep dependencies isolated.

Troubleshooting Install Issues

Browser doesn't open after launch

  • Wait 5–10 seconds for the server to start, then manually navigate to http://127.0.0.1:5000.
  • Check the system tray for the SDRLogger+ icon — if it's there, the server is running.

Port 5000 is already in use

  • Another application may be using port 5000 (some macOS-style apps, IIS, or other servers).
  • Open %APPDATA%\SDRLoggerPlus\config.json in Notepad and change the port value to something like 5001.
  • Restart SDRLogger+ and navigate to http://127.0.0.1:5001.

Antivirus warning or blocked install

  • SDRLogger+ is a self-contained Python application bundled with PyInstaller. Some antivirus software flags PyInstaller executables as suspicious (false positive).
  • You can verify the installer is safe by checking the SHA256 hash listed on the releases page.
  • If necessary, add an exception in your antivirus for the SDRLogger+ install folder.

Windows Defender SmartScreen warning

  • Click More info → Run anyway. This is expected for new/unsigned software from independent developers.

Clone this wiki locally