explaingit

fmstrat/winapps

10,205ShellAudience · developerComplexity · 3/5Setup · hard

TLDR

A Linux shell tool that makes Windows applications like Microsoft Office and Adobe Photoshop appear and behave as native programs on your Linux desktop, using a background Windows VM or RDP connection.

Mindmap

mindmap
  root((repo))
    What it does
      Windows apps on Linux
      Native-looking windows
      File manager integration
    How it works
      Windows VM backend
      RDP connection
      Registry app scan
    Supported Apps
      Microsoft Office
      Adobe Creative Cloud
      Visual Studio
      Any installed app
    Setup
      FreeRDP required
      GNOME or KDE desktop
      Linux home folder shared
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Run Microsoft Office apps as if they were native programs on an Ubuntu or Fedora Linux desktop.

USE CASE 2

Open a Windows-only tool from your Linux file manager by right-clicking a file and choosing it from the context menu.

USE CASE 3

Add any detected Windows application to your Linux GNOME or KDE application launcher automatically.

USE CASE 4

Share your Linux home folder files with Windows apps running inside the background virtual machine.

Tech stack

ShellFreeRDPDockerGNOMEKDE

Getting it running

Difficulty · hard Time to first run · 1day+

Requires a licensed Windows installation running as a local VM or accessible via RDP in the background.

In plain English

WinApps is a Linux shell tool that lets Windows applications appear and behave as if they are native programs on a Linux desktop. Instead of switching to a Windows virtual machine to use software like Microsoft Office or Adobe Photoshop, WinApps creates shortcuts in your Linux application menu that open those programs directly inside a running Windows session, displayed in their own window on your Linux desktop. The way it works is that a Windows virtual machine or RDP (remote desktop) server runs in the background. WinApps connects to that server and checks which Windows applications are installed. For each recognized application, it creates a launcher in your Linux desktop environment, such as GNOME or KDE. When you click that launcher, it opens the specific Windows program via a remote desktop connection, sized to fill just that one window rather than showing the full Windows desktop. The integration goes beyond just launching apps. Files in your Linux home folder are made available inside the Windows VM at a shared network path, so you can pass files back and forth. WinApps also hooks into the Linux file manager (Nautilus), so right-clicking on a file of a supported type gives you an option to open it with the corresponding Windows application. Out of the box, WinApps has official support for the Microsoft Office suite (Word, Excel, PowerPoint, Outlook, and others), the full Adobe Creative Cloud lineup (Photoshop, Illustrator, Premiere, and more), and a few other tools like Visual Studio. Beyond those, it will also detect and create launchers for any other Windows program it finds installed on the virtual machine by scanning the Windows registry. The project launched in 2020 and reached the top post on the r/linux community on its release day.

Copy-paste prompts

Prompt 1
Set up WinApps on Ubuntu with a Windows 10 VM using FreeRDP so I can launch Microsoft Word as a native Linux app, full installation walkthrough.
Prompt 2
How do I configure WinApps to add Microsoft Excel to my GNOME application menu and the Nautilus right-click context menu?
Prompt 3
I have a Windows RDP server on my local network, how do I connect WinApps to it instead of running a local VM?
Prompt 4
Using WinApps, how do I register a custom Windows application not in the official support list so it appears in my Linux launcher?
Prompt 5
What are the minimum RAM and disk space requirements to run WinApps with a Windows 10 VM on a Linux host?
Open on GitHub → Explain another repo

← fmstrat on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.