# schrodingers-neko/mumu-player-12-optimization architecture

> Architecture diagram of the GitHub repository schrodingers-neko/mumu-player-12-optimization, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/schrodingers-neko/mumu-player-12-optimization
- Repository: https://github.com/schrodingers-neko/mumu-player-12-optimization

## Overview

This repository is a Windows PowerShell toolkit and guide for optimizing MuMu Player 12: debloating Android and Windows components, installing APKs, and replacing or restoring the Android launcher. The documented user workflow selects a VM, validates its identity and connection, then runs a task-specific script that acts on the host or Android instance. The README describes shared connection discovery and task safeguards, but no source excerpts were provided, so internal calls beyond those documented are not inferred.

Main entry points: [`mumu_debloater.ps1`](https://github.com/schrodingers-neko/mumu-player-12-optimization/blob/main/mumu_debloater.ps1) (Debloat workflow), [`mumu_common.ps1`](https://github.com/schrodingers-neko/mumu-player-12-optimization/blob/main/mumu_common.ps1) (VM and ADB discovery), [`install_apk.ps1`](https://github.com/schrodingers-neko/mumu-player-12-optimization/blob/main/install_apk.ps1) (APK installation), [`replace_lawnchair.ps1`](https://github.com/schrodingers-neko/mumu-player-12-optimization/blob/main/replace_lawnchair.ps1) (Launcher replacement)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["User entry points"]
  node_context_menu["Explorer install entry"]
  node_batch_entry["Batch install entry<br/>[install_apk.bat]"]
end

subgraph group_shared["Shared connectivity"]
  node_common["VM and ADB discovery<br/>[mumu_common.ps1]"]
end

subgraph group_android["Android operations"]
  node_debloater["Debloat workflow<br/>[mumu_debloater.ps1]"]
  node_input_check["Keyboard validation<br/>[mumu_debloater.ps1]"]
  node_package_cleanup["Android package cleanup<br/>[mumu_debloater.ps1]"]
  node_hosts["Hosts filtering"]
  node_apk_install["APK installation<br/>[install_apk.ps1]"]
  node_launcher_replace["Launcher replacement"]
  node_launcher_restore["Launcher restoration"]
  node_launcher_backup["Original launcher backup"]
end

subgraph group_host["Windows host operations"]
  node_host_cleanup["Windows ad cleanup<br/>[mumu_debloater.ps1]"]
end

node_user(("Operator"))
node_apk["APK file"]
node_signed_apk["Signed Lawnchair APK"]
node_mumu["MuMu Player"]
node_android_instance["Android VM"]
node_adb["MuMu ADB"]

node_user -->|"runs"| node_debloater
node_user -->|"runs"| node_apk_install
node_user -->|"runs"| node_launcher_replace
node_user -->|"runs"| node_launcher_restore
node_debloater -->|"uses shared discovery"| node_common
node_apk_install -->|"uses shared discovery"| node_common
node_launcher_replace -->|"uses shared discovery"| node_common
node_launcher_restore -->|"uses shared discovery"| node_common
node_common -->|"queries VM"| node_mumu
node_common -->|"discovers connection"| node_adb
node_debloater -->|"checks first"| node_input_check
node_debloater -->|"disables packages"| node_package_cleanup
node_debloater -->|"cleans hosts"| node_hosts
node_debloater -->|"cleans host data"| node_host_cleanup
node_package_cleanup -->|"changes packages"| node_android_instance
node_apk_install -->|"installs input"| node_apk
node_apk_install -->|"installs on"| node_android_instance
node_launcher_replace -->|"verifies and installs"| node_signed_apk
node_launcher_replace -->|"replaces launcher"| node_android_instance
node_launcher_restore -->|"uses per-instance backup"| node_launcher_backup
node_launcher_restore -->|"restores launcher"| node_android_instance
node_context_menu -->|"offers install action"| node_batch_entry
node_batch_entry -->|"preserves exit code"| node_apk_install
node_user -->|"registers"| node_context_menu

click node_common "https://github.com/schrodingers-neko/mumu-player-12-optimization/blob/main/mumu_common.ps1"
click node_debloater "https://github.com/schrodingers-neko/mumu-player-12-optimization/blob/main/mumu_debloater.ps1"
click node_input_check "https://github.com/schrodingers-neko/mumu-player-12-optimization/blob/main/mumu_debloater.ps1"
click node_package_cleanup "https://github.com/schrodingers-neko/mumu-player-12-optimization/blob/main/mumu_debloater.ps1"
click node_hosts "https://github.com/schrodingers-neko/mumu-player-12-optimization/blob/main/hosts"
click node_apk_install "https://github.com/schrodingers-neko/mumu-player-12-optimization/blob/main/install_apk.ps1"
click node_launcher_replace "https://github.com/schrodingers-neko/mumu-player-12-optimization/blob/main/replace_lawnchair.ps1"
click node_launcher_restore "https://github.com/schrodingers-neko/mumu-player-12-optimization/blob/main/restore_lawnchair.ps1"
click node_launcher_backup "https://github.com/schrodingers-neko/mumu-player-12-optimization/blob/main/restore_lawnchair.ps1"
click node_host_cleanup "https://github.com/schrodingers-neko/mumu-player-12-optimization/blob/main/mumu_debloater.ps1"
click node_context_menu "https://github.com/schrodingers-neko/mumu-player-12-optimization/blob/main/register_context_menu.reg"
click node_batch_entry "https://github.com/schrodingers-neko/mumu-player-12-optimization/blob/main/install_apk.bat"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_context_menu,node_batch_entry toneBlue
class node_common toneAmber
class node_debloater,node_input_check,node_package_cleanup,node_hosts,node_apk_install,node_launcher_replace,node_launcher_restore,node_launcher_backup toneMint
class node_host_cleanup toneRose
class node_user,node_apk,node_signed_apk,node_mumu,node_android_instance,node_adb toneIndigo
```

## Components

### User entry points

- [Explorer install entry](https://github.com/schrodingers-neko/mumu-player-12-optimization/blob/main/register_context_menu.reg): `register_context_menu.reg`
- [Batch install entry](https://github.com/schrodingers-neko/mumu-player-12-optimization/blob/main/install_apk.bat): `install_apk.bat`

### Shared connectivity

- [VM and ADB discovery](https://github.com/schrodingers-neko/mumu-player-12-optimization/blob/main/mumu_common.ps1): `mumu_common.ps1`

### Android operations

- [Debloat workflow](https://github.com/schrodingers-neko/mumu-player-12-optimization/blob/main/mumu_debloater.ps1): `mumu_debloater.ps1`
- [Keyboard validation](https://github.com/schrodingers-neko/mumu-player-12-optimization/blob/main/mumu_debloater.ps1): `mumu_debloater.ps1`
- [Android package cleanup](https://github.com/schrodingers-neko/mumu-player-12-optimization/blob/main/mumu_debloater.ps1): `mumu_debloater.ps1`
- [Hosts filtering](https://github.com/schrodingers-neko/mumu-player-12-optimization/blob/main/hosts): `hosts`
- [APK installation](https://github.com/schrodingers-neko/mumu-player-12-optimization/blob/main/install_apk.ps1): `install_apk.ps1`
- [Launcher replacement](https://github.com/schrodingers-neko/mumu-player-12-optimization/blob/main/replace_lawnchair.ps1): `replace_lawnchair.ps1`
- [Launcher restoration](https://github.com/schrodingers-neko/mumu-player-12-optimization/blob/main/restore_lawnchair.ps1): `restore_lawnchair.ps1`
- [Original launcher backup](https://github.com/schrodingers-neko/mumu-player-12-optimization/blob/main/restore_lawnchair.ps1): `restore_lawnchair.ps1`

### Windows host operations

- [Windows ad cleanup](https://github.com/schrodingers-neko/mumu-player-12-optimization/blob/main/mumu_debloater.ps1): `mumu_debloater.ps1`

### Other components

- **Operator**
- **APK file**
- **Signed Lawnchair APK**
- **MuMu Player**
- **Android VM**
- **MuMu ADB**

## Connections

- Operator → Debloat workflow: runs (evidence: `README.md`)
- Operator → APK installation: runs (evidence: `README.md`)
- Operator → Launcher replacement: runs (evidence: `README.md`)
- Operator → Launcher restoration: runs (evidence: `README.md`)
- Debloat workflow → VM and ADB discovery: uses shared discovery (evidence: `README.md`)
- APK installation → VM and ADB discovery: uses shared discovery (evidence: `README.md`)
- Launcher replacement → VM and ADB discovery: uses shared discovery (evidence: `README.md`)
- Launcher restoration → VM and ADB discovery: uses shared discovery (evidence: `README.md`)
- VM and ADB discovery → MuMu Player: queries VM (evidence: `README.md`)
- VM and ADB discovery → MuMu ADB: discovers connection (evidence: `README.md`)
- Debloat workflow → Keyboard validation: checks first (evidence: `README.md`)
- Debloat workflow → Android package cleanup: disables packages (evidence: `README.md`)
- Debloat workflow → Hosts filtering: cleans hosts (evidence: `README.md`)
- Debloat workflow → Windows ad cleanup: cleans host data (evidence: `README.md`)
- Android package cleanup → Android VM: changes packages (evidence: `README.md`)
- APK installation → APK file: installs input (evidence: `README.md`)
- APK installation → Android VM: installs on (evidence: `README.md`)
- Launcher replacement → Signed Lawnchair APK: verifies and installs (evidence: `README.md`)
- Launcher replacement → Android VM: replaces launcher (evidence: `README.md`)
- Launcher restoration → Original launcher backup: uses per-instance backup (evidence: `README.md`)
- Launcher restoration → Android VM: restores launcher (evidence: `README.md`)
- Explorer install entry → Batch install entry: offers install action (evidence: `README.md`)
- Batch install entry → APK installation: preserves exit code (evidence: `README.md`)
- Operator → Explorer install entry: registers (evidence: `README.md`)
