WSA Installer

The Modern Windows Subsystem for Android Installation & Management Toolkit

A complete solution for installing Windows Subsystem for Android with Google Play Store on Windows 10/11.

Built with care by AT Tech Zone — MR CYBER

Download WSA Installer (228 MB) · Download Bundle (1.21 GB)

Introduction

WSA Installer is a professional-grade, open-source tool that automates the entire process of installing Windows Subsystem for Android (WSA) with or without Google Play Store on Windows 10 and Windows 11.

Installing WSA manually involves downloading large archives, extracting them with specific tools, configuring Windows features, patching settings files, and optionally integrating Google Apps — a process that can take hours and requires technical expertise. WSA Installer eliminates all of that complexity with a one-click installation experience.

What WSA Installer Does

Capability	Description
System Detection	Automatically scans your system for VT-x/AMD-V virtualization, Hyper-V, VirtualMachinePlatform, HypervisorPlatform, and WSL support
Feature Enabling	Enables all required Windows features automatically with administrator privileges
Virtualization Bypass	Auto-fixes compatibility issues: Hyper-V, problematic KBs, WSL2, Defender exclusion, VBS, FsDepends
WSA Download	Downloads the correct WSA build from GitHub Releases with 30-chunk parallel downloads and resume support
WSA Installation	Extracts, configures, and registers the Android subsystem with proper Developer Mode settings
Play Store Integration	Patches Google Apps (MindTheGapps 13.0) onto the WSA installation with automated ADB authorization
WSAPatch Fix	Applies binary patches to `WsaClient.exe` for Windows 10 compatibility (crash fix)
WSA Pacman	Double-click any APK/XAPK/APKS/APKM to install directly into WSA with desktop shortcut creation
APK File Handler	Registers as Windows handler for APK files with custom icons in Explorer
Background Service	Installs `WSABackgroundService` — monitors WSA status, manages file sharing, handles auto-updates
File Sharing	WebDAV-based drive mounting for WSA user/root filesystems
Self-Update	Checks the server for updates and installs them silently without user intervention
Uninstall	Provides complete WSA removal including services, files, and registry entries

Who Is This For?

End Users who want to run Android apps on Windows without technical knowledge
Developers who need Android emulation for testing
Power Users who want a clean, automated WSA setup with Play Store
Anyone who wants to avoid the complexity of manual WSA installation

Features

Core Features

Feature	Description
3-Phase System Check	System validation → Bundle detection → Virtualization bypass
Smart System Scan	Detects VT-x, Hyper-V, VirtualMachinePlatform, HypervisorPlatform, WSL in real-time
Auto Configuration	Enables required Windows features automatically with admin privileges
One-Click Install	Handles download, extraction, and setup end-to-end
Play Store Patching	Applies Run.bat, WsaClient.exe, ps.ico patches automatically via Rust SDK
WSAPatch Fix	Binary patches WsaClient.exe for compatibility on Windows 10
WSA Pacman	Double-click any APK to install directly into WSA (APK/XAPK/APKS/APKM)
APK File Handler	Registers as Windows handler for APK files with custom icons
Virtualization Bypass	Auto-fixes Hyper-V, KB uninstall, WSL2, Defender, VBS, FsDepends
Background Service	`WSABackgroundService` monitors WSA status and manages the SDK
Self-Update	Checks server for updates and installs silently
Developer Mode	Enabled automatically for advanced usage and ADB access
Win10/Win11 Detection	Uses appropriate GitHub API source per Windows version

Installer Features

Feature	Description
NSIS Professional Setup	Industry-standard Windows installer with wizard UI
Silent Mode	Full `/S` silent install support for automation
Maintenance Mode	Repair, reinstall, or uninstall from existing installation
UAC Elevation	Automatic administrator privilege request
Single Instance	Mutex-based prevents running multiple installer copies
Windows 10 Check	Validates minimum OS build before installation

UI Features

Feature	Description
Flet-Based GUI	Modern cross-platform UI framework
Glass Transparency	Alpha-blended window transparency (configurable 0-100)
5-Step Wizard	Guided installation flow with 3-phase pre-check
Real-Time Progress	Live download progress with speed and ETA
Remote Config	Server-side configuration updates without app changes
APK Install Dialog	6-step progress tracker for APK installation

Developer Features

Feature	Description
Source Protection	Nuitka compilation + PyInstaller bundling
Rust Native Modules	`widget_ui.pyd` (security gateway) + `playstore_patcher_mem.pyd` (SDK)
Embedded Python 3.14	Self-contained runtime for Play Store patcher
Activity Logging	Session-based logging to `wsa_activity.log`
Config Controller	Source-tracked configuration (default → dev → server)

System Requirements

Requirement	Minimum	Recommended
OS	Windows 10 (build 19041+) or Windows 11	Windows 11 22H2+
RAM	8 GB	16 GB
Disk Space	10 GB free	SSD with 20 GB free
Internet	Required for initial download only	Broadband recommended
Privileges	Administrator	Administrator
Virtualization	Enabled in BIOS/UEFI	Intel VT-x or AMD-V

Windows Features Required

Feature	Status	How Installer Handles It
Hyper-V	Must be enabled	Auto-enabled by installer
VirtualMachinePlatform	Must be enabled	Auto-enabled by installer
HypervisorPlatform	Must be enabled	Auto-enabled by installer
Windows Subsystem for Linux	Must be enabled	Auto-enabled by installer

Installation

Step 1 — Download

Download the WSA Installer setup file from the official release:

File	Size	Link
`WSA_Installer_Setup.exe`	228 MB	Download
`bundle.wsa` (optional)	1.21 GB	Download

Note: The bundle.wsa file is optional. If not provided, the installer will download WSA packages directly from GitHub during installation.

Step 2 — Run Installer

Right-click WSA_Installer_Setup.exe and select Run as administrator
Accept the UAC (User Account Control) prompt
The installer wizard will launch with the Welcome page

Silent Install (Advanced):

WSA_Installer_Setup.exe /S

Step 3 — System Check

The installer automatically scans your system for:

Virtualization Support — Intel VT-x or AMD-V (detected via 5 methods: CPUID, wmic, systeminfo, PowerShell, registry)
Hyper-V — Microsoft's hardware virtualization
VirtualMachinePlatform — Required for WSA
HypervisorPlatform — Hypervisor interface
WSL — Windows Subsystem for Linux

If any required features are missing, the installer will offer to enable them automatically.

Step 4 — Install WSA

The installer proceeds through 6 phases:

Phase	Action
1. Locate	Finds WSA package (from bundle or GitHub download)
2. Verify	Validates archive integrity and checksum
3. Prepare	Extracts 7z archive, copies files to installation directory
4. Patch	Applies Developer Mode settings, registry fixes, WsaClient patches
5. Run	Registers WSA with Windows, starts the subsystem
6. Finalize	Creates shortcuts, configures background service

Step 5 — Add Play Store

If you selected the Play Store option, the installer proceeds through 7 additional phases:

Phase	Action
1. Locate	Finds GApps package (MindTheGapps 13.0)
2. Verify	Validates GApps archive
3. Extract	Extracts GApps to temporary directory
4. Patch	Runs MagiskOnWSALocal patching (Run.bat + patches)
5. ADB	Automates ADB authorization via pywinauto GUI automation
6. Install	Pushes GApps to WSA via ADB
7. Finalize	Applies Play Store icon, cleans up, restarts WSA

Step 6 — Complete

Once installation is complete:

Play Store shortcut appears in Start Menu
Windows Subsystem for Android shortcut appears on Desktop
WSABackgroundService is running and monitoring WSA status
You can now launch Android apps directly from the Start Menu

The WSA Bundle

Overview

The WSA Bundle (bundle.wsa) is a pre-packaged archive that combines both the WSA Basic package and the WSA + Google Play Store package into a single downloadable asset.

What's Included

1. Base Package (WSA Basic)

Component	Version / Notes
WSA Build	2407.40000.4.0
Channel	Nightly Release
Architecture	x64
Google Play Store	Not included
Amazon Appstore	Not included

2. Play Store Package (WSA + GApps)

Component	Version / Notes
WSA Build	2407.40000.4.0
Channel	Nightly Release
Architecture	x64
Google Play Store	Included (MindTheGapps 13.0)
Amazon Appstore	Not included

Both packages are based on the official WSABuilds release from MustardChef/WSABuilds.

Why a Bundle?

Benefit	Description
Single download	One file instead of two
Faster install	Reduced overall installation time
Offline access	Both packages remain available offline
No redundancy	No redundant network requests

Architecture

Application Architecture

graph TB
    subgraph "Frontend (Flet GUI)"
        WIZARD[5-Step Wizard]
        OVERLAY[Overlays<br/>About, Advanced, Download]
        SB[Sidebar Navigation]
    end

    subgraph "Core Engine"
        IL[InstallerLogic]
        CC[ConfigController]
        RCM[RemoteConfigManager]
    end

    subgraph "Native Security"
        WU[widget_ui.pyd<br/>Rust Gateway]
        PS[playstore_patcher_mem.pyd<br/>Play Store SDK]
        WI[wsa_init.pyd<br/>WSA Boot/ADB]
        NP[wsa_net_provider.dll<br/>UNC-to-WebDAV]
        APK[ApkIconShlExt.dll<br/>APK Icons]
    end

    subgraph "System Integration"
        SVC[WSABackgroundService<br/>Windows SCM]
        ADB[ADB Bridge<br/>Port 58526]
        WSA[Windows Subsystem<br/>for Android]
        EMB[Embedded Python 3.14]
    end

    subgraph "External"
        GH[GitHub Releases]
        SERVER[Remote Config Server]
    end

    WIZARD --> IL
    OVERLAY --> IL
    SB --> WIZARD
    IL --> CC
    IL --> RCM
    IL --> WU
    IL --> PS
    IL --> WI
    IL --> ADB
    ADB --> WSA
    PS --> EMB
    SVC --> WSA
    SVC --> NP
    RCM --> WU
    RCM --> SERVER
    IL --> GH

Security Architecture

┌──────────────────────────────────────────────────────┐
│                  Security Layers                      │
├──────────────────────────────────────────────────────┤
│                                                      │
│  Layer 1: widget_ui.pyd (Rust)                      │
│  ├── Zero-trust config gateway                      │
│  ├── Signature verification                         │
│  └── Encrypted config parsing                       │
│                                                      │
│  Layer 2: Socket-based Instance Locks               │
│  ├── Single instance enforcement                    │
│  └── Port-based process detection                   │
│                                                      │
│  Layer 3: Windows Service                           │
│  ├── SYSTEM-level service (WSABackgroundService)    │
│  ├── Auto-restart on failure                        │
│  └── User session process spawning                  │
│                                                      │
│  Layer 4: Source Protection                         │
│  ├── Nuitka compilation (app.py → app.pyd)          │
│  ├── PyInstaller bundling                           │
│  └── Binary string obfuscation                      │
│                                                      │
└──────────────────────────────────────────────────────┘

Installation Flow

flowchart TD
    A[Start] --> B{Admin?}
    B -->|No| C[Request Elevation]
    C --> D{Admin?}
    D -->|No| E[Exit]
    D -->|Yes| F[Phase 1: System Check]
    B -->|Yes| F
    F --> G{Virtualization?}
    G -->|No| H[Virtualization Bypass]
    H --> G
    G -->|Yes| I[Phase 2: Bundle Check]
    I -->|Found| J[Extract Bundle]
    I -->|Not Found| K[Download from GitHub]
    K --> J
    J --> L[Phase 3: Apply Fixes]
    L --> M[Install WSA]
    M --> N{Play Store?}
    N -->|Yes| O[7-Phase Play Store]
    N -->|No| P[Complete]
    O --> P
    P --> Q[Create Shortcuts]
    Q --> R[Start Service]
    R --> S[Register APK Handler]
    S --> T[Done]

CLI Reference

Command Line Arguments

Argument	Description
`--install-service`	Install WSABackgroundService
`--uninstall-service`	Remove WSABackgroundService
`--bg-service`	Run as background service (SYSTEM context)
`--bg-service-gui`	Background service with visible console
`--headless`	Run background service in headless mode
`--uninstall`	Launch uninstall dialog
`--update <url> <ver>`	Self-update dialog
`--repair-wsa`	4-step WSA repair (detect → stop → backup → reinstall)
`--file-sharing`	File sharing (WebDAV mount) dialog
`--ad <url> <secs>`	Spawn ad overlay
`--sdk`	Start Play Store patcher SDK
`--flet-patch`	Patch flet.exe with custom icon and version
`--register-apk`	Register WSA APK handler in Windows Registry
`--unregister-apk`	Unregister WSA APK handler from Windows Registry
`--wsa-pacman <path>`	Install APK/XAPK/APKS/APKM into WSA from given path

Silent Installation

WSA_Installer_Setup.exe /S

Repair from Windows Settings

WSA_Installer_Setup.exe /S /repair

WSA WebDev — Android WebDAV Server

The WSA WebDev project is a complete Android WebDAV Server that runs inside WSA, providing file system access from your PC's web browser.

Features

Feature	Description
WebDAV Protocol	Full WebDAV server (OPTIONS, GET, PUT, DELETE, MKCOL, COPY, MOVE, PROPFIND, PROPPATCH, LOCK, UNLOCK)
Root Access	Supports root filesystem operations via `su`
Web File Manager	Complete SPA with dark/light themes, grid/list views, drag-and-drop
ADB Commands	Remote control via ADB intents (START, STOP, RESTART, STATUS, HEALTH)
Auto-Start	Boot receiver for automatic startup
Health Monitoring	30-second interval health checks

See the wsa-webdav repository for full documentation.

Configuration

Remote Configuration

The installer fetches remote JSON configuration from the server on a timer. Configuration is managed by ConfigController with source tracking:

Default Config → Dev Mode Config → Server Config

Config Sources

Source	Priority	Description
Default	1	Built-in application defaults
Dev Mode	2	Developer mode overrides (if enabled)
Server	3	Remote configuration updates

Security Gateway

The widget_ui.pyd Rust module provides:

Zero-trust config parsing with signature verification
Encrypted configuration handling
Hash-based deduplication
Fallback mechanisms for offline scenarios

Troubleshooting

Common Issues

Issue	Solution
Virtualization not detected	Enable VT-x/AMD-V in BIOS/UEFI
Hyper-V won't enable	Check if WSL2 is installed, run `bcdedit /set hypervisorlaunchtype auto`
Download fails	Check internet connection, try manually downloading bundle.wsa
Play Store not working	Ensure ADB authorization completed, check Developer Mode is enabled
WsaClient.exe crashes (Win10)	WSAPatch fix is applied automatically; manual patch available
Service won't start	Run `WSA Installer.exe --install-service` as administrator

Logs

Activity Log: wsa_activity.log — Session-based activity logging
Application Logs: Written to sys.__stdout__ with [APP LOGS] prefix

Manual WSA Kill

If WSA gets stuck:

taskkill /F /IM WsaService.exe
taskkill /F /IM WsaClient.exe
taskkill /F /IM WsaSettings.exe

Build from Source

Prerequisites

Python 3.14
Node.js (for yt-dlp embedded in emb_py)
Nuitka (pip install nuitka)
PyInstaller (pip install pyinstaller)
NSIS (nsis.sourceforge.io)

Primary Build

build.bat

Build pipeline:

Step 1: Clean
    └── Removes dist/, build/, app.pyd, *.build

Step 2: Dependencies
    └── pip install -r requirements.txt

Step 3: Version Update
    └── PowerShell replaces version in app.py + file_version_info.txt

Step 4: Nuitka Module
    ├── Compiles app.py → app.pyd (module mode, source protection)
    └── Renames app.py → wsa.py to hide source

Step 5: PyInstaller Onedir
    ├── Uses WSA_Installer_Download_onedir.spec
    └── Restores app.py from wsa.py after build

Step 6: WSARepair.exe
    └── PyInstaller --onefile

Step 7: Flet Client Patch
    ├── Patches flet.exe icon + version info
    └── Creates patched flet-windows.zip

Step 8: NSIS Installer
    └── Builds WSA_Installer_Setup.exe

Alternate Build

build2.bat

Uses Nuitka standalone mode with C# launcher compilation.

Tech Stack

Core Technologies

Technology	Version	Usage
Python	3.14	Application framework with Flet UI
Rust	Latest	Security gateway (`widget_ui.pyd`) and SDK (`playstore_patcher_mem.pyd`)
Flet	Latest	Cross-platform GUI framework
PyQt6	Latest	Embedded Python runtime for Play Store patcher

Build Tools

Tool	Usage
Nuitka	Python to C compilation (source protection)
PyInstaller	Application bundling (onedir mode)
NSIS	Windows installer packaging
C# / PowerShell	Launcher compilation

Dependencies

Package	Purpose
requests	HTTP client for downloads
flet	Cross-platform UI framework
pyautogui	GUI automation
pyperclip	Clipboard operations
pywinauto	Windows UI Automation (ADB authorization)
PyQt6	Qt6 bindings (ads browser)
PyQt6-WebEngine	Chromium web engine
pycryptodomex	Cryptography
pillow	Image processing
comtypes	COM interface access
psutil	Process/system utilities
brotli	Compression
inflate64	64-bit inflate compression
multivolumefile	Multi-volume archives
pybcj	Blosc2 compression
pyppmd	PPMD compression
texttable	Text table formatting
pywin32	Win32 API access
packaging	Version parsing

Native Modules

Module	Language	Purpose
`widget_ui.pyd`	Rust	Zero-trust security gateway
`playstore_patcher_mem.pyd`	Rust	Play Store patcher SDK
`wsa_init.pyd`	Rust	WSA boot, ADB connect, WebDAV start
`wsa_net_provider.dll`	Rust	UNC-to-WebDAV network provider
`ApkIconShlExt.dll`	C++	Per-file APK icons in Explorer

Roadmap

Current (v1.2.x)

Planned

Contributing

We welcome contributions! Please see our Contributing Guide for details.

Quick Start for Contributors

# 1. Fork the repository
# 2. Clone your fork
git clone https://github.com/YOUR_USERNAME/wsa-installer.git

# 3. Create a feature branch
git checkout -b feature/my-feature

# 4. Make your changes
# 5. Test with run.bat

# 6. Commit and push
git commit -m "feat(scope): add my feature"
git push origin feature/my-feature

# 7. Create a Pull Request

Credits

Core Projects

Project	Maintainer	Role
WSA Builds	MustardChef/WSABuilds	Provides pre-built WSA archives
MindTheGapps	MindTheGapps	Provides Google Apps package
Flet	Flet	Cross-platform UI framework
Nuitka	Nuitka	Python to C compiler
PyInstaller	PyInstaller	Application bundler
NSIS	NSIS	Windows installer system

Acknowledgments

Microsoft — For developing and maintaining Windows Subsystem for Android
WSABuilds Community — For providing nightly WSA builds
MindTheGapps Team — For maintaining the GApps package
All open-source contributors whose work made this project possible

License

This project is licensed under the MIT License — see LICENSE for details.

Links

Built with care by AT Tech Zone — v1.2.0.0

Name		Name	Last commit message	Last commit date
.github		.github
assets		assets
build		build
docs		docs
embedded-tools		embedded-tools
src		src
CHANGELOG.md		CHANGELOG.md
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE.md		LICENSE.md
README.md		README.md
ROADMAP.md		ROADMAP.md
SECURITY.md		SECURITY.md
SUPPORT.md		SUPPORT.md
file_version_info.txt		file_version_info.txt
requirements.txt		requirements.txt

Uh oh!

Uh oh!

Latest commit

History

Folders and files

Repository files navigation

WSA Installer

The Modern Windows Subsystem for Android Installation & Management Toolkit

Table of Contents

Introduction

What WSA Installer Does

Who Is This For?

Features

Core Features

Installer Features

UI Features

Developer Features

System Requirements

Windows Features Required

Installation

Step 1 — Download

Step 2 — Run Installer

Step 3 — System Check

Step 4 — Install WSA

Step 5 — Add Play Store

Step 6 — Complete

The WSA Bundle

Overview

What's Included

1. Base Package (WSA Basic)

2. Play Store Package (WSA + GApps)

Why a Bundle?

Architecture

Application Architecture

Security Architecture

Installation Flow

CLI Reference

Command Line Arguments

Silent Installation

Repair from Windows Settings

WSA WebDev — Android WebDAV Server

Features

Configuration

Remote Configuration

Config Sources

Security Gateway

Troubleshooting

Common Issues

Logs

Manual WSA Kill

Build from Source

Prerequisites

Primary Build

Alternate Build

Tech Stack

Core Technologies

Build Tools

Dependencies

Native Modules

Roadmap

Current (v1.2.x)

Planned

Contributing

Quick Start for Contributors

Credits

Core Projects

Acknowledgments

License

Links

About

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

Sponsor this project