“ldconsole Command-Line Reference for LDPlayer Developers”
`ldconsole.exe` lets you list, create, copy, configure, control, and back up LDPlayer instances from the Windows command line. This reference covers common commands for LDPlayer 14 and LDPlayer 9. It marks the commands that the publisher li
Before You Start
Prerequisites: LDPlayer 14 or LDPlayer 9 installed. If a command fails, update to the latest build of that version.; Command Prompt opened in the emulator's installation folder, for example `E:LDPlayerLDPlayer14`.; Windows backslashes in path parameters, such as `C:Users...`. Forward slashes may be parsed incorrectly.
Step-by-Step
- Open Command Prompt in the folder that contains `ldconsole.exe`.
- Run `ldconsole.exe list` to print the name of each instance.
- Add `--index <number>` or `--name <name>` to any command that targets one instance.
- Run the command you need. The sections below list the options.
## Overview ldconsole.exe lets you list, create, copy, configure, control, and back up LDPlayer instances from the Windows command line. This reference covers common commands for LDPlayer 14 and LDPlayer 9. It marks the commands that the publisher lists as unavailable, and it notes where the publisher’s documentation conflicts with itself. An instance is one running Android environment in LDPlayer.
## Command reference
Get instance information
| Command | Returns | | — | — | | list | Instance names, listed on separate lines | | list2 | Index, title, top window handle, bound handle, running status (1 or 0), process ID, VirtualBox process ID, width, height, and DPI | | list3 --index <number> | Index, name, status, width, height, and DPI for one instance | | runninglist | Running instances only | | isrunning --index <number> | Running status of one instance |
If list3 runs without a valid index, it returns a placeholder entry numbered 99999 that represents the desktop, not an instance. Use list or list2 to see all instances.
Create, copy, rename, and remove
ldconsole.exe add --name <name>creates an instance. The name is optional.ldconsole.exe copy --name <new_name> --from <source>clones an instance. The source can be an index or a name.ldconsole.exe rename --index <number> --title <new_title>changes the display name.ldconsole.exe remove --index <number>deletes the instance, including its data and settings. This cannot be undone.
Back up and restore
ldconsole.exe backup --index <number> --file "D:\backup\LDPlayer.ldbk"saves the whole instance image. The file name must end in.ldbk. Large instances take a long time.ldconsole.exe restore --index <number> --file "D:\backup\LDPlayer.ldbk"restores a backup to an instance.
Launch, quit, and windows
launch,quit,quitall, andreboottake--indexor--name, exceptquitall.sortWndarranges all emulator windows.ldconsole.exe locate --index <number> --LL 116.39,39.91sets a GPS location. The publisher uses both--LLand--LLIfor this flag. See the notes.
Application control
| Command | Parameter | Action | | — | — | — | | installapp | --filename or --packagename | Installs an app | | uninstallapp | --packagename | Removes an app | | runapp | --packagename | Opens an app | | killapp | --packagename | Closes an app | | launchex | --packagename | Starts the instance and opens the app in one step |
Example: ldconsole.exe installapp --index 0 --filename "D:\apps\game.apk"
Device actions
Use action to send device events to an instance.
| --key | --value | Effect | | — | — | — | | call.keyboard | back, home, menu, volumeup, or volumedown | Sends one key press. Send one key at a time. | | call.input | Text | Types text into the focused field | | call.locate | longitude,latitude | Sends a location | | call.network | offline or connect | Turns the network off or on | | call.gravity | Sensor values | Sends gravity or gyroscope values |
rock --index <number> triggers the shake action.
Example: ldconsole.exe action --index 0 --key call.keyboard --value home
Configure an instance
Use modify to change settings. Options include --resolution w,h,dpi, --cpu 1|2|3|4, --memory (256, 512, 768, 1024, 1536, 2048, 4096, or 8192), --manufacturer, --model, --pnumber, --imei, --imsi, --simserial, --androidid, --mac, --autorotate 1|0, --lockwindow 1|0, and --root 1|0.
Example: ldconsole.exe modify --index 0 --cpu 2 --memory 2048 --autorotate 1
Commands marked unavailable
The publisher lists these as temporarily unavailable: downcpu, scan, zoomIn and zoomOut, push and pull, backupapp and restoreapp, operate*, globalsetting, and menu mapping. Do not rely on them until they work on your version.
ADB access
LDPlayer registers ADB connections automatically. You can use the system adb or the bundled adb directly. The publisher gives two port formulas: 5554 plus index times 2 in one place, and 5555 plus index times 2 in another. Its example connects to 127.0.0.1:5567 for index 6, which matches the 5555 formula. Run adb devices to confirm the port before you script against it.
Security note:
modify --root 1turns on root access for the instance. Root access lets apps and scripts change system files on the virtual device. Enable it only when a task requires it. To revert, runldconsole.exe modify --index <number> --root 0, then check the setting in LDPlayer.
## Verify Run ldconsole.exe list. The instance you added should appear in the output.
## Notes and Troubleshooting
removepermanently deletes the instance’s data and settings. Back up the instance first.- Most
modifychanges apply after you quit and launch the instance. - The publisher uses
--LLand--LLIfor thelocateflag. Check the output ofldconsole.exe locateon your version before you script it. - If a command is missing from your version, install the latest build of LDPlayer from the official website.
## Related