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.
Files changed (44) hide show
  1. package/CHANGELOG.md +34 -0
  2. package/README.md +16 -11
  3. package/bin/SHA256SUMS +8 -8
  4. package/bin/darwin-arm64/tabby-rdp-proxy +0 -0
  5. package/bin/darwin-x64/tabby-rdp-proxy +0 -0
  6. package/bin/linux-arm/tabby-rdp-proxy +0 -0
  7. package/bin/linux-arm64/tabby-rdp-proxy +0 -0
  8. package/bin/linux-x64/tabby-rdp-proxy +0 -0
  9. package/bin/win32-arm64/tabby-rdp-proxy.exe +0 -0
  10. package/bin/win32-x64/tabby-rdp-proxy.exe +0 -0
  11. package/dist/audio.js +26 -5
  12. package/dist/clipboard.js +8 -2
  13. package/dist/desktop.service.js +60 -14
  14. package/dist/desktopForm.js +1 -1
  15. package/dist/fileTransfer.js +41 -8
  16. package/dist/freerdp.js +36 -14
  17. package/dist/freerdpClipboard.js +39 -9
  18. package/dist/freerdpFiles.js +183 -0
  19. package/dist/freerdpView.js +6 -0
  20. package/dist/freerdpWasm.js +183 -0
  21. package/dist/freerdpWasmSocket.js +28 -0
  22. package/dist/freerdpWasmWorker.js +174 -0
  23. package/dist/pduTrace.js +27 -5
  24. package/dist/rdpClient.js +2 -2
  25. package/dist/rdpProfile.js +2 -2
  26. package/dist/settingsPage.js +6 -6
  27. package/dist/ui.js +2 -2
  28. package/dist/zgfx.js +33 -18
  29. package/native/README.md +74 -33
  30. package/package.json +6 -18
  31. package/vendor/SHA256SUMS +16 -5
  32. package/vendor/iron-remote-desktop-rdp.js +301 -301
  33. package/vendor/iron-remote-desktop.js +770 -736
  34. package/vendor/ironrdp-factory.js +301 -301
  35. package/vendor/ironrdp_web_bg.wasm +0 -0
  36. package/wasm/freerdp/BUILD.json +63 -0
  37. package/wasm/freerdp/licenses/Emscripten-LICENSE +102 -0
  38. package/wasm/freerdp/licenses/FreeRDP-LICENSE +202 -0
  39. package/wasm/freerdp/licenses/FreeRDP-NOTICE +13 -0
  40. package/wasm/freerdp/licenses/LibreSSL-LICENSE +133 -0
  41. package/wasm/freerdp/licenses/Unicode-NOTICE +21 -0
  42. package/wasm/freerdp/licenses/zlib-LICENSE +22 -0
  43. package/wasm/freerdp/tabby-freerdp.js +2 -0
  44. package/wasm/freerdp/tabby-freerdp.wasm +0 -0
package/native/README.md CHANGED
@@ -1,7 +1,7 @@
1
- # FreeRDP preview
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 configurations continue to use IronRDP.
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 (experimental)**. The checkmark shows the saved next-connection choice; **Current session** names the
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
- The initial FreeRDP preview renders inside the Tabby tab and supports keyboard, mouse, Unicode input, view only,
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 native process.
26
+ Gateway transports, credential store and certificate/NLA prompts. Each FreeRDP attempt has its own Electron utility process.
27
27
 
28
- The preview shares clipboard **text** 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 and files on the clipboard, audio
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 native bitmap decoding (and the graphics pipeline for GNOME), with optional H.264 codecs
32
- disabled. The macOS/Linux builds omit Kerberos/GSSAPI and use NTLM. Windows can use native SSPI; Kerberos and domain-policy behavior are not qualified. Hyper-V consoles that
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
- ## Build
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
- Build on each intended OS and CPU architecture. Requires Node 18+, CMake, a C compiler and an OpenSSL 3 development
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 plugin's npm package contains no native code. Each platform's helper is published in a package of its own,
68
- `@tabby-rdp/freerdp-<platform>-<arch>`, which the plugin names as an optional dependency. When Tabby installs or updates
69
- the plugin, npm installs the package for that computer alongside it and skips the others. No native executable is
70
- downloaded or compiled when Tabby loads the plugin. A helper built in a checkout's `native/bin` is used ahead of an
71
- installed package. An explicit FreeRDP choice without the matching
72
- helper produces an installation message before asking for credentials. A global default can be shared across computers:
73
- when only that default requests an unavailable helper, the connection uses IronRDP and records the fallback in its log.
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
- `native/bin` is generated and ignored by Git. For a public release, qualify each intended platform/architecture,
76
- explicitly include the reviewed native outputs in the release commit (`git add -f native/bin/<platform>-<arch>`), and
77
- list the platform in `package.json`'s `tabbyRdp.freerdpPlatforms`. `npm run pack:release` then makes its package from
78
- that folder, and the package checks require the published files to match the release commit. A build on one computer
79
- supplies only that computer's platform/architecture. Publishing a new platform's package for the first time is a
80
- manual step; see [CONTRIBUTING.md](../CONTRIBUTING.md#releasing).
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
- Helper packages exist for macOS ARM64, Windows ARM64/x64 and Linux ARM64/x64. FreeRDP helpers for Intel Macs
83
- are not yet available; IronRDP remains available there.
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 all these notices in each platform's package, whose `package.json` declares
90
- `MIT AND Apache-2.0`.
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 packages as well (the plugin's, with this computer's helper package), including executable
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
- The native protocol/security suite passes on macOS ARM64, Windows ARM64/x64 and Linux ARM64/x64. It exercises
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.1",
4
- "description": "Windows and Linux remote desktops in Tabby, through SSH, direct RDP or RD Gateway. IronRDP with an experimental FreeRDP client.",
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.5"
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": 5,
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 v26.8.2, on aarch64-apple-darwin. Check from the repository's root: sha256sum -c vendor/SHA256SUMS
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
- 90f89313371ef5406ead0ffd563a3e2808eb89ea9c1c66d177c1e418b383746a vendor/iron-remote-desktop-rdp.js
60
- 5a6363b9140a5a2abf0218aa39edb38f10445e8d7e9c5a798c321772e1f07c11 vendor/iron-remote-desktop.js
61
- 9cbfbd8638e1f893d5f11424906fe773b1d21395b8403c6274dd5e11eaf1565c vendor/ironrdp_web_bg.wasm
62
- b17f5affa1c83eb5af483d7dc69709067880b1e04d2cb59b1113ce2f06b086d2 vendor/ironrdp-factory.js
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