Documentation
Everything you need to get the most out of WSA Installer
Flet GUI (app.py)
~11,000 lines of Python driving the 5-step frameless wizard, real-time progress UI, glassmorphism design, and all sub-dialogs including repair, update, uninstall, and file sharing.
InstallerLogic Engine
Handles parallel chunked downloads with resume support, 7z extraction via tar.exe, WSA package verification (filelist.txt), registry patching, and ADB automation for Play Store.
WSABackgroundService
Windows SCM service that monitors WSA ADB port, manages the Play Store SDK via embedded Python 3.14, auto-mounts WebDAV file shares (X:/ R:/), and checks for updates.
ConfigController
Three-tier configuration system: Default → Developer Mode → Server (remote JSON). Source-tracked with schema validation. Polls GitHub for remote config updates every 60 seconds.
Rust Native Modules
widget_ui.pyd provides a zero-trust security gateway with signature verification, encrypted config parsing, and decompression. playstore_patcher_mem.pyd is the Play Store patcher SDK.
Build Pipeline
Nuitka compiles app.py → app.pyd for source protection. PyInstaller bundles into onedir. Flet.exe is patched with custom icon and version. NSIS creates the final setup EXE.
Tech Stack
Python 3.14
Application framework with Flet UI
Rust Latest
Security gateway & Play Store patcher SDK
Flet Latest
Cross-platform GUI framework (Flutter-based)
Nuitka Latest
Python to C compilation (source protection)
PyInstaller Latest
Application bundling (onedir mode)
NSIS Latest
Windows installer packaging
PyQt6 Latest
Qt6 bindings for ad overlay
PySide6 Latest
Qt6 bindings for Play Store patcher
Windows Features Required
Hyper-V
Microsoft's hardware virtualization platform
VirtualMachinePlatform
Required virtual machine platform for WSA
HypervisorPlatform
Windows hypervisor interface
Windows Subsystem for Linux
WSL support required by WSA
