mumu-manager-cli

MuMuManager CLI

Purpose

Use command-line to query and manage instances and app configurations of MuMu Emulator 12, suitable for scenarios such as account matrices, batch power on/off, automation scripts, operations troubleshooting, etc.

Prerequisites

• Ensure the emulator version is V4.0.0.3179 or above, otherwise some commands are unavailable.
• Locate MuMuManager.exe, common paths:X:\Program Files\Netease\MuMuPlayer-12.0\shell\MuMuManager.exe; local path example:C:\Program Files\Netease\MuMu\nx_main\MuMuManager.exe。
• It is recommended to use absolute paths, or add the nx_main directory to PATH。

Usage Flow

1. First use info to confirm available instances;-v supports comma-separated lists or all。
2. Select the needed tasks (create/clone/delete/rename/import/export/ADB/app/control/settings).
3. Minimize the scope of impact as much as possible, and be cautious when performing write operations on all .

Feature Quick Reference

Instance Management

• info View instance status and field descriptions
• create / clone / delete / rename Create/clone/delete/rename instances
• import / export Back up and restore .mumudata(optional --zip）

Common Pitfalls and Avoidance

• Before deleting an instance, close it first:control -v <index> shutdown. If not closed, it may return {"errcode": -1, "errmsg": "not handle cmd"}。

Startup and Window Control

• control launch / shutdown / restart Start/shut down/restart instances
• control show_window / hide_window / layout_window Show/hide/layout windows

App Management

• control app install / uninstall / launch / close / info Use package name or apk path
• control app info -i View installed apps and the current foreground app

System Tools

• control tool func Common functions (screenshot, refresh, home, settings, security, etc.)
• control tool downcpu Reduce CPU
• control tool location / gyro Virtual location and gravity sensing
• control shortcut create / delete Create/delete desktop shortcuts

Device Configuration and Emulation

• setting Read/modify configuration, supports --all / --all_writable / --info / --path
• simulation Modify emulation properties (IMEI/IMSI/Android ID/MAC, etc.)

ADB Commands

• adb -c Common shortcut commands (clear cache/screenshot/screen recording, etc.)
• adb -c "shell ..." Execute custom shell commands

Other

• sort Auto-arrange windows
• driver install / uninstall -n lwf Install/uninstall drivers (may require administrator privileges)
• Auxiliary interface api Use only when necessary; stability depends on version

Reference

• See references/mumu-manager-cli.md
• Quick keyword search:
  • control app App Management
  • setting Configuration items and JSON modification
  • simulation Emulation properties
  • adb ADB commands
  • driver Driver management