Getting Started

• Direct download: Click vc_redist.x64 to download and install
• winget installation: Right-click the Windows Start button, select "Command Prompt" or "PowerShell (Administrator)", then paste the following command in the terminal and press Enter:

  winget install Microsoft.VCRedist.2017.x64

• Self-download: Click .NET official download page , select the version suitable for your system to download and install.

  	Windows	macOS	Linux
  You need to download	.NET Desktop Runtime	.NET Runtime
  Installer	x64	dotnet-install.sh

• (Windows users only) winget installation: Right-click the Windows Start button, select "Command Prompt" or "PowerShell (Administrator)", then paste the following command in the terminal and press Enter:

  winget install Microsoft.DotNet.DesktopRuntime.8

• Your system needs to have Python version ≥ 3.10 installed. This is required for M9A to start and manage its internal environment.
• M9A will automatically create and use an independent virtual environment and install the required Python dependency packages (from requirements.txt) when it is run for the first time. You do not need to manually create a virtual environment or install these dependencies.

1. Click the Apple logo in the top-left corner of the screen.
2. Select "About This Mac".
3. In the window that appears, you can see the processor information.

• If using Intel X86 processor, please download M9A-macos-x86_64-vXXX.tar.gz
• If using Apple Silicon series such as M1, M2, etc. ARM architecture processors, please download M9A-macos-aarch64-vXXX.tar.gz

	Windows	macOS	Linux	Android
Reference Documentation	Windows Emulators	If your device has Apple Silicon, please refer to: Mac emulators running on Apple Silicon platform If your device has Intel chip: 1. Recommended to use Mac’s built-in multi-system to install Windows and refer to Windows section documentation 2. Refer to Mac emulators running on Intel platform	Linux Emulators and Containers	Android Physical Devices

1. Open terminal, extract the distributed archive:

   Option 1: Extract to system directory (requires administrator privileges)

   sudo mkdir -p /usr/local/bin/M9A
   sudo tar -xzf <downloaded M9A archive path> -C /usr/local/bin/M9A
   

   Option 2: Extract to user directory (recommended, no sudo required)

   mkdir -p ~/M9A
   tar -xzf <downloaded M9A archive path> -C ~/M9A
   

2. Enter the extraction directory and run the program:

   cd /usr/local/bin/M9A
   ./MaaPiCli
   

If you want to use the graphical interface, follow step 2 but execute MFAAvalonia instead of MaaPiCli.

⚠️Gatekeeper security prompt handling:

In macOS 10.15 (Catalina) and later, Gatekeeper may prevent unsigned applications from running.
If you encounter errors such as “Cannot open because the developer cannot be verified”, please choose one of the following solutions:

# Solution 1: Take MaaPiCli as an example to remove the quarantine attribute (recommended, subject to the actual path)
sudo xattr -rd com.apple.quarantine /usr/local/bin/M9A/MaaPiCli
# Or user directory version: xattr -rd com.apple.quarantine ~/M9A/MaaPiCli

# Solution 2: Add to Gatekeeper whitelist
sudo spctl --add /usr/local/bin/M9A/MaaPiCli
# Or user directory version: spctl --add ~/M9A/MaaPiCli

# Solution 3: Process the entire directory at once
sudo xattr -rd com.apple.quarantine /usr/local/bin/M9A/*
# Or user directory version: xattr -rd com.apple.quarantine ~/M9A/*

Resource Download Source
• Uses MirrorChyan by default.
• Users who haven't purchased MirrorChyan should change to GitHub.
CDK or Token
• Users updating through MirrorChyan should fill in CDK. About MirrorChyan
• Users updating through GitHub can fill in Token to improve GitHub API access rate limits. Token acquisition method 1 method 2

Software Path

• MuMu 12 Emulator Reference

	Path Format
MuMu 12 Emulator Below 5.0	{Installation Directory}\shell\MuMuPlayer.exe
MuMu 12 Emulator 5.0 and above	{Installation Directory}\nx_device\12.0\shell\MuMuNxDevice.exe

Additional Commands

• X is the multi-instance number

	Parameter Format	Example
MuMu Emulator	-v X	-v 0
LDPlayer	index=X	index=0

MuMu Emulator Automatic Path Acquisition Method
1. Ensure there is a emulator shortcut with 1999 application installed on the desktop.
2. Click the icon to the right of the Software Path input box to enter the file selection interface, select the 1999 shortcut on the desktop, and the path will be automatically filled in.

• You need to select the 1999 server installed in the emulator.
• Currently supports: Official Server, Bilibili Server, International Server (EN), International Server (JP), OPPO Server, Xiaomi Server, QQ Server.

Current Controller
• Shows the currently connected ADB controller (emulator and ADB address).
Interface Button Descriptions
• Click Custom: Modify ADB parameters (generally no manual modification required).
• Click Refresh: Re-detect all running emulators.
• Connection Status: Green indicates connected.

• The checkbox before the task name is used to enable/disable tasks
• Right-clicking the checkbox will execute that task once
• Click the add task button in the upper right corner to add tasks not visible in the current list or repeatedly add existing tasks
• Click the button to the right of the task to view Task Settings and Task Description
• Drag task names to adjust task order

{
    "enable_pip_install": true,  // Whether to enable pip installation, default true, recommended to enable
    "last_version": "v3.2.0",  // Version of interface.json read when pip installation is completed, compared with version at startup, tries to install if different
    "mirror": "https://mirrors.ustc.edu.cn/pypi/simple", // Mirror source. Parameters after pip install -i, can be filled according to personal needs. Note that users outside mainland China should modify the value to ""
    "backup_mirrors": [
    "https://pypi.tuna.tsinghua.edu.cn/simple",
    "https://mirrors.cloud.tencent.com/pypi/simple/",
    "https://pypi.org/simple"
    ]  // Backup mirror sources
}