LD플레이어 ldconsole.exe 명령어 사용 가이드

LD플레이어를 사용하다 보면 단순히 프로그램을 실행하고 게임을 플레이하는 것뿐만 아니라, 여러 개의 인스턴스를 한 번에 관리하거나 APK 설치, 실행 및 종료, 설정 변경, 백업·복원 등의 작업을 자동화해야 하는 경우가 있습니다.

이럴 때 활용할 수 있는 기능이 바로 ldconsole.exe 명령어입니다.

ldconsole은 LD플레이어에 포함되어 있는 Windows용 명령줄 도구로, 명령 프롬프트(CMD)를 이용해 에뮬레이터의 생성부터 삭제, 실행, 종료, 설정 변경, 앱 관리, ADB 연결 등을 제어할 수 있습니다.

특히 LD플레이어를 여러 개 사용하는 사용자나 개발자, 테스트 환경을 구성하는 사용자라면 알아두면 유용한 기능이 많은데요. 이번 글에서는 LD플레이어 9 및 LD플레이어 14를 기준으로 자주 사용하는 ldconsole 명령어와 사용 방법을 하나씩 정리해 보겠습니다.

1. 사용하기 전에 알아둘 사항

먼저 ldconsole.exe는 LD플레이어가 설치된 폴더에서 찾을 수 있습니다.

예를 들어 LD플레이어가 H:\LDPlayer\LDPlayer14에 설치되어 있다면 다음과 같은 경로에 있습니다.

H:\LDPlayer\LDPlayer14\ldconsole.exe

기본적인 명령어 형식은 다음과 같습니다.

ldconsole <command> [parameter]

대부분의 인스턴스 관련 명령어는 --index 또는 --name을 이용해 원하는 인스턴스를 지정할 수 있습니다.

--index <인덱스>
--name <인스턴스 이름>

예를 들어 0번 인스턴스를 지정하려면 다음과 같이 입력합니다.

ldconsole.exe launch --index 0

ADB 포트 계산 방법

멀티 인스턴스를 사용하는 경우 ADB 포트는 다음 공식으로 계산할 수 있습니다.

ADB 포트 = 5554 + index × 2

따라서 인스턴스 번호가 0이면 5554, 1이면 5556, 6이면 5566 포트를 사용합니다.

또한 ldconsole은 Windows 프로그램이므로 --file, --local 등 경로를 입력하는 옵션에서는 Windows 방식의 역슬래시(\)를 사용하는 것이 좋습니다. 한글 Windows에서는 \가 화면에 ₩(원화 기호)처럼 보일 수 있습니다.

예:

D:\backup\LDPlayer.ldbk
D:₩backup₩LDPlayer.ldbk

현재 기준으로 LD플레이어 9 및 LD플레이어 14에서 사용할 수 있으며, 명령어가 정상적으로 동작하지 않는 경우 최신 버전으로 업데이트한 후 다시 시도하는 것을 권장합니다.

2. LD플레이어 인스턴스 정보 확인하기

먼저 현재 생성되어 있는 LD플레이어의 목록과 실행 상태를 확인할 수 있습니다.

주요 명령어

예를 들어 다음과 같이 사용할 수 있습니다.

ldconsole.exe list
ldconsole.exe list2
ldconsole.exe list3 --index 0
ldconsole.exe runninglist
ldconsole.exe isrunning --index 6

list2를 사용하면 인스턴스의 인덱스, 이름, 실행 상태, 프로세스 PID, 해상도, DPI 등의 상세 정보를 확인할 수 있습니다.

참고로 list3에서 --index를 잘못 입력하면 실제 LD플레이어가 아닌 컴퓨터 바탕화면을 의미하는 99999 항목이 표시될 수 있습니다.

따라서 전체 인스턴스를 확인할 때는 list 또는 list2를 사용하는 것이 좋습니다.

3. 새로운 LD플레이어 만들기

add 명령어를 사용하면 새로운 LD플레이어 인스턴스를 생성할 수 있습니다.

ldconsole.exe add

이름을 직접 지정하고 싶다면 --name 옵션을 추가합니다.

ldconsole.exe add --name 이름

예시:

ldconsole.exe add
ldconsole.exe add --name 테스트A

이렇게 생성된 인스턴스에는 시스템에서 자동으로 새로운 인덱스가 할당됩니다.

4. LD플레이어 인스턴스 복사하기

기존 인스턴스를 그대로 복제해 새로운 멀티 인스턴스를 만들 수도 있습니다.

기본 형식은 다음과 같습니다.

ldconsole.exe copy --name <새 이름> --from <원본 이름 또는 인스턴스 번호>

예를 들어 0번 인스턴스를 복사하려면:

ldconsole.exe copy --name 새분신 --from 0

이름으로 원본을 지정하는 것도 가능합니다.

ldconsole.exe copy --name 새분신 --from LDPlayer

멀티 인스턴스를 여러 개 만들어야 할 때 유용하게 사용할 수 있습니다.

5. LD플레이어 인스턴스 삭제하기

더 이상 사용하지 않는 인스턴스는 remove 명령어로 삭제할 수 있습니다.

인덱스로 삭제:

ldconsole.exe remove --index 인스턴스 번호

이름으로 삭제:

ldconsole.exe remove --name 이름

예를 들어:

ldconsole.exe remove --index 2
ldconsole.exe remove --name 테스트A

주의: 인스턴스를 삭제하면 해당 인스턴스에 저장된 데이터와 설정도 함께 삭제됩니다. 중요한 데이터가 있다면 삭제하기 전에 반드시 백업하는 것을 권장합니다.

6. LD플레이어 이름 변경하기

rename 명령어를 이용하면 기존 인스턴스의 표시 이름을 변경할 수 있습니다.

ldconsole.exe rename --index 인스턴스 번호--title 새 이름

또는 이름으로 지정할 수도 있습니다.

ldconsole.exe rename --name 현재 인스턴스 이름 --title 새 이름

사용 예시:

ldconsole.exe rename --index 0 --title 메인플레이어
ldconsole.exe rename --name LDPlayer --title 테스트용

여러 개의 인스턴스를 사용하는 경우 계정이나 용도에 맞춰 이름을 변경해 두면 관리하기 편리합니다.

7. LD플레이어 백업하기

backup 명령어를 이용하면 특정 인스턴스를 통째로 백업할 수 있습니다.

ldconsole.exe backup --index 인스턴스 번호 --file "D:₩backup₩LDPlayer.ldbk"

이름으로 지정하는 경우:

ldconsole.exe backup --name 인스턴스 이름 --file "D:₩backup₩테스트A.ldbk"

백업 파일의 확장자는 .ldbk를 사용해야 합니다.

예:

ldconsole.exe backup --index 0 --file "D:₩backup₩LDPlayer.ldbk"
ldconsole.exe backup --name 테스트A --file "D:₩backup₩테스트A.ldbk"

백업에는 시스템과 사용자 데이터 등이 포함되어 있어 용량이 큰 인스턴스일수록 백업에 시간이 오래 걸릴 수 있습니다.

8. 백업한 LD플레이어 복원하기

앞에서 만든 .ldbk 백업 파일은 restore 명령어를 이용해 복원할 수 있습니다.

ldconsole.exe restore --index 인스턴스 번호 --file "D:₩backup₩LDPlayer.ldbk"

이름으로 지정하는 경우:

ldconsole.exe restore --iname 인스턴스 이름 --file "D:₩backup₩LDPlayer.ldbk"

예를 들어:

ldconsole.exe restore --index 0 --file "D:₩backup₩LDPlayer.ldbk"
ldconsole.exe restore --name 테스트A --file "D:₩backup₩LDPlayer.ldbk" 

백업 파일을 이용하면 기존 환경을 다른 인스턴스나 환경으로 옮길 때 편리하게 사용할 수 있습니다.

9. LD플레이어 실행 및 종료하기

가장 자주 사용하는 명령어 중 하나가 바로 인스턴스 실행과 종료입니다.

실행

ldconsole.exe launch --index 0
ldconsole.exe launch --name LDPlayer 

종료

ldconsole.exe quit --index 0
ldconsole.exe quit --name LDPlayer 

모든 인스턴스 종료

ldconsole.exe quitall

재부팅

ldconsole.exe reboot --index 0
ldconsole.exe reboot --name LDPlayer 

즉, 기본적인 인스턴스 제어는 다음과 같이 정리할 수 있습니다.

10. GPS 위치 및 창 정렬 설정하기

ldconsole을 이용하면 LD플레이어의 GPS 위치를 지정하거나 여러 개의 창을 자동으로 정렬할 수도 있습니다.

GPS 위치 지정

ldconsole.exe locate --index 인스턴스 번호 --LLI 경도,위도
ldconsole.exe locate --name 인스턴스 이름  --LLI 경도,위도

아래 예시는 경도와 위도를 이용해 위치를 지정하는 방식입니다.

ldconsole.exe locate --index 0 --LLI 116.39,39.91
ldconsole.exe locate --name LDPlayer --LLI 116.39,39.91 

창 자동 정렬

여러 개의 LD플레이어를 동시에 실행하고 있다면 sortWnd를 사용해 창을 자동으로 정렬할 수 있습니다.

ldconsole.exe sortWnd

멀티 인스턴스를 많이 사용하는 환경에서 특히 편리한 기능입니다.

11. APK 설치 및 앱 실행하기

ldconsole을 사용하면 특정 LD플레이어에 APK를 설치하거나 설치된 앱을 실행하고 종료할 수 있습니다.

APK 설치

ldconsole.exe installapp --index 인스턴스 번호 --filename <apk 저장 위치>
ldconsole.exe installapp --index 인스턴스 번호 --packagename <apk 패키지 네임>
ldconsole.exe installapp --name 인스턴스 이름 --filename "<apk 저장 위치>"
ldconsole.exe installapp --name 인스턴스 이름 --packagename "<apk 패키지 네임>"

앱 삭제

ldconsole.exe uninstallapp --index 0 --packagename com.example.game
ldconsole.exe uninstallapp --name LDPlayer --packagename com.example.game 

앱 실행

ldconsole.exe runapp --index 0 --packagename com.example.game
ldconsole.exe runapp --name LDPlayer --packagename com.example.game 

앱 종료

ldconsole.exe killapp --index 0 --packagename com.example.game
ldconsole.exe killapp --name LDPlayer --packagename com.example.game 

LD플레이어 실행 + 앱 실행

launchex를 사용하면 LD플레이어를 실행한 뒤 지정한 앱까지 한 번에 실행할 수 있습니다.

ldconsole.exe launchex --index 0 --packagename com.example.game
ldconsole.exe launchex --name LDPlayer --packagename com.example.game 

즉, 여러 게임이나 앱을 자동으로 실행해야 하는 경우 launchex를 활용하면 편리합니다.

12. 시스템 버튼 및 기기 동작 제어하기

홈 버튼

ldconsole.exe action --index 0 --key call.keyboard --value home

뒤로가기

ldconsole.exe action --index 0 --key call.keyboard --value back

볼륨 올리기

ldconsole.exe action --index 0 --key call.keyboard --value volumeup

볼륨 내리기

ldconsole.exe action --index 0 --key call.keyboard --value volumedown

텍스트 입력

현재 선택된 입력창에 텍스트를 입력할 수도 있습니다.

ldconsole.exe action --index 0 --key call.input --value "텍스트"

흔들기

ldconsole.exe rock --index 0

네트워크 차단 및 복구

ldconsole.exe action --index 0 --key call.network --value offline

네트워크를 다시 연결하려면:

ldconsole.exe action --index 0 --key call.network --value connect

이외에도 중력 센서 등의 동작을 명령어를 통해 전달할 수 있습니다.

ldconsole.exe action --index 0 --key call.gravity --value x,y,z

13. LD플레이어 성능 및 기기 정보 설정하기

modify 명령어를 사용하면 특정 인스턴스의 하드웨어 및 기기 정보를 변경할 수 있습니다.

기본적인 형태는 다음과 같습니다.

ldconsole.exe modify [--name|--index] [옵션]

주요 옵션은 다음과 같습니다.

예를 들어 다음과 같이 설정할 수 있습니다.

ldconsole.exe modify --index 0 --resolution 1080,1920,480 --cpu 4 --memory 4096 --imei auto --mac auto --root 0

여기서 --cpu 4는 CPU 4코어, --memory 4096은 4096MB 메모리를 의미합니다.

또한 --imei auto, --mac auto처럼 auto를 지정하면 해당 기기 식별 정보가 새롭게 생성됩니다.

설정을 변경한 후에는 적용을 위해 인스턴스를 종료했다가 다시 실행해야 할 수 있습니다.

ldconsole.exe quit --index 0
ldconsole.exe launch --index 0

14. ADB와 함께 사용하기

LD플레이어는 ldconsole뿐만 아니라 ADB(Android Debug Bridge)를 이용한 제어도 지원합니다.

LD플레이어에서는 ADB 연결이 기본적으로 자동 등록되기 때문에 시스템에 설치된 ADB 또는 LD플레이어에 포함된 ADB를 이용해 각 인스턴스에 직접 연결할 수 있습니다.

ADB 포트는 다음과 같이 계산합니다.

ADB 포트 = 5554 + index × 2

예를 들어 6번 인스턴스라면:

5554 + 6 × 2 = 5566

따라서 다음과 같이 연결할 수 있습니다.

adb connect 127.0.0.1:5566

현재 ADB 연결 상태를 확인하려면:

adb devices

명령어를 사용할 수 있습니다.

ADB를 함께 활용하면 앱 설치, 앱 실행, 로그 확인, 파일 및 시스템 명령어 실행 등 더욱 세밀한 자동화가 가능합니다.

15. 현재 사용할 수 없는 기능

일부 ldconsole 기능은 현재 버전에서 아직 사용할 수 없으며, 추후 업데이트를 통해 지원될 예정입니다.

현재 사용이 제한되는 주요 기능은 다음과 같습니다.

• downcpu — CPU 제한
• globalsetting — 글로벌 기본 설정
• scan — QR 코드 스캔
• zoomIn / zoomOut — 창 크기 조절
• push / pull — 파일 전송
• backupapp / restoreapp — 앱 데이터 백업 및 복원
• operate* — 녹화 매크로

따라서 위 명령어가 정상적으로 동작하지 않는 경우에는 명령어를 잘못 입력한 것이 아니라 현재 버전에서 해당 기능이 지원되지 않는 것일 수도 있습니다.

마무리

지금까지 ldconsole.exe를 이용해 LD플레이어 인스턴스 확인, 생성, 복사, 삭제, 이름 변경, 백업 및 복원, 실행·종료, 앱 설치 및 실행, GPS 설정, 기기 설정, ADB 연결까지 다양한 기능을 살펴봤습니다.

특히 여러 개의 LD플레이어를 동시에 사용하는 경우 ldconsole을 활용하면 마우스로 하나씩 조작하지 않고 CMD 명령어를 통해 반복적인 작업을 자동화할 수 있다는 장점이 있습니다.

예를 들어 새로운 인스턴스를 생성하고, APK를 설치한 뒤, 앱을 실행하는 작업을 명령어로 순서대로 처리하는 방식으로 활용할 수 있습니다.

다만 ldconsole의 일부 기능은 버전에 따라 지원 여부가 달라질 수 있으므로, 명령어가 정상적으로 동작하지 않는다면 LD플레이어를 최신 버전으로 업데이트한 후 다시 확인하는 것을 권장합니다.