/cassowary

Run Windows Applications on Linux as if they are native, Use linux applications to launch files files located in windows vm without needing to install applications on vm. With easy to use configuration GUI

Primary LanguagePythonGNU General Public License v2.0GPL-2.0

Logo Cassowary

Visits Badge

App Demo GIF

With Cassowary you can run a Windows virtual machine and use Windows applications on Linux as if they were native applications, built upon FreeRDP and remote apps technology.

If you prefer a setup guide video instead of a wall of text, click here.

Please give a star ⭐ or follow this project if you find it useful.

Cassowary supports:

  • Running Windows application as if they were native application
  • Opening files from a Linux host directly inside Windows applications
  • Using Linux apps to open files that are on a Windows VM
  • Allowing easy access between both the guest and host filesystems
  • An easy-to-use configuration utility
  • Creating an application launcher for Windows application
  • Automatically suspending the VM when no Windows application is in use and automatically resume it when required (virt-manager only)

This README consists of instructions for:

  1. Setting up a Windows VM with virt-manager
  2. Installing Cassowary on a Windows guest and Linux host
  3. Extra How to's and FAQ
  4. Building Cassowary from source
  5. How can I help?

4. Building Cassowary from source

Install wine first, in order to build Windows application on Linux. Internet access is required to download the python binary for setup.

$ git clone https://github.com/casualsnek/cassowary
$ cd cassowary
$ ./buildall.sh

If buildall.sh produces an error such as bash: ./buildall.sh: Permission denied, run this command:

chmod +x buildall.sh

and then run the following again:

./buildall.sh

This will create a dist folder inside app-linux which contains the installable wheel file.
A bin folder will also be created inside app-windows containing the setup files for Windows.

5. How can I help?

  • Improve the README.md
  • Report bugs or submit patches
  • Suggest new features or improvements on existing ones!