ConfigsJul 21, 2026·3 min read

WinApps — Run Windows Applications Seamlessly on Linux

WinApps lets you run Windows applications natively on a Linux desktop by connecting to a Windows VM or RDP session and presenting each app as if it were a local window with its own taskbar entry and file associations.

Agent ready

Ready-to-run agent install

This asset can be installed after the agent chooses its runtime, checks the plan, and runs the matching command.

Native · 98/100Policy: allow
Agent surface
Any MCP/CLI agent
Kind
Skill
Install
Single
Trust
Trust: Established
Entrypoint
WinApps
Direct install command
npx -y tokrepo@latest install 9da90720-849d-11f1-9bc6-00163e2b0d79 --target codex

Run after dry-run confirms the install plan.

Introduction

WinApps bridges the gap between Linux desktops and Windows-only software by transparently connecting to a Windows virtual machine or remote desktop session. Individual Windows applications appear as native Linux windows, complete with taskbar integration and file type associations, so users never need to switch to a full Windows desktop.

What WinApps Does

  • Launches individual Windows apps as native Linux windows using FreeRDP or libvirt
  • Registers Linux desktop entries and file associations for each configured Windows app
  • Supports running apps from a local KVM/QEMU VM or a remote RDP server
  • Handles clipboard sharing and file transfer between the Linux host and Windows guest
  • Provides pre-configured profiles for common apps like Microsoft Office, Adobe tools, and Visual Studio

Architecture Overview

WinApps uses FreeRDP RemoteApp mode to connect to a Windows VM running RDP services. When a user launches a configured application, WinApps initiates an RDP session in RemoteApp mode, which renders only the application window rather than the full desktop. The window is composited into the Linux desktop environment like any other local window. A background daemon manages session persistence, and a configuration file maps application names to their Windows executables.

Self-Hosting & Configuration

  • Install FreeRDP and either KVM/QEMU or configure a remote Windows RDP target
  • Enable Remote Desktop and RemoteApp on the Windows VM or server
  • Edit ~/.config/winapps/winapps.conf with your VM IP, username, and password
  • Run the installer script to generate .desktop files and file associations
  • Supports both libvirt-managed VMs and standalone RDP connections

Key Features

  • Seamless window integration where each Windows app gets its own Linux taskbar entry
  • File type associations let you double-click files to open them in Windows apps
  • Clipboard and drag-and-drop support between Linux and Windows environments
  • Pre-built application profiles for 30+ common Windows programs
  • Works with any Windows version that supports Remote Desktop and RemoteApp

Comparison with Similar Tools

  • Wine — translates Windows API calls directly; WinApps runs actual Windows binaries in a real Windows environment for full compatibility
  • Bottles — provides a polished Wine prefix manager; WinApps guarantees compatibility by using a real Windows instance
  • VirtualBox/VMware — runs a full Windows desktop; WinApps shows only individual app windows on your Linux desktop
  • CrossOver — commercial Wine-based solution; WinApps is free and open-source with full Windows compatibility

FAQ

Q: Do I need a Windows license? A: Yes. WinApps connects to a real Windows installation, which requires a valid license.

Q: Which Linux desktop environments are supported? A: WinApps works with GNOME, KDE Plasma, XFCE, and other freedesktop-compliant environments.

Q: Can I use a remote Windows server instead of a local VM? A: Yes. Any machine running Windows with Remote Desktop enabled can serve as the backend.

Q: How is performance compared to running Windows natively? A: Performance depends on your VM resources and network latency for remote setups. GPU-heavy applications may see reduced performance.

Sources

Discussion

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.

Related Assets