How GoodRDP fits together

GoodRDP is one core and several apps. The core holds everything about connections: settings, security, sessions, recording. Each app is a different interface on top of it, for a different system or taste. They change at different speeds, so each part has its own version number.

built on ↓
Shared by every app
GoodRDP Core0.6.0Sessions, the settings schema, the connections file, certificate pinning and client certificates, tunnels, recording, .rdp files, and the logic every app shares. Written in Go; talks to FreeRDP 3.
Command line1.1.0The list, export, import and version commands built into every app, for scripts and automation.
Connections fileformat 1The layout of connections.toml, shared by every app on the computer. Changes only when older apps couldn't read the file.
talks to ↓
Installed alongside
FreeRDP 33.xThe RDP protocol library. From your distribution or Homebrew on Linux and macOS; included in the Windows download.
FFmpegoptionalOnly for recording, run as a separate program.
connects to ↓
Your servers
xrdp and other RDP serversDirectly, through an RD Gateway, or through a TLS tunnel that checks a client certificate.

Reading a version

What you download is an app, with the app's own version. Every release also says which shared parts it's built from. Two apps built on the same Core have the same connection features and settings, even if their own version numbers are different.

GoodRDP for Qt 0.1.0=Core 0.6.0+CLI 1.1.0+file format 1+ its own interface

Every app shows this in Help › About, and each prints it from the command line, with the FreeRDP version it loaded:

For example
goodrdp-qt version
Shared partVersionNumbering
GoodRDP Core
Sessions, the settings schema, the connections file, certificate pinning and client certificates, tunnels, recording, .rdp files, and the logic every app shares. Written in Go; talks to FreeRDP 3.
0.6.0 Semantic version
Tag core/vX.Y.Z
Command line
The list, export, import and version commands built into every app, for scripts and automation.
1.1.0 Semantic version
Connections file format
The layout of connections.toml, shared by every app on the computer. Changes only when older apps couldn't read the file.
1 A whole number

What a new number means

An app (MAJOR.MINOR.PATCH)

  • Patch: fixes only.
  • Minor: new features or interface changes, including moving to a Core with new features.
  • Major: you'd have to relearn or lose something: a removed feature, changed defaults or shortcuts.
  • Apps release on their own schedule: a change to the Qt interface doesn't need a new ImGui release.

GoodRDP Core (MAJOR.MINOR.PATCH)

  • Patch: fixes, for example to security or reconnecting.
  • Minor: new connection settings, protocol features or shared behaviour. Apps get them by rebuilding.
  • Major: settings that behave differently, or changes the apps must adapt to.
  • Before 1.0, a minor release may also change what apps build against.

Command line (MAJOR.MINOR.PATCH)

  • For scripts and automation, so it is versioned on its own.
  • Minor: new commands or options. Major: a script could break.
  • The same in every app built with the same version.

Connections file format (a whole number)

  • Every app on a computer shares one connections file.
  • It changes only when older apps couldn't read the file any more. That's rare.
  • An app never overwrites a file in a newer format; it says which app wrote it instead. Newer apps upgrade older files when they save.

Which app is built on which Core

Every app release and the shared parts inside it.

AppVersionReleasedCoreCLIFile format
GoodRDP ImGui0.6.02026-11-22 0.6.01.1.01
GoodRDP for Qt0.1.02026-11-22 0.6.01.1.01
GoodRDP for GNOME0.1.02026-11-22 0.6.01.1.01
GoodRDP for KDE0.1.02026-11-22 0.6.01.1.01
GoodRDP for Mac0.1.02026-11-22 0.6.01.1.01
GoodRDP for Windows0.1.02026-11-22 0.6.01.1.01

GoodRDP Core releases

CoreDateWhat it bringsApps built on it
0.6.02026-11-22
  • Connections in groups that pass settings down; one TOML connections file shared by every app
  • Server certificate pinning, client certificates through a TLS tunnel, and RD Gateway
  • Tabs, a live grid of every session, session windows on any monitor, and a full-screen bar
  • Recording and screenshots; Microsoft .rdp files: import with group inheritance, export
  • Passwords in the system keyring; says what to change when a server needs Network Level Authentication
GoodRDP ImGui 0.6.0, GoodRDP for Qt 0.1.0, GoodRDP for GNOME 0.1.0, GoodRDP for KDE 0.1.0, GoodRDP for Mac 0.1.0, GoodRDP for Windows 0.1.0