SDRConsole Backupper: backup, restore and migration of an SDR Console V3 configuration from an original PC to a new PC

Visual concept by Paulo Jorge, F5VMJ — shared with permission.

Software • SDR Console V3 • Backup and disaster recovery

SDRConsole Backupper

A toolkit of fully readable PowerShell scripts I wrote to create a much broader backup of the SDR Console V3 configuration and restore it on the same PC or migrate it to another computer.

It came from a very practical problem: after months or years of use, an SDR station can accumulate Radio Definitions, IP addresses, profiles, frequencies, layouts, RX/TX settings and station-specific configuration. Rebuilding everything from memory after a reinstall or migration can take a long time — and usually a few inevitable curses.

In my case, a restore performed with SDR Console's built-in backup system did not fully rebuild the working environment I expected. That led to the idea of a backup designed explicitly as configuration disaster recovery.

Current release: v1.1 • Windows 10/11 • PowerShell source files included and inspectable with any normal text editor.

The idea was simple

Install SDR Console, restore the backup and get your configuration back. Before modifying the destination PC, the restore process automatically creates a safety PRE-RESTORE backup.

At a glance
  • Release: v1.1
  • Type: PowerShell toolkit, no proprietary executable
  • OS: Windows 10 / 11
  • SDR Console: V3
  • Purpose: complete backup, restore and configuration migration
  • Real-world test: migration between different PCs and Windows user profiles
  • Main scenario: SDR Console + ADALM-Pluto / QO-100, but not limited to this use case

The opening visual summarizes the main use case: save a working SDR Console configuration and recreate it on the same PC or on another computer without rebuilding it manually.

What's new in v1.1

v1.1 was prompted by a real-world restore test on a clean Windows installation. It does not change the v1.0 user workflow, but makes Registry handling more robust when SDR Console has not yet created its own keys on the destination PC.

  • The PRE-RESTORE backup now correctly skips SDR Console Registry keys that do not yet exist instead of aborting.
  • The restore now correctly skips removal of the current Registry branch when that branch is not yet present, then continues normally with the backup import.
  • The v1.0 PDF manuals remain fully valid: these are internal robustness fixes and do not alter the documented operating procedure.

Special thanks to Vincenzo, IK8OZV, for the real-world clean-install test and for uncovering the two restore edge cases fixed in v1.1.

Why this project exists

I use SDR Console mainly with multiple ADALM-Pluto units and dedicated QO-100 configurations. Over time, the settings become an integral part of the station: it is not just “one frequency to remember”, but a whole set of radio definitions, profiles, display parameters and operating settings that eventually become taken for granted.

While preparing a new PC I tried SDR Console's built-in backup/restore, expecting to recover an almost identical working environment. In my real-world test, however, a substantial part of the operating configuration was not restored as expected: Radio Definitions, display settings, frequencies and other parameters required manual work.

SDRConsole Backupper therefore has a different goal: explicitly save the main areas where SDR Console stores its configuration, while keeping the scripts open and readable so anyone can verify what will be copied, deleted or restored before running them.

What is backed up

Roaming configuration

The entire %APPDATA%\SDR-RADIO.com (V3) folder is copied, as it contains an important part of the user's configuration.

LocalAppData

If present, %LOCALAPPDATA%\SDR-RADIO.com (V3) is also backed up and restored to the corresponding location of the destination user.

SDR-RADIO Registry

The HKCU\Software\SDR-RADIO.com (V3) branch is exported, containing the SDR Console configuration for the current Windows user.

Program folder, optional

The backup can also include the program installation folder. When migrating to a PC where SDR Console is already installed, however, I recommend the dedicated Restore_SDRConsole_CONFIG_ONLY.cmd launcher, which leaves the installed program files untouched.

A deliberate choice: audio and VAC are not cloned

Windows audio devices can have different identifiers and drivers from one PC to another. Blindly copying the audio references from the source computer could create a formally identical configuration linked to devices that do not exist on the new PC.

For this reason SDRConsole Backupper saves some audio information for diagnostic reference only, but the restore does not automatically re-import it. If you use Virtual Audio Cable (VAC) or other virtual devices, install them normally on the destination PC as well and then verify the audio routing.

In other words: the SDR Console configuration is cloned, not the Windows audio hardware.

How to use it

1 • Backup

Close SDR Console

Run Backup_SDRConsole_ONECLICK.cmd. The script checks that SDR Console is not running, creates the backup and produces a verified ZIP archive.

2 • Keep it safe

Keep the ZIP safe

If D: exists, the default destination is D:\Backup\SDRConsole; otherwise the user's Documents folder is used.

3 • Restore

Restore with a safety net

The restore checks the backup, requires explicit confirmation and first creates a PRE-RESTORE backup of the current configuration.

Migration to another PC: recommended method

If the same version of SDR Console is already installed on the new computer, you can leave the program files untouched and restore only the configuration. This is the method I used in my real-world migration test between two different PCs.

Inside the toolkit folder, use the recommended launcher:

Restore_SDRConsole_CONFIG_ONLY.cmd

The Windows user name and computer name can be different: the restore rebuilds the destinations using the %APPDATA%, %LOCALAPPDATA% folders and the HKCU Registry of the user running it.

What happens before a restore

Explicit confirmation

The script displays the source and destinations and proceeds only after the user types the exact confirmation word requested.

Automatic PRE-RESTORE

Before replacing the current configuration, a new backup is created. If this operation fails, the restore is blocked.

Readable source

You do not have to trust a “black box”: the .ps1 and .cmd files are ordinary text files and can be inspected before execution.

Final reboot

At the end of the restore you are asked to restart Windows before reopening SDR Console, so the new environment is loaded cleanly.

Why it is particularly useful with ADALM-Pluto and QO-100

In a QO-100 station, multiple Pluto units can coexist, each with its own Radio Definition, IP address, profiles and operating settings. Add to this 10 GHz displayed frequencies, transverter configurations, bandwidths, layouts and audio/TX profiles.

In my migration test, restoring SDRConsole Backupper on a second PC with a different Windows profile rebuilt the source notebook configuration in a substantially identical way. That is exactly the kind of situation I wrote it for.

Before using it: read the manual

I kept the toolkit simple, but a full restore works on configuration folders and the Registry: you should know exactly what it is doing. I have therefore prepared a detailed manual covering backup, restore, migration, PRE-RESTORE, path handling and audio/VAC behaviour.

The PDF is also included in the ZIP, but it can be downloaded separately so you can evaluate the project before running any script.

📘 Download the PDF manual
English manual • PDF
Download

Download SDRConsole Backupper v1.1

One shared Windows package, including PowerShell/CMD scripts, both Italian and English documentation, and the license file. No installation is required: extract the ZIP to a folder and read the manual before first use. The v1.0 PDF manuals remain fully valid for v1.1.

SDRConsole Backupper v1.1
Shared ZIP with Backup/Restore toolkit, PowerShell source, both PDF manuals IT/EN and license
Download v1.1
Downloaded 42 times

Separate documentation:

License: free software for personal and non-commercial use. The documentation is distributed under the Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0).

Ham to ham

Free to use. If it helps you, buy me a coffee ☕

SDRConsole Backupper is free for personal and non-commercial use and freely downloadable. If it saves you from rebuilding an SDR Console configuration from scratch and you would like to support maintenance and further development, you can buy me a coffee via PayPal. No obligation, no pressure.


At a glance: if it saves you time and a few inevitable curses, it has already achieved its purpose.

Useful feedback: if something does not work correctly, please include your Windows version, SDR Console version, the type of restore performed, what you expected and what actually happened. A clear and repeatable problem is much easier to fix.

Requirements and recommendations

  • Windows 10 or Windows 11.
  • SDR Console V3 must be closed during backup and restore.
  • For migration, using the same SDR Console release on source and destination is recommended.
  • On a PC where SDR Console is already installed, preferably use
    Restore_SDRConsole_CONFIG_ONLY.cmd.
  • After a restore, restart Windows before opening SDR Console.

Responsibility and caution

The software is provided “as is”, without warranty. Before any restore, always keep an independent copy of any data you consider important.

The scripts are published so that you can verify their behaviour yourself: if something does not convince you, read them first and do not run them until you have clarified your concern.