# MustardChef/WSABuilds

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/mustardchef-wsabuilds).**

16,096 stars · 2,202 forks · Python · agpl-3.0

## Links

- GitHub: https://github.com/MustardChef/WSABuilds
- awesome-repositories: https://awesome-repositories.com/repository/mustardchef-wsabuilds.md

## Topics

`android` `android-emulator` `google-apps` `kernelsu` `magisk` `magiskonwsa` `magiskonwsalocal` `subsystem` `windows` `windows-10` `windows-11` `windows-subsystem-android` `windows-subsystem-for-android` `windows10` `windowssubsystemforandroid` `wsa` `wsa-root` `wsa-with-gapps-and-magisk` `wsapatch`

## Description

WSABuilds is a management framework designed to deploy and customize virtualized mobile runtime environments on desktop operating systems. It provides a comprehensive suite of tools for building, installing, and maintaining these environments, enabling the native execution of mobile applications alongside standard desktop software.

The project distinguishes itself through its focus on deep system integration and lifecycle management. It allows users to generate tailored virtual environment packages by injecting administrative tools, service components, and specific configurations prior to deployment. Beyond initial setup, the framework automates complex tasks such as system updates, data migration, and the resolution of network or installation conflicts, ensuring that virtualized instances remain functional and persistent across host system changes.

The platform covers a broad range of operational capabilities, including hardware-level virtualization settings, graphics acceleration configuration, and advanced storage management through symbolic linking and disk image persistence. It also includes diagnostic utilities for log capture and security-focused features for managing administrative privileges and network connectivity policies.

The project is implemented as a collection of command-line utilities and administrative scripts that handle the extraction, configuration, and registration of system components. It provides a centralized interface for managing the entire lifecycle of the virtual environment, from initial compatibility validation to final removal.

## Tags

### Development Tools & Productivity

- [Windows Customization Frameworks](https://awesome-repositories.com/f/development-tools-productivity/platforms-runtimes-language-services/development-platforms/operating-system-environments/operating-systems/operating-system-deployment-tools/windows-customization-frameworks.md) — Builds and deploys customized Android runtime environments on Windows with administrative enhancements.
- [Application Backups](https://awesome-repositories.com/f/development-tools-productivity/application-backups.md) — Secures and migrates virtual disk images and configuration files to prevent data loss. ([source](https://github.com/MustardChef/WSABuilds/blob/master/Documentation/WSABuilds/Backup%20and%20Restore.md))
- [Automated Update Managers](https://awesome-repositories.com/f/development-tools-productivity/automated-update-managers.md) — Automates the update process for virtual environments while preserving user data and configurations. ([source](https://github.com/MustardChef/WSABuilds/tree/master/MagiskOnWSA))
- [Custom Build Generators](https://awesome-repositories.com/f/development-tools-productivity/custom-build-generators.md) — Generates custom virtual environment packages by integrating administrative tools and system modifications. ([source](https://github.com/MustardChef/WSABuilds/blob/master/Documentation/WSABuilds/Custom%20Builds.md))
- [Installation Scripts](https://awesome-repositories.com/f/development-tools-productivity/installation-scripts.md) — Executes administrative scripts to install virtual environments when standard methods fail. ([source](https://github.com/MustardChef/WSABuilds/blob/master/Documentation/Fix%20Guides/Pre-Install%20Issues/FixInstallps1.md))
- [Environment Update Utilities](https://awesome-repositories.com/f/development-tools-productivity/terminal-shell-cli/terminal-cli-enhancements/shell-terminal-utilities/configuration-environment-management/shell-environments/shell-configuration-frameworks/environment-update-utilities.md) — Updates virtual environment system files while maintaining user data and application consistency. ([source](https://github.com/MustardChef/WSABuilds/blob/master/Documentation/WSABuilds/FAQ.md))

### Mobile Development

- [Desktop Integration](https://awesome-repositories.com/f/mobile-development/mobile-capabilities/desktop-integration.md) — Integrates mobile applications into desktop environments through virtualized runtime management.
- [Mobile Operating Systems](https://awesome-repositories.com/f/mobile-development/mobile-operating-systems.md) — Enables the execution of mobile software on desktop environments through integrated system binaries. ([source](https://github.com/MustardChef/WSABuilds#readme))

### Operating Systems & Systems Programming

- [Virtualization Managers](https://awesome-repositories.com/f/operating-systems-systems-programming/virtualization-managers.md) — Provides a management utility for configuring and updating virtualized mobile environments on desktop.
- [Windows System Integrations](https://awesome-repositories.com/f/operating-systems-systems-programming/kernel-core-internals/system-programming-primitives/system-abstractions/os-specific-integration-modules/windows-system-integrations.md) — Integrates system-level components to support mobile application compatibility on desktop hardware.
- [Hypervisors](https://awesome-repositories.com/f/operating-systems-systems-programming/virtualization-emulation/hypervisors.md) — Leverages hardware-level virtualization features and kernel-mode drivers to run mobile operating system instances within a desktop environment.
- [Virtualization Configuration](https://awesome-repositories.com/f/operating-systems-systems-programming/virtualization-emulation/virtualization-platforms/virtualization-configuration.md) — Configures system settings to support the virtualization requirements necessary for running mobile environments. ([source](https://github.com/MustardChef/WSABuilds/blob/master/Documentation/WSABuilds/FAQ.md))
- [Custom Image Builders](https://awesome-repositories.com/f/operating-systems-systems-programming/os-development-distributions/custom-image-builders.md) — Modifies pre-built virtual environment packages by injecting administrative tools and service components prior to deployment.
- [System Services](https://awesome-repositories.com/f/operating-systems-systems-programming/system-administration-maintenance/system-services.md) — Bundles essential service components and administrative tools into system images to provide advanced functionality. ([source](https://github.com/MustardChef/WSABuilds/blob/master/Documentation/WSABuilds/Information.md))
- [Virtualization Networking](https://awesome-repositories.com/f/operating-systems-systems-programming/virtualization-emulation/virtualization-platforms/virtualization-networking.md) — Manages network adapters and firewall rules to ensure stable connectivity for virtualized applications.

### DevOps & Infrastructure

- [Virtualization Managers](https://awesome-repositories.com/f/devops-infrastructure/virtualization-managers.md) — Automates the full lifecycle of virtualized system components from installation to removal.
- [Deployment Environments](https://awesome-repositories.com/f/devops-infrastructure/deployment-management-strategies/execution-platforms-and-targets/deployment-environments.md) — Deploys pre-configured virtual environments that enable native mobile application execution on desktop. ([source](https://github.com/MustardChef/WSABuilds/blob/master/Documentation/WSABuilds/Information.md))
- [Virtual Network Removal](https://awesome-repositories.com/f/devops-infrastructure/infrastructure/networking/routing/network-virtualization-tools/virtual-network-removal.md) — Resolves connectivity issues by identifying and removing conflicting virtual network adapters that disrupt internet access. ([source](https://github.com/MustardChef/WSABuilds/blob/master/Documentation/Fix%20Guides/Post-Install%20Issues/FixInternet.md))
- [System Image Generators](https://awesome-repositories.com/f/devops-infrastructure/system-image-generators.md) — Generates and configures tailored virtual environment images with custom administrative and service components.
- [Connectivity Conflict Resolvers](https://awesome-repositories.com/f/devops-infrastructure/cloud-infrastructure/networking-connectivity/connectivity-conflict-resolvers.md) — Resolves connectivity errors between debugging tools and the virtual environment by reserving required network ports and managing virtualization state. ([source](https://github.com/MustardChef/WSABuilds/blob/master/Documentation/Fix%20Guides/Post-Install%20Issues/TargetMachineActivelyRefusedConnection.md))
- [Installation Scripts](https://awesome-repositories.com/f/devops-infrastructure/installation-scripts.md) — Automates the installation and configuration of system components by executing administrative scripts that manage file extraction and registry registration.

### Data & Databases

- [Virtual Disk Overlays](https://awesome-repositories.com/f/data-databases/virtual-disk-overlays.md) — Stores application data and system states in isolated virtual disk files that can be moved, backed up, or restored independently.
- [Data Restoration Tools](https://awesome-repositories.com/f/data-databases/data-restoration-tools.md) — Enables migrating existing application data and settings to a fresh installation by replacing the virtual disk image file. ([source](https://github.com/MustardChef/WSABuilds/blob/master/Documentation/WSABuilds/Backup%20and%20Restore.md))

### Networking & Communication

- [Host Networking Services](https://awesome-repositories.com/f/networking-communication/host-networking-services.md) — Manages firewall rules to facilitate communication between host-based services and applications running inside the virtual environment. ([source](https://github.com/MustardChef/WSABuilds/blob/master/Documentation/Usage%20Guides/General%20Usage%20Guides/LocalHostLoopback.md))

### Security & Cryptography

- [Administrative Privilege Management](https://awesome-repositories.com/f/security-cryptography/administrative-privilege-management.md) — Verifies and manages administrative privileges to allow advanced system modifications within the virtualized environment. ([source](https://github.com/MustardChef/WSABuilds/blob/master/Documentation/Usage%20Guides/General%20Usage%20Guides/KernelSU.md))

### User Interface & Experience

- [Graphics Runtime Configurators](https://awesome-repositories.com/f/user-interface-experience/graphical-application-runtimes/graphics-runtime-configurators.md) — Allows users to select the hardware graphics accelerator used by the virtual environment to optimize performance. ([source](https://github.com/MustardChef/WSABuilds/blob/master/Documentation/Usage%20Guides/General%20Usage%20Guides/ChangingGPU.md))
