{"id":15116970,"url":"https://github.com/winapps-org/winapps","last_synced_at":"2025-05-14T12:11:37.802Z","repository":{"id":179669788,"uuid":"662640428","full_name":"winapps-org/winapps","owner":"winapps-org","description":" 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. Hard fork of https://github.com/Fmstrat/winapps/","archived":false,"fork":false,"pushed_at":"2025-05-11T10:51:00.000Z","size":19717,"stargazers_count":2348,"open_issues_count":94,"forks_count":90,"subscribers_count":24,"default_branch":"main","last_synced_at":"2025-05-11T11:33:36.111Z","etag":null,"topics":["cassowary","docker","freerdp","gnome","integration","kde","libvirt","linux","linux-app","nautilus","nix-flake","podman","qemu","qemu-kvm","seamless","winapps","windows","wine","xfce"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/winapps-org.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2023-07-05T15:05:25.000Z","updated_at":"2025-05-11T10:50:57.000Z","dependencies_parsed_at":"2023-11-07T12:27:24.606Z","dependency_job_id":"771a60b7-0f74-49cc-bfa4-e66cc457ce4c","html_url":"https://github.com/winapps-org/winapps","commit_stats":null,"previous_names":["winapps-org/winapps"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/winapps-org%2Fwinapps","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/winapps-org%2Fwinapps/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/winapps-org%2Fwinapps/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/winapps-org%2Fwinapps/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/winapps-org","download_url":"https://codeload.github.com/winapps-org/winapps/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254140766,"owners_count":22021220,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cassowary","docker","freerdp","gnome","integration","kde","libvirt","linux","linux-app","nautilus","nix-flake","podman","qemu","qemu-kvm","seamless","winapps","windows","wine","xfce"],"created_at":"2024-09-26T01:45:27.410Z","updated_at":"2025-05-14T12:11:32.787Z","avatar_url":"https://github.com/winapps-org.png","language":"Shell","readme":"\u003cp align=\"center\"\u003e\u003cimg align=\"center\" width=\"700\" src=\"./icons/banner_dark.svg#gh-dark-mode-only\"/\u003e\u003c/p\u003e\n\u003cp align=\"center\"\u003e\u003cimg align=\"center\" width=\"700\" src=\"./icons/banner_light.svg#gh-light-mode-only\"/\u003e\u003c/p\u003e\n\u003chr\u003e\n\nRun Windows applications (including [Microsoft 365](https://www.microsoft365.com/) and [Adobe Creative Cloud](https://www.adobe.com/creativecloud.html)) on GNU/Linux with `KDE Plasma`, `GNOME` or `XFCE`, integrated seamlessly as if they were native to the OS.\n\n\u003cp align=\"center\"\u003e\u003cimg src=\"./demo/demo.png\" width=1000 alt=\"WinApps Demonstration.\"\u003e\u003c/p\u003e\n\n## Underlying Mechanism\nWinApps works by:\n1. Running Windows in a `Docker`, `Podman` or `libvirt` virtual machine.\n2. Querying Windows for all installed applications.\n3. Creating shortcuts to selected Windows applications on the host GNU/Linux OS.\n4. Using [`FreeRDP`](https://www.freerdp.com/) as a backend to seamlessly render Windows applications alongside GNU/Linux applications.\n\n## Additional Features\n- The GNU/Linux `/home` directory is accessible within Windows via the `\\\\tsclient\\home` mount.\n- Integration with `Nautilus`, allowing you to right-click files to open them with specific Windows applications based on the file MIME type.\n- The [official taskbar widget](https://github.com/winapps-org/WinApps-Launcher) enables seamless administration of the Windows subsystem and offers an easy way to launch Windows applications.\n\n## Supported Applications\n**WinApps supports \u003cu\u003e*ALL*\u003c/u\u003e Windows applications.**\n\nUniversal application support is achieved by:\n1. Scanning Windows for any officially supported applications (list below).\n2. Scanning Windows for any other `.exe` files listed within the Windows Registry.\n\nOfficially 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.\n\nContributing to the list of supported applications is encouraged through submission of pull requests! Please help us grow the WinApps community.\n\n*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.*\n\n### Officially Supported Applications\n\u003ctable cellpadding=\"10\" cellspacing=\"0\" border=\"0\"\u003e\n    \u003ctr\u003e\n        \u003c!-- Adobe Acrobat Pro --\u003e\n        \u003ctd\u003e\n            \u003cimg src=\"apps/acrobat-x-pro/icon.svg\" width=\"100\"\u003e\n        \u003c/td\u003e\n        \u003ctd\u003e\n            \u003cb\u003eAdobe Acrobat Pro\u003c/b\u003e\u003cbr\u003e\n            (X)\u003cbr\u003e\n            \u003ci\u003e\u003ca href=\"https://commons.wikimedia.org/wiki/File:Adobe_Acrobat_DC_logo_2020.svg\"\u003eIcon\u003c/a\u003e in the Public Domain.\u003c/i\u003e\n        \u003c/td\u003e\n        \u003c!-- Adobe After Effects --\u003e\n        \u003ctd\u003e\n            \u003cimg src=\"apps/aftereffects-cc/icon.svg\" width=\"100\"\u003e\n        \u003c/td\u003e\n        \u003ctd\u003e\n            \u003cb\u003eAdobe After Effects\u003c/b\u003e\u003cbr\u003e\n            (CC)\u003cbr\u003e\n            \u003ci\u003e\u003ca href=\"https://commons.wikimedia.org/wiki/File:Adobe_After_Effects_CC_icon.svg\"\u003eIcon\u003c/a\u003e in the Public Domain.\u003c/i\u003e\n        \u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n        \u003c!-- Adobe Audition --\u003e\n        \u003ctd\u003e\n            \u003cimg src=\"apps/audition-cc/icon.svg\" width=\"100\"\u003e\n        \u003c/td\u003e\n        \u003ctd\u003e\n            \u003cb\u003eAdobe Audition\u003c/b\u003e\u003cbr\u003e\n            (CC)\u003cbr\u003e\n            \u003ci\u003e\u003ca href=\"https://en.m.wikipedia.org/wiki/File:Adobe_Audition_CC_icon_%282020%29.svg\"\u003eIcon\u003c/a\u003e in the Public Domain.\u003c/i\u003e\n        \u003c/td\u003e\n        \u003c!-- Adobe Bridge --\u003e\n        \u003ctd\u003e\n            \u003cimg src=\"apps/bridge-cs6/icon.svg\" width=\"100\"\u003e\n        \u003c/td\u003e\n        \u003ctd\u003e\n            \u003cb\u003eAdobe Bridge\u003c/b\u003e\u003cbr\u003e\n            (CS6, CC)\u003cbr\u003e\n            \u003ci\u003e\u003ca href=\"https://en.m.wikipedia.org/wiki/File:Adobe_Bridge_CC_icon.svg\"\u003eIcon\u003c/a\u003e in the Public Domain.\u003c/i\u003e\n        \u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n        \u003c!-- Adobe Creative Cloud --\u003e\n        \u003ctd\u003e\n            \u003cimg src=\"apps/adobe-cc/icon.svg\" width=\"100\"\u003e\n        \u003c/td\u003e\n        \u003ctd\u003e\n            \u003cb\u003eAdobe Creative Cloud\u003c/b\u003e\u003cbr\u003e\n            (CC)\u003cbr\u003e\n            \u003ci\u003e\u003ca href=\"https://iconduck.com/icons/240218/adobe-creative-cloud\"\u003eIcon\u003c/a\u003e under \u003ca href=\"https://iconduck.com/licenses/mit\"\u003eMIT license\u003c/a\u003e.\u003c/i\u003e\n        \u003c/td\u003e\n        \u003c!-- Adobe Illustrator --\u003e\n        \u003ctd\u003e\n            \u003cimg src=\"apps/illustrator-cc/icon.svg\" width=\"100\"\u003e\n        \u003c/td\u003e\n        \u003ctd\u003e\n            \u003cb\u003eAdobe Illustrator\u003c/b\u003e\u003cbr\u003e\n            (CC)\u003cbr\u003e\n            \u003ci\u003e\u003ca href=\"https://commons.wikimedia.org/wiki/File:Adobe_Illustrator_CC_icon.svg\"\u003eIcon\u003c/a\u003e in the Public Domain.\u003c/i\u003e\n        \u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n        \u003c!-- Adobe InDesign --\u003e\n        \u003ctd\u003e\n            \u003cimg src=\"apps/indesign-cc/icon.svg\" width=\"100\"\u003e\n        \u003c/td\u003e\n        \u003ctd\u003e\n            \u003cb\u003eAdobe InDesign\u003c/b\u003e\u003cbr\u003e\n            (CC)\u003cbr\u003e\n            \u003ci\u003e\u003ca href=\"https://commons.wikimedia.org/wiki/File:Adobe_InDesign_CC_icon.svg\"\u003eIcon\u003c/a\u003e in the Public Domain.\u003c/i\u003e\n        \u003c/td\u003e\n        \u003c!-- Adobe Lightroom --\u003e\n        \u003ctd\u003e\n            \u003cimg src=\"apps/lightroom-cc/icon.svg\" width=\"100\"\u003e\n        \u003c/td\u003e\n        \u003ctd\u003e\n            \u003cb\u003eAdobe Lightroom\u003c/b\u003e\u003cbr\u003e\n            (CC)\u003cbr\u003e\n            \u003ci\u003e\u003ca href=\"https://commons.wikimedia.org/wiki/File:Adobe_Photoshop_Lightroom_CC_logo.svg\"\u003eIcon\u003c/a\u003e in the Public Domain.\u003c/i\u003e\n        \u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n        \u003c!-- Adobe Photoshop --\u003e\n        \u003ctd\u003e\n            \u003cimg src=\"apps/photoshop-cc/icon.svg\" width=\"100\"\u003e\n        \u003c/td\u003e\n        \u003ctd\u003e\n            \u003cb\u003eAdobe Photoshop\u003c/b\u003e\u003cbr\u003e\n            (CS6, CC, 2022)\u003cbr\u003e\n            \u003ci\u003e\u003ca href=\"https://commons.wikimedia.org/wiki/File:Adobe_Photoshop_CC_icon.svg\"\u003eIcon\u003c/a\u003e in the Public Domain.\u003c/i\u003e\n        \u003c/td\u003e\n        \u003c!-- Command Prompt --\u003e\n        \u003ctd\u003e\n            \u003cimg src=\"apps/cmd/icon.svg\" width=\"100\"\u003e\n        \u003c/td\u003e\n        \u003ctd\u003e\n            \u003cb\u003eCommand Prompt\u003c/b\u003e\u003cbr\u003e\n            (cmd.exe)\u003cbr\u003e\n            \u003ci\u003e\u003ca href=\"https://github.com/microsoft/terminal/blob/main/res/terminal/Terminal.svg\"\u003eIcon\u003c/a\u003e under \u003ca href=\"https://github.com/microsoft/terminal/blob/main/LICENSE\"\u003eMIT license\u003c/a\u003e.\u003c/i\u003e\n        \u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n        \u003c!-- File Explorer --\u003e\n        \u003ctd\u003e\n            \u003cimg src=\"apps/explorer/icon.svg\" width=\"100\"\u003e\n        \u003c/td\u003e\n        \u003ctd\u003e\n            \u003cb\u003eFile Explorer\u003c/b\u003e\u003cbr\u003e\n            (Windows Explorer)\u003cbr\u003e\n            \u003ci\u003e\u003ca href=\"https://commons.wikimedia.org/wiki/File:Windows_Explorer.svg\"\u003eIcon\u003c/a\u003e in the Public Domain.\u003c/i\u003e\n        \u003c/td\u003e\n        \u003c!-- Internet Explorer --\u003e\n        \u003ctd\u003e\n            \u003cimg src=\"apps/iexplorer/icon.svg\" width=\"100\"\u003e\n        \u003c/td\u003e\n        \u003ctd\u003e\n            \u003cb\u003eInternet Explorer\u003c/b\u003e\u003cbr\u003e\n            (11)\u003cbr\u003e\n            \u003ci\u003e\u003ca href=\"https://commons.wikimedia.org/wiki/File:Internet_Explorer_10%2B11_logo.svg\"\u003eIcon\u003c/a\u003e in the Public Domain.\u003c/i\u003e\n        \u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n         \u003c!-- Microsoft Access --\u003e\n        \u003ctd\u003e\n            \u003cimg src=\"apps/access/icon.svg\" width=\"100\"\u003e\n        \u003c/td\u003e\n        \u003ctd\u003e\n            \u003cb\u003eMicrosoft Access\u003c/b\u003e\u003cbr\u003e\n            (2016, 2019, o365)\u003cbr\u003e\n            \u003ci\u003e\u003ca href=\"https://commons.wikimedia.org/wiki/File:Microsoft_Office_Access_(2019-present).svg\"\u003eIcon\u003c/a\u003e in the Public Domain.\u003c/i\u003e\n        \u003c/td\u003e\n        \u003c!-- Microsoft Excel --\u003e\n        \u003ctd\u003e\n            \u003cimg src=\"apps/excel/icon.svg\" width=\"100\"\u003e\n        \u003c/td\u003e\n        \u003ctd\u003e\n            \u003cb\u003eMicrosoft Excel\u003c/b\u003e\u003cbr\u003e\n            (2016, 2019, o365)\u003cbr\u003e\n            \u003ci\u003e\u003ca href=\"https://en.m.wikipedia.org/wiki/File:Microsoft_Office_Excel_(2019%E2%80%93present).svg\"\u003eIcon\u003c/a\u003e in the Public Domain.\u003c/i\u003e\n        \u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n        \u003c!-- Microsoft Word --\u003e\n        \u003ctd\u003e\n            \u003cimg src=\"apps/word/icon.svg\" width=\"100\"\u003e\n        \u003c/td\u003e\n        \u003ctd\u003e\n            \u003cb\u003eMicrosoft Word\u003c/b\u003e\u003cbr\u003e\n            (2016, 2019, o365)\u003cbr\u003e\n            \u003ci\u003e\u003ca href=\"https://en.m.wikipedia.org/wiki/File:Microsoft_Office_Word_(2019%E2%80%93present).svg\"\u003eIcon\u003c/a\u003e in the Public Domain.\u003c/i\u003e\n        \u003c/td\u003e\n        \u003c!-- Microsoft OneNote --\u003e\n        \u003ctd\u003e\n            \u003cimg src=\"apps/onenote/icon.svg\" width=\"100\"\u003e\n        \u003c/td\u003e\n        \u003ctd\u003e\n            \u003cb\u003eMicrosoft OneNote\u003c/b\u003e\u003cbr\u003e\n            (2016, 2019, o365)\u003cbr\u003e\n            \u003ci\u003e\u003ca href=\"https://en.m.wikipedia.org/wiki/File:Microsoft_Office_OneNote_(2019%E2%80%93present).svg\"\u003eIcon\u003c/a\u003e in the Public Domain.\u003c/i\u003e\n        \u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n        \u003c!-- Microsoft Outlook --\u003e\n        \u003ctd\u003e\n            \u003cimg src=\"apps/outlook/icon.svg\" width=\"100\"\u003e\n        \u003c/td\u003e\n        \u003ctd\u003e\n            \u003cb\u003eMicrosoft Outlook\u003c/b\u003e\u003cbr\u003e\n            (2016, 2019, o365)\u003cbr\u003e\n            \u003ci\u003e\u003ca href=\"https://en.m.wikipedia.org/wiki/File:Microsoft_Office_Outlook_(2018%E2%80%93present).svg\"\u003eIcon\u003c/a\u003e in the Public Domain.\u003c/i\u003e\n        \u003c/td\u003e\n        \u003c!-- Microsoft PowerPoint --\u003e\n        \u003ctd\u003e\n            \u003cimg src=\"apps/powerpoint/icon.svg\" width=\"100\"\u003e\n        \u003c/td\u003e\n        \u003ctd\u003e\n            \u003cb\u003eMicrosoft PowerPoint\u003c/b\u003e\u003cbr\u003e\n            (2016, 2019, o365)\u003cbr\u003e\n            \u003ci\u003e\u003ca href=\"https://en.m.wikipedia.org/wiki/File:Microsoft_Office_PowerPoint_(2019%E2%80%93present).svg\"\u003eIcon\u003c/a\u003e in the Public Domain.\u003c/i\u003e\n            \u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n        \u003c!-- Microsoft Publisher --\u003e\n        \u003ctd\u003e\n            \u003cimg src=\"apps/publisher/icon.svg\" width=\"100\"\u003e\n        \u003c/td\u003e\n        \u003ctd\u003e\n            \u003cb\u003eMicrosoft Publisher\u003c/b\u003e\u003cbr\u003e\n            (2016, 2019, o365)\u003cbr\u003e\n            \u003ci\u003e\u003ca href=\"https://en.m.wikipedia.org/wiki/File:Microsoft_Office_Publisher_(2019-present).svg\"\u003eIcon\u003c/a\u003e in the Public Domain.\u003c/i\u003e\n        \u003c/td\u003e\n        \u003c!-- Microsoft Visio --\u003e\n        \u003ctd\u003e\n            \u003cimg src=\"apps/visio/icon.svg\" width=\"100\"\u003e\n        \u003c/td\u003e\n        \u003ctd\u003e\n            \u003cb\u003eMicrosoft Visio\u003c/b\u003e\u003cbr\u003e\n            (Standard/Pro. 2021, Plan 2)\u003cbr\u003e\n            \u003ci\u003e\u003ca href=\"https://en.m.wikipedia.org/wiki/File:Microsoft_Office_Visio_(2019).svg\"\u003eIcon\u003c/a\u003e in the Public Domain.\u003c/i\u003e\n        \u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n        \u003c!-- Microsoft Project --\u003e\n        \u003ctd\u003e\n            \u003cimg src=\"apps/project/icon.svg\" width=\"100\"\u003e\n        \u003c/td\u003e\n        \u003ctd\u003e\n            \u003cb\u003eMicrosoft Project\u003c/b\u003e\u003cbr\u003e\n            (Standard/Pro. 2021, Plan 3/5)\u003cbr\u003e\n            \u003ci\u003e\u003ca href=\"https://en.m.wikipedia.org/wiki/File:Microsoft_Project_(2019–present).svg\"\u003eIcon\u003c/a\u003e in the Public Domain.\u003c/i\u003e\n        \u003c/td\u003e\n        \u003c!-- Microsoft Visual Studio --\u003e\n        \u003ctd\u003e\n            \u003cimg src=\"apps/visual-studio-pro/icon.svg\" width=\"100\"\u003e\n        \u003c/td\u003e\n        \u003ctd\u003e\n            \u003cb\u003eMicrosoft Visual Studio\u003c/b\u003e\u003cbr\u003e\n            (Comm./Pro./Ent. 2022)\u003cbr\u003e\n            \u003ci\u003e\u003ca href=\"https://en.m.wikipedia.org/wiki/File:Visual_Studio_Icon_2022.svg\"\u003eIcon\u003c/a\u003e in the Public Domain.\u003c/i\u003e\n        \u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n        \u003c!-- mIRC --\u003e\n        \u003ctd\u003e\n            \u003cimg src=\"apps/mirc/icon.svg\" width=\"100\"\u003e\n        \u003c/td\u003e\n        \u003ctd\u003e\n            \u003cb\u003emIRC\u003c/b\u003e\u003cbr\u003e\n            \u003ci\u003e\u003ca href=\"https://en.wikipedia.org/wiki/MIRC#/media/File:Mircnewlogo.png\"\u003eIcon\u003c/a\u003e in the Public Domain.\u003c/i\u003e\n        \u003c/td\u003e\n        \u003c!-- PowerShell --\u003e\n        \u003ctd\u003e\n            \u003cimg src=\"apps/powershell/icon.svg\" width=\"100\"\u003e\n        \u003c/td\u003e\n        \u003ctd\u003e\n            \u003cb\u003ePowerShell\u003c/b\u003e\u003cbr\u003e\n            \u003ci\u003e\u003ca href=\"https://iconduck.com/icons/102322/file-type-powershell\"\u003eIcon\u003c/a\u003e under \u003ca href=\"https://iconduck.com/licenses/mit\"\u003eMIT license\u003c/a\u003e.\u003c/i\u003e\n        \u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n        \u003c!-- Windows --\u003e\n        \u003ctd\u003e\n            \u003cimg src=\"icons/windows.svg\" width=\"100\"\u003e\n        \u003c/td\u003e\n        \u003ctd\u003e\n            \u003cb\u003eWindows\u003c/b\u003e\u003cbr\u003e\n            (Full RDP Session)\u003cbr\u003e\n            \u003ci\u003e\u003ca href=\"url\"\u003eIcon\u003c/a\u003e in the Public Domain.\u003c/i\u003e\n        \u003c/td\u003e\n    \u003c/tr\u003e\n\u003c/table\u003e\n\n## Installation\n### Step 1: Configure a Windows VM\nBoth `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.\n\nThe following guides are available:\n- [Creating a Windows VM with `Docker` or `Podman`](docs/docker.md)\n- [Creating a Windows VM with `libvirt`](docs/libvirt.md)\n\nIf you already have a Windows VM or server you wish to use with WinApps, you will still have to follow the [final steps described in the `libvirt` documentation](docs/libvirt.md#final-configuration-steps).\n\n### Step 2: Install Dependencies\nInstall the required dependencies.\n  - Debian/Ubuntu:\n      ```bash\n      sudo apt install -y curl dialog freerdp3-x11 git iproute2 libnotify-bin netcat-openbsd\n      ```\n\n\u003e [!NOTE]\n\u003e On Debian you need to enable the `backports` repository for the `freerdp3-x11` package to become available.\n\u003e For instructions, see https://backports.debian.org/Instructions.\n\n  - Fedora/RHEL:\n      ```bash\n      sudo dnf install -y curl dialog freerdp git iproute libnotify nmap-ncat\n      ```\n  - Arch Linux:\n      ```bash\n      sudo pacman -Syu --needed -y curl dialog freerdp git iproute2 libnotify gnu-netcat\n      ```\n  - OpenSUSE:\n      ```bash\n      sudo zypper install -y curl dialog freerdp git iproute2 libnotify-tools netcat-openbsd\n      ```\n  - Gentoo Linux:\n      ```bash\n      sudo emerge --ask=n net-misc/curl dev-util/dialog net-misc/freerdp:3 dev-vcs/git sys-apps/iproute2 x11-libs/libnotify net-analyzer/openbsd-netcat\n      ```\n\n\u003e [!NOTE]\n\u003e 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):\n\u003e ```bash\n\u003e flatpak install flathub com.freerdp.FreeRDP\n\u003e sudo flatpak override --filesystem=home com.freerdp.FreeRDP # To use `+home-drive`\n\u003e ```\n\u003e However, if you have weird issues like [#233](https://github.com/winapps-org/winapps/issues/233) when running Flatpak, please compile FreeRDP from source according to [this guide](https://github.com/FreeRDP/FreeRDP/wiki/Compilation).\n\n### Step 3: Create a WinApps Configuration File\nCreate a configuration file at `~/.config/winapps/winapps.conf` containing the following:\n```bash\n##################################\n#   WINAPPS CONFIGURATION FILE   #\n##################################\n\n# INSTRUCTIONS\n# - Leading and trailing whitespace are ignored.\n# - Empty lines are ignored.\n# - Lines starting with '#' are ignored.\n# - All characters following a '#' are ignored.\n\n# [WINDOWS USERNAME]\nRDP_USER=\"MyWindowsUser\"\n\n# [WINDOWS PASSWORD]\n# NOTES:\n# - If using FreeRDP v3.9.0 or greater, you *have* to set a password\nRDP_PASS=\"MyWindowsPassword\"\n\n# [WINDOWS DOMAIN]\n# DEFAULT VALUE: '' (BLANK)\nRDP_DOMAIN=\"\"\n\n# [WINDOWS IPV4 ADDRESS]\n# NOTES:\n# - If using 'libvirt', 'RDP_IP' will be determined by WinApps at runtime if left unspecified.\n# DEFAULT VALUE:\n# - 'docker': '127.0.0.1'\n# - 'podman': '127.0.0.1'\n# - 'libvirt': '' (BLANK)\nRDP_IP=\"127.0.0.1\"\n\n# [WINAPPS BACKEND]\n# DEFAULT VALUE: 'docker'\n# VALID VALUES:\n# - 'docker'\n# - 'podman'\n# - 'libvirt'\n# - 'manual'\nWAFLAVOR=\"docker\"\n\n# [DISPLAY SCALING FACTOR]\n# NOTES:\n# - If an unsupported value is specified, a warning will be displayed.\n# - If an unsupported value is specified, WinApps will use the closest supported value.\n# DEFAULT VALUE: '100'\n# VALID VALUES:\n# - '100'\n# - '140'\n# - '180'\nRDP_SCALE=\"100\"\n\n# [MOUNTING REMOVABLE PATHS FOR FILES]\n# NOTES:\n# - By default, `udisks` (which you most likely have installed) uses /run/media for mounting removable devices.\n#   This improves compatibility with most desktop environments (DEs).\n# ATTENTION: The Filesystem Hierarchy Standard (FHS) recommends /media instead. Verify your system's configuration.\n# - To manually mount devices, you may optionally use /mnt.\n# REFERRENCE: https://wiki.archlinux.org/title/Udisks#Mount_to_/media\nREMOVABLE_MEDIA=\"/run/media\"\n\n# [ADDITIONAL FREERDP FLAGS \u0026 ARGUMENTS]\n# NOTES:\n# - You can try adding /network:lan to these flags in order to increase performance, however, some users have faced issues with this.\n# DEFAULT VALUE: '/cert:tofu /sound /microphone'\n# VALID VALUES: See https://github.com/awakecoding/FreeRDP-Manuals/blob/master/User/FreeRDP-User-Manual.markdown\nRDP_FLAGS=\"/cert:tofu /sound /microphone\"\n\n# [MULTIPLE MONITORS]\n# NOTES:\n# - If enabled, a FreeRDP bug *might* produce a black screen.\n# DEFAULT VALUE: 'false'\n# VALID VALUES:\n# - 'true'\n# - 'false'\nMULTIMON=\"false\"\n\n# [DEBUG WINAPPS]\n# NOTES:\n# - Creates and appends to ~/.local/share/winapps/winapps.log when running WinApps.\n# DEFAULT VALUE: 'true'\n# VALID VALUES:\n# - 'true'\n# - 'false'\nDEBUG=\"true\"\n\n# [AUTOMATICALLY PAUSE WINDOWS]\n# NOTES:\n# - This is currently INCOMPATIBLE with 'docker' and 'manual'.\n# - See https://github.com/dockur/windows/issues/674\n# DEFAULT VALUE: 'off'\n# VALID VALUES:\n# - 'on'\n# - 'off'\nAUTOPAUSE=\"off\"\n\n# [AUTOMATICALLY PAUSE WINDOWS TIMEOUT]\n# NOTES:\n# - This setting determines the duration of inactivity to tolerate before Windows is automatically paused.\n# - This setting is ignored if 'AUTOPAUSE' is set to 'off'.\n# - The value must be specified in seconds (to the nearest 10 seconds e.g., '30', '40', '50', etc.).\n# - For RemoteApp RDP sessions, there is a mandatory 20-second delay, so the minimum value that can be specified here is '20'.\n# - Source: https://techcommunity.microsoft.com/t5/security-compliance-and-identity/terminal-services-remoteapp-8482-session-termination-logic/ba-p/246566\n# DEFAULT VALUE: '300'\n# VALID VALUES: \u003e=20\nAUTOPAUSE_TIME=\"300\"\n\n# [FREERDP COMMAND]\n# NOTES:\n# - WinApps will attempt to automatically detect the correct command to use for your system.\n# DEFAULT VALUE: '' (BLANK)\n# VALID VALUES: The command required to run FreeRDPv3 on your system (e.g., 'xfreerdp', 'xfreerdp3', etc.).\nFREERDP_COMMAND=\"\"\n```\n\n\u003e [!IMPORTANT]\n\u003e `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.\n\n\u003e [!IMPORTANT]\n\u003e If you wish to use an alternative WinApps backend (other than `Docker`), uncomment and change `WAFLAVOR=\"docker\"` to `WAFLAVOR=\"podman\"` or `WAFLAVOR=\"libvirt\"`.\n\n#### Configuration Options Explained\n- 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.\n- 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.\n- For domain users, you can uncomment and change `RDP_DOMAIN`.\n- On high-resolution (UHD) displays, you can set `RDP_SCALE` to the scale you would like to use (100, 140 or 180).\n- To add additional flags to the FreeRDP call (e.g. `/prevent-session-lock 120`), uncomment and use the `RDP_FLAGS` configuration option.\n- 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.\n- If you enable `DEBUG`, a log will be created on each application start in `~/.local/share/winapps/winapps.log`.\n- If using a system on which the FreeRDP command is not `xfreerdp` or `xfreerdp3`, the correct command can be specified using `FREERDP_COMMAND`.\n\n### Step 4: Test FreeRDP\n1. Test establishing an RDP session by running the following command, replacing the `/u:`, `/p:`, and `/v:` values with the correct values specified in `~/.config/winapps/winapps.conf`.\n\n    ```bash\n    xfreerdp3 /u:\"Your Windows Username\" /p:\"Your Windows Password\" /v:192.168.122.2 /cert:tofu\n\n    # Or, if you installed FreeRDP using Flatpak\n    flatpak run --command=xfreerdp com.freerdp.FreeRDP /u:\"Your Windows Username\" /p:\"Your Windows Password\" /v:192.168.122.2 /cert:tofu\n    ```\n\n    - Please note that the correct `FreeRDP` command may vary depending on your system (e.g. `xfreerdp`, `xfreerdp3`, etc.).\n    - Ensure you use the correct IP address for your Windows instance in the above command.\n    - If prompted within the terminal window, choose to accept the certificate permanently.\n\n    If the Windows desktop appears in a `FreeRDP` window, the configuration was successful and the correct RDP TLS certificate was enrolled on the Linux host. Disconnect from the RDP session and skip the following debugging step.\n\n2. [DEBUGGING STEP] If an outdated or expired certificate is detected, the `FreeRDP` command will display output resembling the following. In this case, the old certificate will need to be removed and a new RDP TLS certificate installed.\n\n    ```\n    @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@\n    @           WARNING: CERTIFICATE NAME MISMATCH!           @\n    @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@\n\n    The hostname used for this connection (192.168.122.2:3389)\n    does not match the name given in the certificate:\n    Common Name (CN):\n            RDPWindows\n    A valid certificate for the wrong name should NOT be trusted!\n\n    The host key for 192.168.122.2:3389 has changed\n\n    @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@\n    @    WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED!     @\n    @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@\n\n    IT IS POSSIBLE THAT SOMEONE IS DOING SOMETHING NASTY!\n    Someone could be eavesdropping on you right now (man-in-the-middle attack)!\n    It is also possible that a host key has just been changed.\n    The fingerprint for the host key sent by the remote host is 8e:b4:d2:8e:4e:14:e7:4e:82:9b:07:5b:e1:68:40:18:bc:db:5f:bc:29:0d:91:83:f9:17:f9:13:e6:51:dc:36\n    Please contact your system administrator.\n    Add correct host key in /home/rohanbarar/.config/freerdp/server/192.168.122.2_3389.pem to get rid of this message.\n    ```\n\n    If you experience the above error, delete any old or outdated RDP TLS certificates associated with Windows, as they can prevent `FreeRDP` from establishing a connection.\n\n    These certificates are located within `~/.config/freerdp/server/` and follow the naming format `\u003cWindows-VM-IPv4-Address\u003e_\u003cRDP-Port\u003e.pem` (e.g., `192.168.122.2_3389.pem`, `127.0.0.1_3389.pem`, etc.).\n\n    If you use FreeRDP for purposes other than WinApps, ensure you only remove certificates related to the relevant Windows VM. If no relevant certificates are found, no action is needed.\n\n    Following deletion, re-attempt establishing an RDP session.\n\n### Step 5: Run the WinApps Installer\nWith Windows still powered on, run the WinApps installer.\n\n```bash\nbash \u003c(curl https://raw.githubusercontent.com/winapps-org/winapps/main/setup.sh)\n```\n\nOnce WinApps is installed, a list of additional arguments can be accessed by running `winapps-setup --help`.\n\n\u003cimg src=\"./demo/installer.gif\" width=1000 alt=\"WinApps Installer Animation.\"\u003e\n\n## Adding Additional Pre-defined Applications\nAdding 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:\n1. Modify the name and variables to reflect the appropriate/desired values for your application.\n2. Replace `icon.svg` with an SVG for your application (ensuring the icon is appropriately licensed).\n3. Remove and reinstall WinApps.\n4. 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).\n\n## Running Applications Manually\nWinApps 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.\n\n```bash\nwinapps manual \"C:\\my\\directory\\executableNotInPath.exe\"\nwinapps manual executableInPath.exe\n```\n\n## Updating WinApps\nThe installer can be run multiple times. To update your installation of WinApps:\n1. Run the WinApps installer to remove WinApps from your system.\n2. Pull the latest changes from the WinApps GitHub repository.\n3. Re-install WinApps using the WinApps installer by running `winapps-setup`.\n\n## Installation using Nix\n\nFirst, follow Step 1 of the normal installation guide to create your VM.\nThen, install WinApps according to the following instructions.\n\nAfter installation, it will be available under `winapps`, with the installer being available under `winapps-setup`\nand the optional launcher being available under `winapps-launcher.`\n\n### Using standalone Nix\n\nFirst, make sure Flakes and the `nix` command are enabled.\nIn your `~/.config/nix/nix.conf`:\n```\nexperimental-features = nix-command flakes\n# specify to use binary cache (optional)\nextra-substituters = https://winapps.cachix.org/\nextra-trusted-public-keys = winapps.cachix.org-1:HI82jWrXZsQRar/PChgIx1unmuEsiQMQq+zt05CD36g=\nextra-trusted-users = \u003cyour-username\u003e # replace with your username\n```\n\n```bash\nnix profile install github:winapps-org/winapps#winapps\nnix profile install github:winapps-org/winapps#winapps-launcher # optional\n```\n\n### On NixOS using Flakes\n\n```nix\n# flake.nix\n{\n  description = \"My configuration\";\n\n  inputs = {\n    nixpkgs.url = \"github:NixOS/nixpkgs/nixos-unstable\";\n\n    winapps = {\n      url = \"github:winapps-org/winapps\";\n      inputs.nixpkgs.follows = \"nixpkgs\";\n    };\n  };\n\n  outputs =\n    inputs@{\n      nixpkgs,\n      winapps,\n      ...\n    }:\n    {\n      nixosConfigurations.hostname = nixpkgs.lib.nixosSystem rec {\n        system = \"x86_64-linux\";\n\n        specialArgs = {\n          inherit inputs system;\n        };\n\n        modules = [\n          ./configuration.nix\n          (\n            {\n              pkgs,\n              system ? pkgs.system,\n              ...\n            }:\n            {\n              # set up binary cache (optional)\n              nix.settings = {\n                substituters = [ \"https://winapps.cachix.org/\" ];\n                trusted-public-keys = [ \"winapps.cachix.org-1:HI82jWrXZsQRar/PChgIx1unmuEsiQMQq+zt05CD36g=\" ];\n              };\n\n              environment.systemPackages = [\n                winapps.packages.\"${system}\".winapps\n                winapps.packages.\"${system}\".winapps-launcher # optional\n              ];\n            }\n          )\n        ];\n      };\n    };\n}\n```\n\n### On NixOS without Flakes\n\n[Flakes aren't real and they can't hurt you.](https://jade.fyi/blog/flakes-arent-real/).\nHowever, if you still don't want to use flakes, you can use WinApps with flake-compat like:\n\n```nix\n# configuration.nix\n{\n  pkgs,\n  system ? pkgs.system,\n  ...\n}:\n{\n  # set up binary cache (optional)\n  nix.settings = {\n    substituters = [ \"https://winapps.cachix.org/\" ];\n    trusted-public-keys = [ \"winapps.cachix.org-1:HI82jWrXZsQRar/PChgIx1unmuEsiQMQq+zt05CD36g=\" ];\n    trusted-users = [ \"\u003cyour username\u003e\" ]; # replace with your username\n  };\n\n  environment.systemPackages =\n    let\n      winapps =\n        (import (builtins.fetchTarball \"https://github.com/winapps-org/winapps/archive/main.tar.gz\"))\n        .packages.\"${system}\";\n    in\n    [\n      winapps.winapps\n      winapps.winapps-launcher # optional\n    ];\n}\n```\n\n## Star History\n\u003ca href=\"https://star-history.com/#winapps-org/winapps\u0026Date\"\u003e\n \u003cpicture\u003e\n   \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://api.star-history.com/svg?repos=winapps-org/winapps\u0026type=Date\u0026theme=dark\"/\u003e\n   \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://api.star-history.com/svg?repos=winapps-org/winapps\u0026type=Date\"/\u003e\n   \u003cimg alt=\"Star History Chart\" src=\"https://api.star-history.com/svg?repos=winapps-org/winapps\u0026type=Date\"/\u003e\n \u003c/picture\u003e\n\u003c/a\u003e\n","funding_links":[],"categories":["Shell","语音识别与合成_其他","docker","Linux"],"sub_categories":["资源传输下载","Other"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwinapps-org%2Fwinapps","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwinapps-org%2Fwinapps","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwinapps-org%2Fwinapps/lists"}