Introduction
Tutorials
FAQ
Blog
Game
Application
Support
How to use developer support function?
Updated: 2024-06-03

MuMuPlayer Pro can assist developers in application development and debugging. We currently supports managing the Android Device through Command-Line Tool (please update to the latest version). You can refer to the following documentation to make the most of the MuMuPlayer Pro!

 

Table of Contents:

1.Where to find Command-Line Tool

2.How to use Command-Line Tool

(1) Get the server port of MuMuPlayer Pro

(2) Get info of the Android Device

(3) Create an Android Device

(4) Clone/Delete/Open/Close/Restart the Android Device

(5) Config the Android Device

(6) Control the Android Device

 

1.Where to find Command-Line Tool
(1)Open MuMuPlayer Pro.
(2)Click on the top menu bar "MuMuPlayer Pro".
(3)Click on "Open Command-Line Tool".
In the Command-Line Tool window, you can input and execute commands.

 


2.How to use Command-Line Tool

 

(1) Get the server port of MuMuPlayer Pro
         · Command:
                 ./mumutool  port 
         · Tips:
                 If the server port of MuMuPlayer Pro cannot be obtained, then all the following functions will be unavailable.

 

(2) Get info of the Android Device
         · Command:
                 ./mumutool  info  <device>
         · Parameters:
                 <device>: Select the Android Device.
         · Example:
                 ./mumutool  info 0        Get info of NO.0 Android Device
                 ./mumutool  info  0,2        Get info of NO.0 and NO.2 Android Device
                 ./mumutool  info all        Get info of all Android Devices

 

(3) Create an Android Device
         · Command:
                 ./mumutool  create  [--type <type>] [--setting <setting>]
         · Parameters:
                 <type>: Select the type of Android Device to create.(values: tablet, phone)
                 <setting>: Select the updated config for the Android Device.
         · Example:
                 ./mumutool  create  --type  phone         Create an Android Device of a phone type
                 ./mumutool  create  --setting  '{"vmCpuCount":1,"vmMemoryOfMB":1024}'          Create an Android Device of 1 Core, 1GB
                 ./mumutool  create  --setting  /path/file.json          Create an Android Device by configuring a json file

 


* Config Tips:
                 Boss Key: "bossKeyEnable" : true

                Customized ADB Port: "customAdbPort" : 16384,
                 Notch Display:"displayCutout" : 0, 
                 Dynamic Frame Rate: "dynamicFpsEnable" : false 
                 When MuMuPlayer Pro is running in the background, it will automatically reduce the frame rate to : "dynamicFpsLimitToLow" : 15 
                 Confirmation when exit: "exitConfirmEnable" : true
                 FPS Counter: "fpsShowEnable" : false
                 GPU Fast Math: "gpuFastMathEnable" : false
                 GPU Model: "Adreno (TM) 640"
                 Device MAC Addresses: "macAddress" : "92:79:16:57:58:12"
                 Maximum Frame Rate(values: 30, 60, Frame Rate set by the monitor): "maxFpsLimit" : 144
                 Brand: "phonePropBrand" : "Redmi"
                 IMEI: "phonePropIMEI" : "869874032137430"
                 Model: "phonePropMiit" : "23078RKD5C"
                 Name: "phonePropModel" : "K60 Ultra"
                 Graphics Enhancement: "renderQualityEnable" : false
                 DPI: "resolutionDPI" : 240
                 Display Size: "resolutionWidthHeight" : "1600x900"
                 Android Device id: "simulationProps" : "android_id=123456"
                 System Disk Mode: "systemWritable" : false
                 MuMu Mouse Cursor Style: "trackCursorEnable" : false
                 ADB: "usingNormalADBPort" : true 
                 Handle Vibration Amplitude: "vibrationAmplitude" : 0.59999999999999998
                 Handle Vibration Duration Correction: 0 
                 Handle Vibration Duration Ratio: 0.80000000000000004 
                 CPU: "vmCpuCount" : 3 
                 Memory: "vmMemoryOfMB" : 3072 
                 Device Name: "vmName" : "Android Device"
                 Root Access: "vmRootEnable" : false 
                 Auto Window Rotation: "windowAutoRotationEnable" : true 
                 Custom ADB Port number:"customAdbPort":12345
         Tips:
                 Some changes will take effects on the next launch.

 

*Detailed information in file.json:
                 {
                 "bossKeyEnable" : true,

                 "customAdbPort" : 16384,
                 "displayCutout" : 0,
                 "dynamicFpsEnable" : false,
                 "dynamicFpsLimitToLow" : 15,
                 "exitConfirmEnable" : true,
                 "fpsShowEnable" : false,
                 "gpuFastMathEnable" : false,
                 "maxFpsLimit" : 144,
                 "phonePropBrand" : "Redmi",
                 "phonePropIMEI" : "869874032137430",
                 "phonePropMiit" : "23078RKD5C",
                 "phonePropModel" : "K60 Ultra",
                 "renderQualityEnable" : false,
                 "resolutionDPI" : 240,
                 "resolutionWidthHeight" : "1600x900",
                 "systemWritable" : false,
                 "trackCursorEnable" : false,
                 "usingNormalADBPort" : true,
                 "vmCpuCount" : 3,
                 "vmMemoryOfMB" : 3072,
                 "vmName" : "Android Device",
                 "vmRootEnable" : false,
                 "windowAutoRotationEnable" : true
                 "customAdbPort":12345
                 }

 

(4) Clone/Delete/Open/Close/Restart the Android Device
         · Command:
                 Clone: ./mumutool clone <device>
                 Delete: ./mumutool delete <device>
                 Open: ./mumutool open <device>
                 Close: ./mumutool close <device>
                 Restart: ./mumutool restart <device>
         · Parameters:
                  <device>: Select the Android Device.
         · Example:
                 ./mumutool  clone 0        Clone NO.0 Android Device
                 ./mumutool  delete  0,2        Delete NO.0 and NO.2 Android Device
                 ./mumutool  open all        Open all Android Devices
                 ./mumutool  close 0        Close NO.0 Android Device

 

(5) Config the Android Device
         · Command:
                 ./mumutool config <device> [--setting <setting>]
         · Parameters:
                 <device>: Select the Android Device.
                 <setting>: Select the updated config for the Android Device.
         · Example:
                 ./mumutool  config  0  --setting '{"vmCpuCount":1,"vmMemoryOfMB":1024}'         Config the setting of NO.0 Android Device to 1 Core, 1 GB
                 ./mumutool  config  0,2  --setting  /path/file.json         Config the setting of NO.0 and NO.2 Android Device by configuring a json file


         · Tips:
                For "Config Tips"and"Detailed information in file.json", you can refer to "(3) Create an Android Device".

 

(6) Control the Android Device
①About the App
         · Command:
                 ./mumutool control <device> [--action <action>] [--package <package>] [--path <path>] 
         · Parameters:
                 <device>: Select the Android Device.
                 <action>: Select the action to triggered by the Android Device. (values: open_app, close_app, install_apk, uninstall_app, app_status)
                 <package>: Select the android package bundle ID by the Android Device. Required for actions: open_app, close_app, uninstall_app, app_status.
                 <path>: Select apk/apks/xapk file path to install by the Android Device. Required for actions: install_apk.
         · Example:
                 ./mumutool control  0,2 --action  install_apk  --path  /path/QooApp.apk        Install apk for NO.0 and NO.2 Android Device
                 ./mumutool control  0 --action  open_app  --package  com.qooapp.qoohelper        Open apk for NO.0 Android Device
                 ./mumutool control  0 --action  close_app  --package  com.qooapp.qoohelper         Close apk for NO.0 Android Device
                 ./mumutool control  0 --action  uninstall_app  --package  com.qooapp.qoohelper        Uninstall apk for NO.0 Android Device
                 ./mumutool control  0 --action  app_status  --package  com.qooapp.qoohelper        App status in NO.0 Android Device
         · Tips:
                 You need to run the corresponding emulator for your command to take effect.

 

②About Tools
         · Command:
                 ./mumutool control <device> [--action <action>] [--type <type>] 
         · Parameters:
                 <device>: Select the Android Device.
                 <action>: run_tool
                 <type>:  Select the toolbar type for the Android Device. required for actions: run_tool. (values: goBack, goHome, showActivity,showVolumePanel, addVolume, reduceVolume, muteVolume, rotation, shake)
         · Example:
                 ./mumutool control  0 --action run_tool --type  goBack        Activate "Go Back" on NO.0 Android Device
                 ./mumutool control  0 --action run_tool --type  goHome        Activate "Go Home" on NO.0 Android Device
                 ./mumutool control  0 --action run_tool --type  showActivity        Activate "Open recent Apps" on NO.0 Android Device
                 ./mumutool control  0 --action run_tool --type  showVolumePanel        Show Volume on NO.0 Android Device
                 ./mumutool control  0 --action run_tool --type  addVolume        Increase volume by 1 on NO.0 Android Device
                 ./mumutool control  0 --action run_tool --type  reduceVolume        Decrease volume by 1 on NO.0 Android Device
                 ./mumutool control  0 --action run_tool --type  muteVolume         Turn on/off mute button on NO.0 Android Device
                 ./mumutool control  0 --action run_tool --type  rotation         Change the window rotation on NO.0 Android Device
                 ./mumutool control  0 --action run_tool --type  shake        Activate "Shake" on NO.0 Android Device


         · Tips:
                 You need to run the corresponding emulator for your command to take effect.

 

③About CMD
         · Command:
                 ./mumutool control <device> [--action <action>]  [--cmd <cmd>]
         · Parameters:
                 <device>: Select the Android Device.
                 <action>: run_tool
                 <cmd>:  Select command to run by the Android Device. required for actions: run_cmd.
         · Example:
                 ./mumutool control  0 --action run_cmd  --cmd "input tap 300 400"        run CMD on NO.0 Android Device

 

④ About Device Storage (import/export/move your Android Device)
· Import your Android Device
         · Command:
                 ./mumutool import [--count <count>] [--path <path>]
         · Parameters:
                 <count>: Select one or more /path/file.mad file path to import the Android Device.
                 <path>: Select /path/file.mad file path to import the Android Device.
         · Example:
                 ./mumutool import  --count  1   --path  /path/file1.mad  --path  /path/file2.mad      Use file1.mad、file2.mad files to import your Android Device by link
                 ./mumutool import  --count  2   --path  /path/file.mad       Use file.mad file to import your Android Device by copying
         · Tips:
                 count=1, mad file will be added to import.(default)
                 count>=2, mad file will be cloned to import.

 

· Export your Android Device
         · Command:
                 ./mumutool export <device> [--dir <dir>]
         · Parameters:
                 <device>: Select the Android Device.
                 <dir>: File Directory.
         · Example:
                 ./mumutool  export  0  --dir /path/       Export NO.0 Android Device to a specified directory
                 ./mumutool  export  0,2  --dir /path/       Export NO.0 and NO.2 Android Device to a specified directory
                 ./mumutool  export  all  --dir /path/       Export All Android Devices to a specified directory

 

· Move your Android Device
         · Command:
                 ./mumutool move <device> [--dir <dir>]
         · Parameters:
                 <device>: Select the Android Device.
                 <dir>: File Directory.
         · Example:
                 ./mumutool  move  0 --dir /path/       Move NO.0 Android Device to a specified directory
                 ./mumutool  move  0,2 --dir /path/        Move NO.0 and NO.2 Android Device to a specified directory
                 ./mumutool  move  all --dir /path/       Move All Android Devices to a specified directory

 

⑤ About Device Display (Show/Hide your Android Devices)
· Show all your Android Devices
         · Command:
                 ./mumutool show

· Hide all your Android Devices
         · Command:
                 ./mumutool hide

 

Should you have any other questions,please feel free to contact us for feedback!

Keywords: