---

Run Windows applications (including [Microsoft 365](https://www.microsoft365.com/) and [Adobe Creative Cloud](https://www.adobe.com/creativecloud.html)) on GNU/Linux with `KDE`, `GNOME` or `XFCE`, integrated seamlessly as if they were native to the OS. ## Underlying Mechanism WinApps works by: 1. Running Windows in a `Docker`, `Podman` or `libvirt` virtual machine. 2. Querying Windows for all installed applications. 3. Creating shortcuts to selected Windows applications on the host GNU/Linux OS. 4. Using [`FreeRDP`](https://www.freerdp.com/) as a backend to seamlessly render Windows applications alongside GNU/Linux applications. ## Additional Features - The GNU/Linux `/home` directory is accessible within Windows via the `\\tsclient\home` mount. - Integration with `Nautilus`, allowing you to right-click files to open them with specific Windows applications based on the file MIME type. ## Supported Applications **WinApps supports *ALL* Windows applications.** Universal application support is achieved by: 1. Scanning Windows for any officially supported applications (list below). 2. Scanning Windows for any other `.exe` files listed within the Windows Registry. Officially supported applications benefit from high-resolution icons and pre-populated MIME types. This enables file managers to determine which Windows applications should open files based on file extensions. Icons for other detected applications are pulled from `.exe` files. Contributing to the list of supported applications is encouraged through submission of pull requests! Please help us grow the WinApps community. *Please note that the provided list of officially supported applications is community-driven. As such, some applications may not be tested and verified by the WinApps team.* ### Officially Supported Applications

	Adobe Acrobat Pro (X) Icon in the Public Domain.		Adobe After Effects (CC) Icon in the Public Domain.
	Adobe Audition (CC) Icon in the Public Domain.		Adobe Bridge (CS6, CC) Icon in the Public Domain.
	Adobe Creative Cloud (CC) Icon under MIT license.		Adobe Illustrator (CC) Icon in the Public Domain.
	Adobe InDesign (CC) Icon in the Public Domain.		Adobe Lightroom (CC) Icon in the Public Domain.
	Adobe Photoshop (CS6, CC) Icon in the Public Domain.		Command Prompt (cmd.exe) Icon under MIT license.
	File Explorer (Windows Explorer) Icon in the Public Domain.		Internet Explorer (11) Icon in the Public Domain.
	Microsoft Access (2016, 2019, o365) Icon in the Public Domain.		Microsoft Excel (2016, 2019, o365) Icon in the Public Domain.
	Microsoft Word (2016, 2019, o365) Icon in the Public Domain.		Microsoft OneNote (2016, 2019, o365) Icon in the Public Domain.
	Microsoft Outlook (2016, 2019, o365) Icon in the Public Domain.		Microsoft PowerPoint (2016, 2019, o365) Icon in the Public Domain.
	Microsoft Publisher (2016, 2019, o365) Icon in the Public Domain.		PowerShell Icon under MIT license.
	Windows (Full RDP Session) Icon in the Public Domain.

## Installation ### Step 1: Configure a Windows VM Both `Docker` and `Podman` are recommended backends for running the Windows virtual machine, as they facilitate an automated Windows installation process. WinApps is also compatible with `libvirt`. While this method requires considerably more manual configuration, it also provides greater virtual machine customisation options. All three methods leverage the `KVM` hypervisor, ensuring excellent virtual machine performance. Ultimately, the choice of backend depends on your specific use case. The following guides are available: - [Creating a Windows VM with `Docker` or `Podman`](docs/docker.md) - [Creating a Windows VM with `libvirt`](docs/libvirt.md) If you already have a Windows VM or server you wish to use with WinApps, you will need to merge `install/RDPApps.reg` into the Windows Registry manually. ### Step 2: Clone WinApps Repository and Dependencies 1. Clone the WinApps GitHub repository. ```bash git clone https://github.com/winapps-org/winapps.git && cd winapps ``` 2. Install the required dependencies. - Debian/Ubuntu: ```bash sudo apt install -y dialog freerdp3-x11 ``` - Fedora/RHEL: ```bash sudo dnf install -y dialog freerdp ``` - Arch Linux: ```bash sudo pacman -Syu --needed -y dialog freerdp ``` - Gentoo Linux: ```bash sudo emerge --ask=n sys-libs/dialog net-misc/freerdp:3 ``` > [!NOTE] > WinApps requires `FreeRDP` version 3 or later. If not available for your distribution through your package manager, you can install the [Flatpak](https://flathub.org/apps/com.freerdp.FreeRDP). ```bash flatpak install flathub com.freerdp.FreeRDP sudo flatpak override --filesystem=home com.freerdp.FreeRDP # To use `+home-drive` ``` ### Step 3: Create a WinApps Configuration File Create a configuration file at `~/.config/winapps/winapps.conf` containing the following: ```bash RDP_USER="MyWindowsUser" RDP_PASS="MyWindowsPassword" #RDP_DOMAIN="MYDOMAIN" #RDP_IP="192.168.123.111" #WAFLAVOR="docker" # Acceptable values are 'docker', 'podman' and 'libvirt'. #RDP_SCALE=100 # Acceptable values are 100, 140, and 180. #RDP_FLAGS="" #MULTIMON="true" #DEBUG="true" #FREERDP_COMMAND="xfreerdp" ``` > [!NOTE] > `RDP_USER` and `RDP_PASS` must correspond to a complete Windows user account and password, such as those created during Windows setup or for a domain user. User/PIN combinations are not valid for RDP access. > [!NOTE] > If you wish to use an alternative WinApps backend (other than `Docker`), uncomment and change `WAFLAVOR="docker"` to `WAFLAVOR="podman"` or `WAFLAVOR="libvirt"`. #### Configuration Options Explained - If using a pre-existing Windows RDP server on your LAN, you must use `RDP_IP` to specify the location of the Windows server. You may also wish to configure a static IP address for this server. - If running a Windows VM using `libvirt` with NAT enabled, leave `RDP_IP` commented out and WinApps will auto-detect the local IP address for the VM. - For domain users, you can uncomment and change `RDP_DOMAIN`. - On high-resolution (UHD) displays, you can set `RDP_SCALE` to the scale you would like to use (100, 140 or 180). - To add additional flags to the FreeRDP call (e.g. `/prevent-session-lock 120`), uncomment and use the `RDP_FLAGS` configuration option. - For multi-monitor setups, you can try enabling `MULTIMON`. A FreeRDP bug may result in a black screen however, in which case you should revert this change. - If you enable `DEBUG`, a log will be created on each application start in `~/.local/share/winapps/winapps.log`. - If using a system on which the FreeRDP command is not `xfreerdp` or `xfreerdp3`, the correct command can be specified using `FREERDP_COMMAND`. ### Step 4: Run the WinApps Installer Run the WinApps installer. ```bash ./installer.sh ``` A list of supported additional arguments can be accessed by running `./installer.sh --help`. ## Adding Additional Pre-defined Applications Adding your own applications with custom icons and MIME types to the installer is easy. Simply copy one of the application configurations in the `apps` folder located within the WinApps repository, and: 1. Modify the name and variables to reflect the appropriate/desired values for your application. 2. Replace `icon.svg` with an SVG for your application (ensuring the icon is appropriately licensed). 3. Remove and reinstall WinApps. 4. Submit a pull request to add your application to WinApps as an officially supported application once you have tested and verified your configuration (optional, but encouraged). ## Running Applications Manually WinApps offers a manual mode for running applications that were not configured by the WinApps installer. This is completed with the `manual` flag. Executables that are in the Windows PATH do not require full path definition. ```bash ./bin/winapps manual "C:\my\directory\executableNotInPath.exe" ./bin/winapps manual executableInPath.exe ``` ## Updating WinApps The installer can be run multiple times. To update your installation of WinApps: 1. Run the WinApps installer to remove WinApps from your system. 2. Pull the latest changes from the WinApps GitHub repository. 3. Re-install WinApps using the WinApps installer.