├── README.md
├── apps
├── access-o365-x86
│ ├── icon.svg
│ └── info
├── access-o365
│ ├── icon.svg
│ └── info
├── access-x86
│ ├── icon.svg
│ └── info
├── access
│ ├── icon.svg
│ └── info
├── acrobat-reader-dc
│ ├── icon.svg
│ └── info
├── acrobat-x-pro
│ ├── icon.svg
│ └── info
├── adobe-cc
│ ├── icon.svg
│ └── info
├── aftereffects-cc
│ ├── icon.svg
│ └── info
├── audition-cc
│ ├── icon.svg
│ └── info
├── bridge-cc
│ ├── icon.svg
│ └── info
├── bridge-cs6-x86
│ ├── icon.svg
│ └── info
├── bridge-cs6
│ ├── icon.svg
│ └── info
├── cmd
│ ├── icon.svg
│ └── info
├── excel-o365-x86
│ ├── icon.svg
│ └── info
├── excel-o365
│ ├── icon.svg
│ └── info
├── excel-x86
│ ├── icon.svg
│ └── info
├── excel
│ ├── icon.svg
│ └── info
├── explorer
│ ├── icon.svg
│ └── info
├── iexplorer
│ ├── icon.svg
│ └── info
├── illustrator-cc
│ ├── icon.svg
│ └── info
├── indesign-cc
│ ├── icon.svg
│ └── info
├── keil-uvision
│ ├── icon.svg
│ └── info
├── lightroom-cc
│ ├── icon.svg
│ └── info
├── onenote-o365-x86
│ ├── icon.svg
│ └── info
├── onenote-o365
│ ├── icon.svg
│ └── info
├── onenote-x86
│ ├── icon.svg
│ └── info
├── onenote
│ ├── icon.svg
│ └── info
├── outlook-o365-x86
│ ├── icon.svg
│ └── info
├── outlook-o365
│ ├── icon.svg
│ └── info
├── outlook-x86
│ ├── icon.svg
│ └── info
├── outlook
│ ├── icon.svg
│ └── info
├── photoshop-cc
│ ├── icon.svg
│ └── info
├── photoshop-cs6-x86
│ ├── icon.svg
│ └── info
├── photoshop-cs6
│ ├── icon.svg
│ └── info
├── powerpoint-o365-x86
│ ├── icon.svg
│ └── info
├── powerpoint-o365
│ ├── icon.svg
│ └── info
├── powerpoint-x86
│ ├── icon.svg
│ └── info
├── powerpoint
│ ├── icon.svg
│ └── info
├── powershell-core
│ ├── icon.svg
│ └── info
├── powershell
│ ├── icon.svg
│ └── info
├── premiere-pro-cc
│ ├── icon.svg
│ └── info
├── project-o365-x86
│ ├── icon.svg
│ └── info
├── project-o365
│ ├── icon.svg
│ └── info
├── project-x86
│ ├── icon.svg
│ └── info
├── project
│ ├── icon.svg
│ └── info
├── proteus-8.8
│ ├── icon.svg
│ └── info
├── publisher-o365-x86
│ ├── icon.svg
│ └── info
├── publisher-o365
│ ├── icon.svg
│ └── info
├── publisher-x86
│ ├── icon.svg
│ └── info
├── publisher
│ ├── icon.svg
│ └── info
├── vs-code-insiders
│ ├── icon.svg
│ └── info
├── vs-code
│ ├── icon.svg
│ └── info
├── vs-community-2019
│ ├── icon.svg
│ └── info
├── vs-enterprise-2019
│ ├── icon.svg
│ └── info
├── vs-professional-2019
│ ├── icon.svg
│ └── info
├── windows-terminal
│ ├── icon.svg
│ └── info
├── word-o365-x86
│ ├── icon.svg
│ └── info
├── word-o365
│ ├── icon.svg
│ └── info
├── word-x86
│ ├── icon.svg
│ └── info
└── word
│ ├── icon.svg
│ └── info
├── bin
└── winapps
├── demo
├── demo.gif
└── installer.gif
├── docs
├── KVM.md
└── kvm
│ ├── 00.png
│ ├── 01.png
│ ├── 02.png
│ ├── 03.png
│ ├── 04.png
│ ├── 05.png
│ ├── 06.png
│ ├── 07.png
│ ├── 08.png
│ ├── 09.png
│ ├── 10.png
│ ├── 11.png
│ ├── 12.png
│ ├── 13.png
│ ├── 14.png
│ ├── 15.png
│ ├── 16.png
│ ├── 17.png
│ ├── 18.png
│ ├── 19.png
│ ├── 20.png
│ ├── 21.png
│ ├── 22.png
│ ├── 23.png
│ ├── 24.png
│ ├── 25.png
│ ├── 26.png
│ ├── 27.png
│ ├── 28.png
│ ├── 29.png
│ ├── 30.png
│ └── 31.png
├── icons
└── windows.svg
├── install
├── ExtractPrograms.ps1
├── RDPApps.reg
└── inquirer.sh
├── installer.sh
└── kvm
├── RDPWindows.qcow2
├── RDPWindows.xml
└── RDPWindowsArch.xml
/README.md:
--------------------------------------------------------------------------------
1 |
2 | # WinApps for Linux
3 | Run Windows apps such as Microsoft Office/Adobe in Linux (Ubuntu/Fedora) and GNOME/KDE as if they were a part of the native OS, including Nautilus integration for right clicking on files of specific mime types to open them.
4 |
5 |
6 |
7 | ***Proud to have made the top spot on [r/linux](https://www.reddit.com/r/linux) on launch day.***
8 |
9 | ## How it works
10 | WinApps was created as an easy, one command way to include apps running inside a VM (or on any RDP server) directly into GNOME as if they were native applications. WinApps works by:
11 | - Running a Windows RDP server in a background VM container
12 | - Checking the RDP server for installed applications such as Microsoft Office
13 | - If those programs are installed, it creates shortcuts leveraging FreeRDP for both the CLI and the GNOME tray
14 | - Files in your home directory are accessible via the `\\tsclient\home` mount inside the VM
15 | - You can right click on any files in your home directory to open with an application, too
16 |
17 | ## Currently supported applications
18 | Note: The app list below is fueled by the community, and therefore many apps may be untested by the WinApps team.
19 |
20 |
21 |
22 |  | Adobe Acrobat Pro (X) |
23 |  | Adobe Acrobat Reader (DC) |
24 |
25 |
26 |  | Adobe After Effects (CC) |
27 |  | Adobe Audition (CC) |
28 |
29 |
30 |  | Adobe Bridge (CS6, CC) |
31 |  | Adobe Creative Cloud (CC) |
32 |
33 |
34 |  | Adobe Illustrator (CC) |
35 |  | Adobe InDesign (CC) |
36 |
37 |
38 |  | Adobe Lightroom (CC) |
39 |  | Adobe Photoshop (CS6, CC) |
40 |
41 |
42 |  | Adobe Premiere Pro (CC) |
43 |  | Command Prompt (cmd.exe) |
44 |
45 |
46 |  | Explorer (File Manager) |
47 |  | Internet Explorer (11) |
48 |
49 |
50 |  | Microsoft Access (2016, 2019, o365) |
51 |  | Microsoft Excel (2016, 2019, o365) |
52 |
53 |
54 |  | Microsoft Word (2016, 2019, o365) |
55 |  | Microsoft OneNote (2016, 2019, o365) |
56 |
57 |
58 |  | Microsoft Outlook (2016, 2019, o365) |
59 |  | Microsoft PowerPoint (2016, 2019, o365) |
60 |
61 |
62 |  | Microsoft Project (2016, 2019, o365) |
63 |  | Microsoft Publisher (2016, 2019, o365) |
64 |
65 |
66 |  | Powershell (Standard, Core) |
67 |  | Proteus 8 (8.8 SP1) |
68 |
69 |
70 |  | Visual Studio (2019 - Ent|Pro|Com) |
71 |  | Windows (Full RDP session) |
72 |
73 |
74 |
75 | ## Installation
76 |
77 | ### Step 1: Download the repo and prerequisites
78 | You will need to store the WinApps repo in a permanent place and not remove it after install. To get things going, use:
79 | ``` bash
80 | sudo apt-get install -y freerdp2-x11
81 | git clone https://github.com/Fmstrat/winapps.git
82 | cd winapps
83 | ```
84 | Arch/Linux
85 | ``` bash
86 | sudo pacman -S freerdp
87 | git clone https://github.com/Fmstrat/winapps.git
88 | cd winapps
89 | ```
90 |
91 | ### Step 2: Creating your WinApps configuration file
92 | You will need to create a `~/.config/winapps/winapps.conf` configuration file with the following information in it:
93 | ``` bash
94 | RDP_USER="MyWindowsUser"
95 | RDP_PASS="MyWindowsPassword"
96 | #RDP_DOMAIN="MYDOMAIN"
97 | #RDP_IP="192.168.123.111"
98 | #RDP_SCALE=100
99 | #RDP_FLAGS=""
100 | #MULTIMON="true"
101 | #DEBUG="true"
102 | #VIRT_MACHINE_NAME="machine-name"
103 | #VIRT_NEEDS_SUDO="true"
104 | #RDP_SECRET="account"
105 | ```
106 |
107 | #### Using Secret Tool for RDP_PASS
108 |
109 | You can add the RDP password for lookup using secret tool. Label can be whatever you want it to be.
110 |
111 | ```bash
112 | secret-tool store --label='winapps' winapps account
113 | ```
114 | The username and password should be a full user account and password, such as the one created when setting up Windows or a domain user. It cannot be a user/PIN combination as those are not valid for RDP access.
115 |
116 | Options:
117 | - When using a pre-existing non-KVM RDP server, you can use the `RDP_IP` to specify it's location
118 | - If you are running a VM in KVM with NAT enabled, leave `RDP_IP` commented out and WinApps will auto-detect the right local IP
119 | - For domain users, you can uncomment and change `RDP_DOMAIN`
120 | - On high-resolution (UHD) displays, you can set `RDP_SCALE` to the scale you would like [100|140|160|180]
121 | - To add flags to the FreeRDP call, such as `/audio-mode:1` to pass in a mic, use the `RDP_FLAGS` configuration option. For audio passthrough, check [here](#enabling-audio-passthrough-via-pulseaudio)
122 | - For multi-monitor setups, you can try enabling `MULTIMON`, however if you get a black screen (FreeRDP bug) you will need to revert back
123 | - If you enable `DEBUG`, a log will be created on each application start in `~/.local/share/winapps/winapps.log`
124 |
125 | ### Step 3: Setting up your Windows VM
126 |
127 | #### Option 1 - Running KVM
128 | You can refer to the [KVM](https://www.linux-kvm.org) documentation for specifics, but the first thing you need to do is set up a Virtual Machine running Windows 10 Professional (or any version that supports RDP). First, clone WinApps and install KVM and FreeRDP:
129 | ``` bash
130 | sudo apt-get install -y virt-manager
131 | ```
132 | Arch/Manjaro
133 | ``` bash
134 | sudo pacman -S virt-manager virt-viewer dnsmasq vde2 bridge-utils openbsd-netcat ebtables iptables
135 | ```
136 | Now set up KVM to run as your user instead of root and allow it through AppArmor (for Ubuntu 20.04 and above):
137 | ``` bash
138 | sudo sed -i "s/#user = "root"/user = "$(id -un)"/g" /etc/libvirt/qemu.conf
139 | sudo sed -i "s/#group = "root"/group = "$(id -gn)"/g" /etc/libvirt/qemu.conf
140 | sudo usermod -a -G kvm $(id -un)
141 | sudo usermod -a -G libvirt $(id -un)
142 | sudo systemctl restart libvirtd
143 | sudo ln -s /etc/apparmor.d/usr.sbin.libvirtd /etc/apparmor.d/disable/
144 |
145 | sleep 5
146 |
147 | sudo virsh net-autostart default
148 | sudo virsh net-start default
149 | ```
150 | **You will likely need to reboot to ensure your current shell is added to the group.**
151 |
152 | Next, define a VM called RDPWindows from the sample XML file with:
153 | ``` bash
154 | virsh define kvm/RDPWindows.xml
155 | virsh autostart RDPWindows
156 | virsh start RDPWindows
157 | ```
158 | Arch/Manjaro
159 | ``` bash
160 | virsh define kvm/RDPWindowsArch.xml
161 | virsh autostart RDPWindows
162 | virsh start RDPWindows
163 | ```
164 |
165 | To increase performance of the VM and decrease resource utilization, read the [Improving Performance](#improving-performance) section.
166 |
167 | You will now want to change any settings on the VM and install Windows and whatever programs you would like, such as Microsoft Office. If the definition fails, you can always manually create a VM. You can access VMs with:
168 | ``` bash
169 | virt-manager
170 | ```
171 | Arch/Manjaro
172 |
173 | Options -> File -> Add connection... -> Hypervisor: QEMU/KVM
174 | check AutoConnect
175 | Generated URI: qemu:///system
176 | Connect
177 |
178 | #### Option 2 - I already have an RDP server or VM
179 | If you already have an RDP server or VM, using WinApps is very straight forward. Simply skip to step 4!
180 |
181 | ### Step 4: Configuring your Windows VM
182 | After the install process, or on your current RDP server, you will want to:
183 | - Go to the Start Menu
184 | - Type "About"
185 | - Open "About"
186 | - Change the PC name to "RDPWindows" if you are using KVM (This will allow WinApps to detect the local IP)
187 | - Go to Settings
188 | - Under "System", then "Remote Desktop" allow remote connections for RDP
189 | - Merge `kvm/RDPApps.reg` into the registry to enable RDP Applications
190 |
191 | ### Install virtio-win driver
192 | The virtual machine uses virtio components, Windows needs the drivers for these devices.
193 |
194 | To install you need:
195 |
196 | - Download the iso: virtio-win-0.1.xxx.iso (you can find it at fedorapeople.org)
197 | - Mount the iso on the SATA CD-rom device from virt-manager
198 | - In windows open the mounted disk and install: virtio-win-guest-tools.exe
199 |
200 | ### Step 5: Connect GNOME/KDE to your Windows VM with shortcuts and file associations
201 | Lastly, check that FreeRDP can connect with:
202 | ```
203 | bin/winapps check
204 | ```
205 | You will see output from FreeRDP, as well as potentially have to accept the initial certificate. After that, a Windows Explorer window should pop up. You can close this window and press `Ctrl-C` to cancel out of FreeRDP.
206 |
207 | If this step fails, try restarting the VM.
208 |
209 | Then the final step is to run the installer:
210 | ``` bash
211 | $ ./installer.sh --user
212 | Removing any old configurations...
213 | Installing...
214 | Checking for installed apps in RDP machine (this may take a while)... Finished.
215 | Configuring Excel... Finished.
216 | Configuring PowerPoint... Finished.
217 | Configuring Word... Finished.
218 | Configuring Windows... Finished.
219 | Installation complete.
220 | ```
221 |
222 | ## Adding applications
223 | Adding applications to the installer is easy. Simply copy one of the application configurations in the `apps` folder, and:
224 | - Edit the variables for the application
225 | - Replace the `icon.svg` with an SVG for the application (appropriately licensed)
226 | - Re-run the installer
227 | - Submit a Pull Request to add it to WinApps officially
228 |
229 | When running the installer, it will check for if any configured apps are installed, and if they are it will create the appropriate shortcuts on the host OS.
230 |
231 | ## Running applications manually
232 | WinApps offers a manual mode for running applications that are not configured. This is completed with the `manual` flag. Executables that are in the path do not require full path definition.
233 | ``` bash
234 | ./bin/winapps manual "C:\my\directory\executableNotInPath.exe"
235 | ./bin/winapps manual executableInPath.exe
236 | ```
237 |
238 | ## Checking for new application support
239 | The installer can be run multiple times, so simply run:
240 | ``` bash
241 | $ git pull
242 | $ ./installer.sh --user
243 | Removing any old configurations...
244 | Removing /home/fmstrat/.local/share/applications/excel.desktop... Finished.
245 | Removing /home/fmstrat/.local/share/applications/powerpoint.desktop... Finished.
246 | Removing /home/fmstrat/.local/share/applications/windows.desktop... Finished.
247 | Removing /home/fmstrat/.local/share/applications/word.desktop... Finished.
248 | Removing /home/fmstrat/.local/bin/excel... Finished.
249 | Removing /home/fmstrat/.local/bin/powerpoint... Finished.
250 | Removing /home/fmstrat/.local/bin/windows... Finished.
251 | Removing /home/fmstrat/.local/bin/word... Finished.
252 | Installing...
253 | Checking for installed apps in RDP machine (this may take a while)... Finished.
254 | Configuring Excel... Finished.
255 | Configuring PowerPoint... Finished.
256 | Configuring Word... Finished.
257 | Configuring Windows... Finished.
258 | Installation complete.
259 | ```
260 |
261 | ## Installer usage
262 | The following commands can be used to manage your application configurations:
263 | ``` bash
264 | ./installer.sh --user # Configure applications for the current user
265 | ./installer.sh --system # Configure applications for the entire system
266 | ./installer.sh --user --uninstall # Remove all configured applications for the current user
267 | ./installer.sh --system --uninstall # Remove all configured applications for the entire system
268 | ```
269 |
270 | ## Improving performance
271 |
272 | #### Reducing idle CPU usage from ~25% to ~3%
273 | In KVM, the CPU timing is not optimized by default. Use `virsh edit RDPWindows` to edit the VM and change:
274 | ``` xml
275 |