explaingit

wsa-community/wsagascript

Analysis updated 2026-05-18

3,622ShellAudience · ops devopsComplexity · 4/5LicenseSetup · hard

TLDR

Shell scripts that patch Windows Subsystem for Android to add Google Play and Google services, which Microsoft's version leaves out.

Mindmap

mindmap
  root((WSAGAScript))
    What it does
      Adds Google apps to WSA
      Patches Android system image
    Tech stack
      Shell scripts
      WSL2
      Ubuntu
    Use cases
      Install Google Play Store on WSA
      Enable Android apps needing Google services
    Audience
      Windows 11 power users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Add the Google Play Store to Windows Subsystem for Android

USE CASE 2

Run Android apps that require Google's background services on Windows 11

USE CASE 3

Gain root access on a WSA installation for deeper customization

USE CASE 4

Follow a step-by-step guide to patch a downloaded WSA package

What is it built with?

ShellWSL2Ubuntu

How does it compare?

wsa-community/wsagascriptconduktor/kafka-stack-docker-composeful1e5/bibata_cursor
Stars3,6223,6223,622
LanguageShellShellShell
Setup difficultyhardmoderateeasy
Complexity4/53/51/5
Audienceops devopsops devopsgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires enabling WSL2, installing Ubuntu, and manually extracting/patching a Windows system package.

Unlicense: the code is dedicated to the public domain and can be used freely for any purpose.

In plain English

WSAGAScript is a set of shell scripts that add Google apps, including the Google Play Store, to Windows Subsystem for Android. Windows Subsystem for Android is a feature in Windows 11 that lets the operating system run Android apps directly. However, Microsoft's version does not include Google's services by default, which means Android apps that depend on the Play Store or Google's background services will not work. These scripts patch the WSA installation package to include those missing pieces before you install it. The process is more involved than a typical software install. Because the tools needed to modify an Android system image only run on Linux, the scripts require you to first enable Windows Subsystem for Linux version 2 and install Ubuntu inside it. From there, you download the WSA installation package directly from Microsoft (bypassing the Store to get the raw file), extract it with a tool like 7-Zip, and then run the provided Linux scripts from within the Ubuntu terminal. The scripts modify the Android image files and then you reinstall WSA from the patched package. The README walks through each step in detail, covering WSL2 installation, required Linux utilities, folder setup, where to download the WSA package, and how to run the modification scripts. A video tutorial was provided as a companion resource for the written instructions. There is also an optional step for gaining root access on the WSA installation, which allows deeper modification of the Android environment. The authors include a legal warning noting that installing Google services this way may be in a legal gray area, since it involves redistributing Google's software outside the normal licensed channel. The project is provided as-is under an Unlicense license. It was created during a period of active community interest in running Android apps on Windows 11 before Google officially partnered with Microsoft.

Copy-paste prompts

Prompt 1
Walk me through installing WSL2 and Ubuntu as the first step for using WSAGAScript
Prompt 2
Explain what WSAGAScript does to the WSA installation package and why it's needed
Prompt 3
Show me how to download the WSA package directly from Microsoft to patch with WSAGAScript
Prompt 4
What are the legal risks the WSAGAScript README warns about before I use it?

Frequently asked questions

What is wsagascript?

Shell scripts that patch Windows Subsystem for Android to add Google Play and Google services, which Microsoft's version leaves out.

What language is wsagascript written in?

Mainly Shell. The stack also includes Shell, WSL2, Ubuntu.

What license does wsagascript use?

Unlicense: the code is dedicated to the public domain and can be used freely for any purpose.

How hard is wsagascript to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is wsagascript for?

Mainly ops devops.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.