tabby-rdp 0.6.1 → 0.6.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +34 -0
- package/README.md +16 -11
- package/bin/SHA256SUMS +8 -8
- package/bin/darwin-arm64/tabby-rdp-proxy +0 -0
- package/bin/darwin-x64/tabby-rdp-proxy +0 -0
- package/bin/linux-arm/tabby-rdp-proxy +0 -0
- package/bin/linux-arm64/tabby-rdp-proxy +0 -0
- package/bin/linux-x64/tabby-rdp-proxy +0 -0
- package/bin/win32-arm64/tabby-rdp-proxy.exe +0 -0
- package/bin/win32-x64/tabby-rdp-proxy.exe +0 -0
- package/dist/audio.js +26 -5
- package/dist/clipboard.js +8 -2
- package/dist/desktop.service.js +60 -14
- package/dist/desktopForm.js +1 -1
- package/dist/fileTransfer.js +41 -8
- package/dist/freerdp.js +36 -14
- package/dist/freerdpClipboard.js +39 -9
- package/dist/freerdpFiles.js +183 -0
- package/dist/freerdpView.js +6 -0
- package/dist/freerdpWasm.js +183 -0
- package/dist/freerdpWasmSocket.js +28 -0
- package/dist/freerdpWasmWorker.js +174 -0
- package/dist/pduTrace.js +27 -5
- package/dist/rdpClient.js +2 -2
- package/dist/rdpProfile.js +2 -2
- package/dist/settingsPage.js +6 -6
- package/dist/ui.js +2 -2
- package/dist/zgfx.js +33 -18
- package/native/README.md +74 -33
- package/package.json +6 -18
- package/vendor/SHA256SUMS +16 -5
- package/vendor/iron-remote-desktop-rdp.js +301 -301
- package/vendor/iron-remote-desktop.js +770 -736
- package/vendor/ironrdp-factory.js +301 -301
- package/vendor/ironrdp_web_bg.wasm +0 -0
- package/wasm/freerdp/BUILD.json +63 -0
- package/wasm/freerdp/licenses/Emscripten-LICENSE +102 -0
- package/wasm/freerdp/licenses/FreeRDP-LICENSE +202 -0
- package/wasm/freerdp/licenses/FreeRDP-NOTICE +13 -0
- package/wasm/freerdp/licenses/LibreSSL-LICENSE +133 -0
- package/wasm/freerdp/licenses/Unicode-NOTICE +21 -0
- package/wasm/freerdp/licenses/zlib-LICENSE +22 -0
- package/wasm/freerdp/tabby-freerdp.js +2 -0
- package/wasm/freerdp/tabby-freerdp.wasm +0 -0
package/native/README.md
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
|
-
# FreeRDP
|
|
1
|
+
# FreeRDP
|
|
2
2
|
|
|
3
3
|
Settings › Remote Desktop › Settings › **RDP client** selects the default client. RDP profiles and the add/edit
|
|
4
|
-
desktop form have an override. An empty override follows Settings. Existing
|
|
4
|
+
desktop form have an override. An empty override follows Settings. IronRDP remains the default. Existing FreeRDP selections use the bundled WebAssembly build on reconnect; `freerdp-wasm` is accepted as an alias for `freerdp`.
|
|
5
5
|
Changes apply on the next connection; use Reconnect to compare clients on the same desktop. Accounts, certificate
|
|
6
6
|
trust and desktop identities are shared between the clients.
|
|
7
7
|
|
|
@@ -17,25 +17,27 @@ Each RDP profile or configured desktop can follow Settings, enable any of these
|
|
|
17
17
|
Changes apply on the next FreeRDP connection. IronRDP uses its own graphics capabilities.
|
|
18
18
|
|
|
19
19
|
An RDP profile tab's ellipsis/right-click menu also has **RDP client**: **Follow default**, **IronRDP**, or
|
|
20
|
-
**FreeRDP
|
|
20
|
+
**FreeRDP**. The checkmark shows the saved next-connection choice; **Current session** names the
|
|
21
21
|
client already running. Changing the choice offers **Reconnect to apply** or **Keep current session**, without
|
|
22
22
|
disconnecting automatically. A saved profile keeps its override; an unsaved quick connection keeps it in that tab.
|
|
23
23
|
|
|
24
|
-
|
|
24
|
+
FreeRDP renders inside the Tabby tab and supports keyboard, mouse, Unicode input, view only,
|
|
25
25
|
screenshots, scaling, reconnect and the display-control channel. It uses the plugin's existing direct, SSH and RD
|
|
26
|
-
Gateway transports, credential store and certificate/NLA prompts. Each attempt has its own
|
|
26
|
+
Gateway transports, credential store and certificate/NLA prompts. Each FreeRDP attempt has its own Electron utility process.
|
|
27
27
|
|
|
28
|
-
|
|
29
|
-
off, which leaves the clipboard channel out); in view only, no clipboard goes either way. It does **not** yet implement pictures
|
|
28
|
+
FreeRDP shares clipboard **text and files/folders** the ways the clipboard setting allows (both ways, only from the remote desktop, or
|
|
29
|
+
off, which leaves the clipboard channel out); in view only, no clipboard goes either way. It does **not** yet implement pictures on the clipboard, audio
|
|
30
30
|
playback/capture, shared folders, or Hyper-V VMConnect.
|
|
31
|
-
The supplied build uses
|
|
32
|
-
disabled.
|
|
33
|
-
inherit the global client setting continue to use IronRDP. A synced global FreeRDP default also uses IronRDP on a computer without its native helper; an explicit desktop/profile choice still reports the missing build. It has not been benchmarked against IronRDP on Windows Server. Native decoding alone does not establish
|
|
34
|
-
that this implementation will be faster: the cost of transferring pixels to the canvas also matters.
|
|
31
|
+
The supplied FreeRDP 3.33.1 build uses bitmap decoding (and the graphics pipeline for GNOME), with optional H.264
|
|
32
|
+
codecs disabled. Authentication uses NTLM on every platform. Windows SSPI and Kerberos are not provided; the earlier native Windows client could use SSPI. Domain-policy behavior remains unqualified. Hyper-V consoles that inherit the global client setting continue to use IronRDP.
|
|
35
33
|
|
|
36
|
-
|
|
34
|
+
This is FreeRDP's core compiled to WebAssembly with Tabby's adapter and canvas. It is not FreeRDP's separate SDL/browser
|
|
35
|
+
client. The bracketed PAM username handling, TLS-only consent, caching options and opaque desktop pixels are shared
|
|
36
|
+
with the earlier native integration. Synthetic tests cannot qualify a particular PAM appliance, MFA flow or policy.
|
|
37
37
|
|
|
38
|
-
|
|
38
|
+
## Native comparison build
|
|
39
|
+
|
|
40
|
+
Native builds are generated on demand for development and benchmarks, and retained as CI artifacts. They are not committed or published as dependencies. Build on each intended OS and CPU architecture. Requires Node 18+, CMake, a C compiler and an OpenSSL 3 development
|
|
39
41
|
installation with its license text. macOS also needs Xcode command-line tools; Linux needs `patchelf`; Windows
|
|
40
42
|
needs Visual Studio C++ build tools (including `dumpbin`), Perl and Ninja for the target architecture.
|
|
41
43
|
|
|
@@ -64,54 +66,93 @@ system ABI; Windows requires the applicable Microsoft C runtime. Builds for othe
|
|
|
64
66
|
Windows helpers require the matching Microsoft Visual C++ Redistributable, as described in the
|
|
65
67
|
[requirements](../docs/compatibility.md#requirements). The plugin does not install it automatically.
|
|
66
68
|
|
|
67
|
-
The
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
69
|
+
The native comparison build records its sources, binary hashes and licenses in `native/bin/<platform>/BUILD.json`.
|
|
70
|
+
These developer artifacts are not published as part of package format 6. The plugin includes portable FreeRDP
|
|
71
|
+
WebAssembly and the existing platform-specific Go network helpers used by IronRDP.
|
|
72
|
+
|
|
73
|
+
## WebAssembly build
|
|
74
|
+
|
|
75
|
+
The selectable WebAssembly client compiles the same windowless Tabby adapter and upstream FreeRDP/WinPR to WASM.
|
|
76
|
+
It does not embed the upstream SDL browser interface. Emscripten pthreads run in an isolated Electron utility process;
|
|
77
|
+
a loopback WebSocket bridge carries the existing authenticated direct, SSH or RD Gateway transport. No remote proxy
|
|
78
|
+
service is required. It shares native FreeRDP's certificate/NLA policy, canvas, input and clipboard controls.
|
|
79
|
+
IronRDP remains the default. See the comparison methodology in [the performance fixture](../test/fixtures/performance/README.md).
|
|
74
80
|
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
+
Requires Git, Node, CMake, Ninja and Emscripten, with the toolchain commit/version pinned in `wasm-source.json`:
|
|
82
|
+
|
|
83
|
+
```sh
|
|
84
|
+
git clone https://github.com/emscripten-core/emsdk.git .qa/emsdk
|
|
85
|
+
git -C .qa/emsdk checkout 35ff8a6d150541276abbc6bae512ca90bcfbe220
|
|
86
|
+
.qa/emsdk/emsdk install 6.0.12
|
|
87
|
+
.qa/emsdk/emsdk activate 6.0.12
|
|
88
|
+
npm run build:freerdp:wasm
|
|
89
|
+
npm run build
|
|
90
|
+
```
|
|
81
91
|
|
|
82
|
-
|
|
83
|
-
|
|
92
|
+
Alternatively set `EMSDK` to an installation of that version. The script verifies the FreeRDP, LibreSSL and zlib
|
|
93
|
+
source archives, builds static WASM libraries, and records source/artifact hashes in `wasm/freerdp/BUILD.json`.
|
|
94
|
+
The portable output and licenses are committed and included in the plugin package. CI rebuilds them with normalized compiler paths and timestamps, compares every file byte for byte, and requires this comparison and protocol tests before release staging. It never downloads a compiler
|
|
95
|
+
or builds at connection time. Native comparison binaries are not published with the plugin.
|
|
84
96
|
|
|
85
97
|
## Licensing
|
|
86
98
|
|
|
87
99
|
The Tabby helper is MIT licensed. FreeRDP and WinPR are Apache-2.0; OpenSSL 3 is Apache-2.0. Their full licenses and
|
|
88
100
|
FreeRDP's bundled attribution notice accompany the generated binaries. WinPR's built-in Unicode converter also
|
|
89
|
-
carries its own full `Unicode-NOTICE`. Keep
|
|
90
|
-
|
|
101
|
+
carries its own full `Unicode-NOTICE`. Keep these notices with native comparison artifacts.
|
|
102
|
+
The WebAssembly bundle additionally includes LibreSSL, zlib and Emscripten license/attribution files in
|
|
103
|
+
`wasm/freerdp/licenses`. Keep those files with the WASM and JavaScript artifacts.
|
|
91
104
|
The source/build identity is recorded in `BUILD.json`. New codecs, channels or native dependencies require reviewing
|
|
92
105
|
their own licensing and updating the packaging inventory; changing FreeRDP's top-level license file is insufficient.
|
|
93
106
|
|
|
94
107
|
## Verification
|
|
95
108
|
|
|
109
|
+
FreeRDP 3.33.1 native protocol/security and clipboard callback checks pass on macOS ARM64, Linux ARM64/x64 and
|
|
110
|
+
Windows ARM64/x64. The WASM protocol/security checks pass on macOS ARM64 and Linux x64. The packaged WASM
|
|
111
|
+
client also passes TLS policy, process restart/cleanup and canvas checks inside Tabby on macOS ARM64, Linux x64 and
|
|
112
|
+
Windows x64. These hosted checks use synthetic peers and need no private RDP server.
|
|
113
|
+
|
|
114
|
+
On macOS ARM64, both clients pass live Windows Server 2022 clipboard tests: nested-folder and empty-file downloads,
|
|
115
|
+
binary contents, folder uploads with a 2 MiB file verified by SHA-256, drag/drop, Finder folder paste with Command-V,
|
|
116
|
+
and Save to Downloads with preserved paths. Windows Server 2025 x64 also passes all 38 packed WASM lifecycle checks against Windows Server 2022,
|
|
117
|
+
including text, file/folder upload and download, Windows folder clipboard paste with Ctrl-V, resize, reconnect and cleanup.
|
|
118
|
+
Live Linux file-transfer qualification remains pending. A [Windows native/WASM comparison](../test/fixtures/performance/README.md#windows-comparison-2026-11-16)
|
|
119
|
+
measures similar frame rates and input latency, with higher WASM CPU and memory use. The older qualification below does not qualify the new builds.
|
|
120
|
+
|
|
96
121
|
```sh
|
|
97
122
|
npm run typecheck
|
|
98
123
|
npm run test:unit
|
|
124
|
+
TRD_TEST_FREERDP_RUNTIME=wasm node --import tsx --test test/unit/freerdp.ts
|
|
99
125
|
npm test -- --hidden visual-smoke
|
|
100
126
|
# With TRD_TEST_DIRECT, TRD_TEST_DIRECT_USER and TRD_TEST_DIRECT_PASSWORD for a dedicated server:
|
|
101
127
|
npm test -- --hidden freerdp
|
|
102
|
-
# Verify the installed
|
|
103
|
-
# permissions and relocated native libraries:
|
|
128
|
+
# Verify the installed plugin package as well:
|
|
104
129
|
npm test -- --packed --hidden freerdp
|
|
105
130
|
```
|
|
106
131
|
|
|
132
|
+
The [TLS-only PAM regression peer](../test/fixtures/pam/README.md) passes all 64 native/WASM cases (224 assertions)
|
|
133
|
+
through Tabby's canvas on Windows Server 2025 x64 against a Windows Server 2022 peer. It covers bracketed usernames,
|
|
134
|
+
TLS-only consent, independently toggled glyph/bitmap caching and relaxed checks, announced/unannounced drawing
|
|
135
|
+
orders, opaque/zero/partial/omitted bitmap alpha and genuine black pixels. Native and WASM results match in every
|
|
136
|
+
case. Linux and Windows, x64 and ARM64, also pass 18 core-level peer cases each in CI. The peer does not generate glyph-cache
|
|
137
|
+
text orders or emulate Senhasegura MFA, appliance policies or session handoff; those still need appliance testing.
|
|
138
|
+
|
|
107
139
|
The FreeRDP unit tests run framing, bounds, keyboard and authenticated-relay tests on every platform. When the
|
|
108
140
|
helper exists, they additionally run real native TLS/NLA certificate-rejection tests, verifying that no username
|
|
109
141
|
routing cookie or authentication payload reaches a rejected peer. Real Windows Server performance and feature
|
|
110
142
|
qualification require a dedicated test machine; these local protocol tests do not substitute for that work.
|
|
111
143
|
|
|
112
|
-
|
|
144
|
+
With FreeRDP 3.33.0, the native protocol/security suite passes on macOS ARM64, Windows ARM64/x64 and Linux ARM64/x64. It exercises
|
|
113
145
|
certificate/name/NLA rejection before credentials, the same CredSSP minimum version (5) as IronRDP, large trust stores, relay authentication, IPC and build inventories.
|
|
114
146
|
|
|
147
|
+
On macOS ARM64, synthetic TLS RDP connections with cached bitmap updates verify opaque colors, zero-alpha colors,
|
|
148
|
+
omitted alpha and genuine black pixels through the native helper and Tabby's canvas. These checks reproduce the
|
|
149
|
+
alpha rendering problem without a PAM server; they do not qualify a real Senhasegura connection.
|
|
150
|
+
|
|
151
|
+
The packaged FreeRDP 3.33.0 client on macOS ARM64 passes all 31 lifecycle checks against Windows Server 2022 x64:
|
|
152
|
+
desktop pixels, keyboard routing, live resize, input-burst recovery, view only, cleanup, cache-mode reconnects,
|
|
153
|
+
clipboard text in both directions and paste-to-all, switching to IronRDP, and Automatic header/reconnect stability.
|
|
154
|
+
The Windows Server 2025 coverage below predates the 3.33.0 upgrade.
|
|
155
|
+
|
|
115
156
|
| Client | Live Windows Server 2025 coverage |
|
|
116
157
|
|---|---|
|
|
117
158
|
| macOS ARM64 | Earlier packed-plugin lifecycle coverage; current native protocol/security checks passed. |
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "tabby-rdp",
|
|
3
|
-
"version": "0.6.
|
|
4
|
-
"description": "Windows and Linux remote desktops in Tabby, through SSH, direct RDP or RD Gateway. IronRDP
|
|
3
|
+
"version": "0.6.4",
|
|
4
|
+
"description": "Windows and Linux remote desktops in Tabby, through SSH, direct RDP or RD Gateway. IronRDP and FreeRDP clients.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"tabby-plugin",
|
|
7
7
|
"tabby",
|
|
@@ -27,6 +27,7 @@
|
|
|
27
27
|
"files": [
|
|
28
28
|
"dist",
|
|
29
29
|
"!dist/**/*.map",
|
|
30
|
+
"wasm",
|
|
30
31
|
"vendor",
|
|
31
32
|
"bin",
|
|
32
33
|
"remote",
|
|
@@ -43,25 +44,12 @@
|
|
|
43
44
|
"test": "tsx test/run.ts"
|
|
44
45
|
},
|
|
45
46
|
"dependencies": {
|
|
46
|
-
"semver": "7.8.
|
|
47
|
-
|
|
48
|
-
"optionalDependencies": {
|
|
49
|
-
"@tabby-rdp/freerdp-darwin-arm64": "0.6.1",
|
|
50
|
-
"@tabby-rdp/freerdp-linux-arm64": "0.6.1",
|
|
51
|
-
"@tabby-rdp/freerdp-linux-x64": "0.6.1",
|
|
52
|
-
"@tabby-rdp/freerdp-win32-arm64": "0.6.1",
|
|
53
|
-
"@tabby-rdp/freerdp-win32-x64": "0.6.1"
|
|
47
|
+
"semver": "7.8.6",
|
|
48
|
+
"ws": "8.22.1"
|
|
54
49
|
},
|
|
55
50
|
"tabbyRdp": {
|
|
56
51
|
"minimumTabbyVersion": "1.0.236",
|
|
57
52
|
"rollbackFloor": "0.5.3",
|
|
58
|
-
"packageFormat":
|
|
59
|
-
"freerdpPlatforms": [
|
|
60
|
-
"darwin-arm64",
|
|
61
|
-
"linux-arm64",
|
|
62
|
-
"linux-x64",
|
|
63
|
-
"win32-arm64",
|
|
64
|
-
"win32-x64"
|
|
65
|
-
]
|
|
53
|
+
"packageFormat": 6
|
|
66
54
|
}
|
|
67
55
|
}
|
package/vendor/SHA256SUMS
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# vendor/ is IronRDP 9b151c4c2e47c6014e1e8e55909d4180aa8bdb99 with the patches below, built by scripts/build-ironrdp.sh with
|
|
2
2
|
# rustc 1.94.1 (e408947bf 2026-03-25), wasm-pack 0.15.0 (wasm-bindgen 0.2.126, binaryen version_117) and
|
|
3
|
-
# Node.js
|
|
3
|
+
# Node.js v22.23.4, on aarch64-apple-darwin. Check from the repository's root: sha256sum -c vendor/SHA256SUMS
|
|
4
4
|
# (or shasum -a 256 -c vendor/SHA256SUMS).
|
|
5
5
|
965bc4a29f18bd6d766fe397c96dbe1483b23607ae8dd5a7458149d3625c2023 ironrdp/BASE_COMMIT
|
|
6
6
|
315f1de9185945c1bf248706353758ef0af9f94a2bcd01d9709454f5da752dca ironrdp/patches/0001-fix-dvc-drop-data-for-a-channel-that-is-not-open-ins.patch
|
|
@@ -55,8 +55,19 @@ f32621b910292284f25a1ac7ca38a01d1561f0c1f0c6e29f71b936140a6e31ed ironrdp/patche
|
|
|
55
55
|
bcfcd0e1e098093f66ea031a414224945cd694572e74e46e76bd9158cf59da1d ironrdp/patches/0057-feat-web-let-the-host-take-the-log-lines-init-logLev.patch
|
|
56
56
|
28dd99ca44910c69bf11948ab73ad104ba93a53dc13d7ae810c5d810e9f7b056 ironrdp/patches/0058-fix-egfx-keep-the-bitmap-cache-across-ResetGraphics.patch
|
|
57
57
|
839844c1cc3278008eba78cd27e6aa8a1f40d2640aafba769ab5523d01bceee5 ironrdp/patches/0059-fix-graphics-keep-Progressive-tile-state-per-surface.patch
|
|
58
|
+
fab0598f80884f9f81d2b81bc539d78a4b71b8fee2dda420b9d9dcf74eb3b230 ironrdp/patches/0060-fix-rdpdr-align-drive-names-with-upstream.patch
|
|
59
|
+
07b4cef5f4dda294de257d7d6403fa34e0c087b80ad8f6a6482ef860c26817c8 ironrdp/patches/0061-fix-pdu-align-license-debug-with-upstream.patch
|
|
60
|
+
f055a9d919b8f615058994fa30b6d6ba3471f3f2b4a4b71b7d6066d7bd73524e ironrdp/patches/0062-fix-dvc-align-declined-channels-with-upstream.patch
|
|
61
|
+
0398e8fbf6299180604adb4e2d1e9ecee5fc95e2e4ec85fd8c182a6fefe36fb6 ironrdp/patches/0063-fix-rdpsnd-use-upstream-training-size-helper.patch
|
|
62
|
+
0bc40c0676d67bf5f2d114c3dad81545aa6e48c69af169b3b38d77ce5fdac13b ironrdp/patches/0064-test-web-align-audio-with-upstream-contract.patch
|
|
63
|
+
6acca488869aa626a1928092b97bcdf440d089ab750d5a731c484d82c37adf70 ironrdp/patches/0065-test-web-carry-upstream-clipboard-lifecycle-cases.patch
|
|
64
|
+
bc04b08f7927fbae55f362a9fb15ebd47d8e46c4a509a064f6ee7cd61b5765b1 ironrdp/patches/0066-fix-dvc-settle-history-on-recorded-attachment.patch
|
|
65
|
+
3623e94bf2e2c168782f6ef04b50d932281d8ae80f02e76bd65fb99cab8f6d28 ironrdp/patches/0067-test-graphics-carry-upstream-context-regressions.patch
|
|
66
|
+
80796f2027dbfdf9da9446b56321080d2865f57eac9b989444324d78a77ef7b4 ironrdp/patches/0068-fix-rdpdr-apply-reviewed-device-name-sanitization.patch
|
|
67
|
+
33b1a3f5a4f7dc15b59cb6f79c42ce49dd674300da2378b37c73d4d40b4a80ce ironrdp/patches/0069-feat-web-let-the-host-pause-the-clipboard-both-ways.patch
|
|
68
|
+
e652e71c412d4b61aa3063628671cb0eeff841b3071160746e348925bb866c7b ironrdp/patches/0070-fix-web-recheck-clipboard-pause-after-asynchronous-reads.patch
|
|
58
69
|
08ccf512db2cfe21b16f958eda6fa4b23e052a0c0e91829a4fc2657f8bd8dd4d vendor/IRONRDP-LICENSE
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
70
|
+
fdb64a9070a68d8087773251905ae5f3c847ccc040ae38e66a4905365f8bc115 vendor/iron-remote-desktop-rdp.js
|
|
71
|
+
81dc012cc3e2b7efd77504f268fb3bfcf7194a04e86ded5c25dbc18d2cfe7e01 vendor/iron-remote-desktop.js
|
|
72
|
+
7b18aeb1c27fc6f8931453b0b4a0cea08dc358ea165632459cc182cdd66ee8d0 vendor/ironrdp_web_bg.wasm
|
|
73
|
+
6835c5d504500b76e43283013e92cceedce3df414fcf70bd131da2e822da7235 vendor/ironrdp-factory.js
|