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.
Apps you install
one version each
one version each
GoodRDP ImGuiv0.6.0
on Core 0.6.0Go + Dear ImGui GoodRDP for Qtv0.1.0
on Core 0.6.0Go + Qt 6 (MIQT) GoodRDP for Macv0.1.0
on Core 0.6.0Swift + AppKit, with the Go core as a library GoodRDP for GNOMEv0.1.0
on Core 0.6.0Go + GTK 4 / libadwaita (gotk4) GoodRDP for KDEv0.1.0
on Core 0.6.0Go + Qt 6 Widgets (MIQT), Plasma over D-Bus GoodRDP for Windowsv0.1.0
on Core 0.6.0C# + WinUI 3, with the Go core as a DLL GoodRDP for iPad and iPhoneplannedSwiftUI
on Core 0.6.0Go + Dear ImGui GoodRDP for Qtv0.1.0
on Core 0.6.0Go + Qt 6 (MIQT) GoodRDP for Macv0.1.0
on Core 0.6.0Swift + AppKit, with the Go core as a library GoodRDP for GNOMEv0.1.0
on Core 0.6.0Go + GTK 4 / libadwaita (gotk4) GoodRDP for KDEv0.1.0
on Core 0.6.0Go + Qt 6 Widgets (MIQT), Plasma over D-Bus GoodRDP for Windowsv0.1.0
on Core 0.6.0C# + WinUI 3, with the Go core as a DLL GoodRDP for iPad and iPhoneplannedSwiftUI
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 part | Version | Numbering |
|---|---|---|
| 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.
| App | Version | Released | Core | CLI | File format |
|---|---|---|---|---|---|
| GoodRDP ImGui | 0.6.0 | 2026-11-22 | 0.6.0 | 1.1.0 | 1 |
| GoodRDP for Qt | 0.1.0 | 2026-11-22 | 0.6.0 | 1.1.0 | 1 |
| GoodRDP for GNOME | 0.1.0 | 2026-11-22 | 0.6.0 | 1.1.0 | 1 |
| GoodRDP for KDE | 0.1.0 | 2026-11-22 | 0.6.0 | 1.1.0 | 1 |
| GoodRDP for Mac | 0.1.0 | 2026-11-22 | 0.6.0 | 1.1.0 | 1 |
| GoodRDP for Windows | 0.1.0 | 2026-11-22 | 0.6.0 | 1.1.0 | 1 |
GoodRDP Core releases
| Core | Date | What it brings | Apps built on it |
|---|---|---|---|
| 0.6.0 | 2026-11-22 |
|
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 |