An unofficial Electron wrapper for windows.cloud.microsoft (Windows App / Azure Virtual Desktop / Windows 365), for people who want a native-feeling desktop app on Linux instead of a browser tab.

This is not affiliated with or endorsed by Microsoft.

• Connects to the Windows App portal and launches AVD / Cloud PC sessions in their own windows
• Edge-on-Windows user-agent spoofing (HTTP header + JS Client Hints) so Conditional Access / Intune MAM checks pass
• System tray integration — show the portal, jump to any open session, quit (with or without clearing the session)
• Federated sign-in (ADFS, Okta, Ping, …) stays in-app instead of falling back to your system browser
• Hardware video decode (VAAPI on Intel/AMD) for the RDP graphics stream
• Wayland and X11 support
• Settings window for switching cloud environment (Commercial / GCC High / DoD), default window size, and clearing cookies/cache
• Distributed as AppImage, Flatpak, and Snap

Prebuilt packages are attached to GitHub Releases.

chmod +x "Windows App-*.AppImage"
./"Windows App-*.AppImage"

flatpak install --user "Windows App-*.flatpak"
flatpak run io.github.mariuszkopowski.WindowsAppForLinux

(Once published on Flathub: flatpak install flathub io.github.mariuszkopowski.WindowsAppForLinux.)

sudo snap install --dangerous "windows-app-for-linux_*.snap"

WARNING - Builds have been tested on Fedora, not on Ubuntu, so things may not work

No in-app URL bar — configuration lives in ~/.config/windows-app-for-linux/config.json, editable directly or through tray → Settings (or File → Settings, Ctrl+,, if the menu bar is visible — it auto-hides by default, tap Alt to reveal it).

{
  "cloudEnvironment": "gcchigh",
  "window": { "width": 1600, "height": 900 }
}

The Settings window covers cloudEnvironment, the connection URL (only editable when the environment is set to Custom), window size, and a "Clear Cookies and Cache" button. Most changes take effect after restarting the app.

These are limitations of the Windows App web client itself (windows.cloud.microsoft), not something this wrapper can fix:

• Webcam redirection is unreliable. The app grants the camera permission automatically, but whether a camera actually shows up inside a remote session depends on Microsoft's web client support, which is still incomplete — it works more reliably in the native (non-web) Windows App. This isn't a bug in this wrapper; there's no code-level fix available on our side.
• No multi-monitor support, no RDP Shortpath (UDP), no screen-capture protection — all native-client-only features.

See docs/PLAN.md for the full comparison against the native client.

Requires Node.js 20+.

npm install
npm start              # run in development
npm test                # run the test suite

npm run build:appimage
npm run build:flatpak   # requires flatpak + flatpak-builder on the host
npm run build:snap      # requires squashfs-tools on the host
npm run build            # all three targets

MIT