# DX Manager 한국어 사용 설명서

## 1. 준비 사항

### PC

- 64비트 Windows 7 SP1, 8.1, 10 또는 11(32비트 Windows는 지원하지 않음)
- .NET Framework 4.6.2 이상
- Windows 7/8.1: 번들 레거시 ADB에 필요한 Universal CRT 업데이트
- 압축을 해제할 수 있는 충분한 저장 공간
- 실행 파일 옆에 설정·로그·스크린샷을 저장할 수 있는 쓰기 가능한 폴더

DX Manager는 Windows 7 SP1 및 오프라인·폐쇄망 PC를 지원하기 위한 최소
런타임으로 의도적으로 .NET Framework 4.6.2를 사용합니다. Windows 7 SP1에는
4.6.2가 기본 포함되지 않습니다. 설치되어 있지 않다면 [Microsoft 공식 .NET
Framework 4.6.2 페이지](https://dotnet.microsoft.com/en-us/download/dotnet-framework/net462)에서
런타임을 받으십시오. 인터넷이 연결되지 않은 PC는 다른 컴퓨터에서 오프라인
설치 파일을 받은 뒤 옮겨서 설치할 수 있습니다. 4.7.2 또는 4.8이 이미 설치된
경우에는 4.6.2로 낮추거나 따로 설치할 필요가 없으며, 더 최신인 .NET
Framework 4.x가 이 요구 사항을 충족합니다.

### 휴대폰

- Samsung DeX를 지원하는 Samsung Galaxy 기기
- 개발자 옵션 활성화
- USB 디버깅 활성화
- 데이터 통신이 가능한 USB 케이블

현재 정상 동작을 확인한 휴대폰 기준은 Android 16 / One UI 8.x입니다. One UI
7.x 이하에서는 원활한 동작을 확인하지 못했으며 DeX 창이 검게 표시될 수
있습니다. Samsung 펌웨어와 기기별 동작 차이는 여전히 있을 수 있습니다.

처음 연결할 때 휴대폰에 표시되는 RSA 디버깅 허용 창을 승인해야 합니다.
자주 사용하는 PC라면 **이 컴퓨터에서 항상 허용**을 선택할 수 있습니다.

<p align="center">
  <img src="images/ko/usb-debugging-rsa-ko.png" width="520" alt="USB 디버깅 RSA 허용 화면">
</p>

## 2. 설치와 첫 실행

1. 배포 ZIP의 압축을 현재 계정이 쓸 수 있는 폴더에 풉니다. 별도 쓰기
   권한을 설정하지 않았다면 `Program Files` 같은 보호 폴더는 피하십시오.
2. `DXManager.exe`를 실행합니다.
3. Windows 보안 경고가 표시되면 파일의 출처를 확인한 뒤 실행 여부를
   결정합니다.
4. 휴대폰을 USB로 연결하고 RSA 디버깅을 승인합니다.
5. 상단 상태가 휴대폰 연결 상태로 바뀔 때까지 기다립니다.
6. **DeX 시작**을 누릅니다.

<p align="center">
  <img src="images/ko/guide-device-connected-ko.png" width="900" alt="휴대폰 연결을 인식한 DX Manager">
</p>

승인된 USB 또는 무선 기기를 감지하면 DX Manager는 설정된 기기 시작
대기시간이 지난 뒤 세션 시작 명령을 보냅니다. 기본값은 1초이며, 연결 직후
기기 상태가 안정된 다음 scrcpy를 시작하도록 돕습니다.

`DXManager.exe`만 다른 폴더로 복사하면 실행되지 않습니다. `tools` 폴더,
scrcpy DLL, `scrcpy-server`, 라이선스 파일을 포함한 배포 폴더 전체를
유지하십시오. 버전 2.0.0은 scrcpy 4.1을 포함합니다.

> [!IMPORTANT]
> 휴대폰을 연결한 상태에서 **DeX 중지**를 누르거나 `Left Alt+F8`을 누르거나,
> 시스템 트레이의 DX Manager 아이콘을 마우스 오른쪽 버튼으로 눌러 **종료**를
> 선택하십시오. 정리가 끝난 뒤 USB 또는 무선 연결을 끊으십시오.

남은 화면은 **개발자 옵션 > 보조 디스플레이 시뮬레이션**에서 아무 해상도나
한 번 선택하고, 같은 메뉴를 다시 열어 **없음**을 선택하면 제거됩니다.
처음부터 **없음**만 선택하면 남은 화면이 지워지지 않을 수 있습니다. 화면을
포함한 설명은 [FAQ Q1](FAQ_KO.md#q1-휴대폰에-작은-화면보조-디스플레이이-남아-있습니다)을
참조하십시오.

### 여러 휴대폰 사용

DX Manager 2.0은 여러 물리 Galaxy 휴대폰을 동시에 관리할 수 있습니다. 현재
실행에서 확인된 휴대폰이 한 대뿐이면 기기 선택 영역을 숨기고, 두 번째
휴대폰이 감지되면 왼쪽에 표시합니다. 실행 중 한 대가 분리되어도 어떤 세션이
끊겼는지 확인할 수 있도록 이번 실행 동안 기기 항목을 유지합니다.

설정을 바꾸거나 세션을 시작하기 전에 왼쪽 기기 목록에서 대상 휴대폰을
선택하십시오. 휴대폰마다 DeX와 단일창 3개의 설정, 앱 프로필, USB·Wi-Fi
사용 정책, DX Companion 세션과 양방향 파일 전송 상태를 따로 보존합니다.
같은 물리 휴대폰의 USB와 무선 ADB 연결은 하나의 기기 항목으로 합쳐집니다.
DX Manager는 그 휴대폰에서 사용자가 선택한 연결 방식만 사용하며 반대
transport로 임의 전환하지 않습니다.

scrcpy 창 제목에는 휴대폰 표시 이름이 포함됩니다. DX Companion에서 PC로
받은 파일은 설정된 PC 저장 폴더 아래 휴대폰 이름별 하위 폴더에 나누어
저장됩니다.

<p align="center">
  <img src="images/en/guide-device-selection-v2-en.png" width="760" alt="USB 또는 무선 ADB 설정 대상 휴대폰 선택">
</p>

## 3. DeX 모드

왼쪽 메뉴에서 **DeX**를 선택합니다.

<p align="center">
  <img src="images/ko/guide-dex-running-ko.png" width="900" alt="DeX 실행 중 화면">
</p>

### 화면 설정

- **해상도**: 프리셋 또는 사용자 지정 크기
- **DPI**: Android 화면 배율
- **비트레이트**: 영상 품질과 네트워크 사용량
- **최대 FPS**: 30 또는 60fps

DPI 값이 작을수록 화면의 UI 요소가 작아져 한 화면에 더 많은 정보를 표시할
수 있습니다.

사용자 지정 해상도는 프리셋과 별도로 저장됩니다. 다른 프리셋을 선택한 뒤
다시 사용자 지정을 선택해도 마지막 사용자 지정 값이 복원됩니다.

scrcpy 창은 PC 모니터와 창 크기에 맞춰 영상을 자동으로 축소하여 표시합니다.
따라서 PC에서 보이는 창의 크기와 관계없이 실제 DeX 내부 해상도는 DX
Manager에서 설정한 값으로 동작합니다. 사용자 지정 가로·세로 값은 각각
4096까지 입력할 수 있습니다.

### 실행 옵션

- **폰 화면 끄기 (`-S`)**: scrcpy 실행 중 실제 휴대폰 화면 끄기
- **HID 키보드 (`-K`)**: 키보드를 Android 입력 장치로 전달
- **HID 마우스 (`-M`)**: 마우스를 Android 입력 장치로 전달
- **선택 앱 강제 종료**: 앱을 시작하기 전에 기존 프로세스 종료
- **잠자기 방지 (`-w`)**: 실행 중 휴대폰 활성 상태 유지

폰 화면 끄기(`-S`)는 휴대폰을 잠그는 기능이 아니라 활성 상태에서 물리
디스플레이만 끄는 기능입니다. 화면이 꺼져 있어도 터치, 길게 누르기, 지문
인증 등의 입력은 동작할 수 있으므로 의도하지 않은 설정 변경이나 앱 조작에
주의하십시오.

HID 키보드와 HID 마우스를 끄면 scrcpy의 비 HID 입력 방식을 사용합니다.
이때 마우스 입력은 화면을 직접 터치하는 것처럼 전달되며, 마우스 버튼을
누르고 있으면 길게 누르기 동작으로 처리됩니다.

비 HID 키보드는 HID 방식과 일부 동작이 다릅니다. 영문 입력은 가능하지만
한영키가 동작하지 않을 수 있으므로 왼쪽 Shift+Space로 입력 언어를
전환하십시오. Android 키보드와 시스템 설정에 따라 이 조합도 동작하지 않을
수 있습니다.

설정을 변경한 뒤 실행 버튼을 누르면 필요한 경우 기존 DeX 세션을 정리하고
새 설정으로 다시 시작합니다.

## 4. 단일창 모드

왼쪽 메뉴에서 **단일창 1**, **단일창 2**, **단일창 3** 중 하나를
선택합니다. 각 슬롯은 해상도, DPI, 비트레이트, FPS, 앱과 실행 옵션을
독립적으로 기억합니다.

1. **앱 목록 불러오기**를 누릅니다.
2. 시작할 앱을 선택합니다.
3. 화면과 실행 옵션을 설정합니다.
4. **단일창 시작**을 누릅니다.

앱을 자동 실행하지 않으려면 앱 목록의 **선택 안 함**을 선택합니다.

자동으로 정상 실행된 앱은 공통 최근 앱 목록에 저장됩니다. 전체 앱 목록을
다시 불러오기 전에도 다른 슬롯이나 다음 실행에서 바로 선택할 수 있습니다.

### 앱 프로필

단일창 모드는 선택한 Android 패키지마다 프로필 하나를 저장할 수 있습니다.
원하는 화면과 실행 옵션을 만든 뒤 **앱 프로필 > 현재 설정 저장**을 선택하십시오.
해상도, DPI, 비트레이트, FPS, 화면 끄기, 잠자기 방지, HID 입력, 강제 종료,
동적 창 크기와 추가 인자가 저장됩니다. 세 단일창 중 어느 슬롯에서든 같은 앱을
선택하면 저장된 프로필이 해당 슬롯에 자동으로 적용됩니다.

같은 메뉴에서 현재 설정으로 덮어쓰거나 프로필을 삭제할 수 있습니다. 프로필을
삭제해도 현재 슬롯에 이미 불러온 설정은 바뀌지 않으며, 단일창 프로필은 DeX
모드 설정에 영향을 주지 않습니다.

단일창은 DeX 가상화면을 재사용하지 않습니다. scrcpy의 새 가상 디스플레이
기능으로 각각 별도의 화면을 만들며, DeX와 단일창 3개를 동시에 실행할 수
있습니다.

<p align="center">
  <img src="images/ko/readme-single-window-ko.png" width="900" alt="서로 다른 해상도의 단일창 두 개를 실행한 화면">
</p>

- **동적 창 크기 (`-x`)**: 창 크기에 맞춰 가상 디스플레이 크기 조정
- 단일창 제목: `DX Manager - 앱 이름`
- DeX 창 제목: `DX Manager - DeX Station`

게임에 따라 HID 키보드와 HID 마우스를 끄고 단일창 모드를 사용하는 편이
입력 호환성이 더 좋을 수 있습니다.

## 5. 드래그 앤 드롭 파일 전송

실행 중인 DeX 또는 단일창의 scrcpy 창에 파일을 하나 이상 놓거나 폴더 전체를
놓을 수 있습니다. DX Manager 파일 전송은 기본값으로 켜져 있으며, Windows
7 SP1부터 11까지 호환되는 경로로 한글·일본어 등 Unicode 이름을 보존합니다. 휴대폰의 기본
저장 위치는 `/sdcard/Download/`이며 **설정 > 경로 / ADB > 프로그램 및 저장
경로**에서 바꿀 수 있습니다. 변경한 위치는 새로 여는 DeX와 단일창부터
적용됩니다. 안전을 위해 저장 위치는 `/sdcard/` 또는 `/storage/emulated/0/`
아래 폴더만 지정할 수 있습니다. **캡처의 휴대폰 저장 폴더**와 **드롭 파일
휴대폰 저장 폴더** 옆의 **찾아보기**를 누르면 연결된 휴대폰의 기존 폴더를
선택할 수 있습니다. Android 경로는 Windows 경로와 달리 `/` 구분자를
사용합니다.

폴더를 놓으면 최상위 폴더, 하위 폴더, 파일과 빈 폴더를 그대로 보존합니다.
선택한 폴더 밖으로 따라가지 않도록 정션, 심볼릭 링크 등 재분석 지점은
건너뜁니다. APK 파일을 단독으로 놓으면 scrcpy의 설치 동작을 유지하고, 폴더
안에 포함된 APK는 일반 파일로 복사합니다.

독립적으로 이동할 수 있는 작은 상태창은 처음에 scrcpy 창 옆에 열립니다.
현재 전송 항목과 다음 대기 항목 4개, 파일 크기, 경과 시간 및
완료·실패·대기 수를 표시합니다. 지원하는 모든 Windows와 ADB 조합에서 정확한
전송 바이트를 얻을 수 없으므로 진행률과 남은 시간은 표시하지 않습니다.
**취소**를 누르면 해당 scrcpy 창의 진행 중·대기 중 전송을 모두 중단하고
휴대폰의 임시 데이터를 정리하도록 시도합니다. 이미 끝난 이동 결과가 엇갈리지
않도록 짧은 최종 저장 단계에서는 취소 버튼이 비활성화됩니다.

휴대폰의 기존 파일과 폴더는 덮어쓰지 않습니다. 같은 이름이 있으면
`이름 (1).확장자`, `이름 (2).확장자` 또는 `폴더 (1)`로 저장합니다.

scrcpy의 순정 파일 드롭 방식을 사용하려면 **설정 > 경로 / ADB > 프로그램 및
저장 경로**에서 **DX Manager 파일 전송 사용 (한글/Unicode 호환)**을
끄십시오. 설정은 DeX 또는 단일창을 시작할 때 적용되므로 이미 열린 창은
기존 전송 방식을 유지합니다. APK 설치 드롭과 관리 대상 폴더 push 이외의
ADB 명령은 계속 scrcpy의 일반 동작을 사용합니다.

## 6. USB 연결

기본 연결 방식입니다.

1. 휴대폰에서 USB 디버깅을 켭니다.
   USB 디버깅 항목이 회색으로 표시되어 선택할 수 없다면 Galaxy의
   **설정 > 보안 및 개인정보 보호 > 보안 위험 자동 차단**을 확인하십시오.
   이 기능을 끄면 USB 디버깅을 활성화할 수 있습니다. 세부 설정의
   **자동으로 켜기**가 활성화되어 있으면 약 30분 후 자동 차단이 다시 켜져
   USB 디버깅 연결이 끊어질 수 있습니다. 메뉴 이름과 위치는 One UI 버전에
   따라 다를 수 있습니다.
2. USB 케이블로 PC와 휴대폰을 연결합니다.
3. RSA 디버깅 허용 창을 승인합니다.
4. DX Manager에서 연결 상태를 확인합니다.

장치가 나타나지 않으면 케이블, USB 포트, Samsung USB 드라이버와 RSA
승인 상태를 확인한 뒤 **설정 > 진단 > 환경 점검 실행**을 사용하십시오.

## 7. 무선 연결

### USB로 무선 연결 준비

처음 연결하거나 휴대폰 재부팅 후 가장 간단한 방법입니다.

1. PC와 휴대폰을 같은 로컬 네트워크에 연결합니다.
2. 휴대폰을 승인된 USB 디버깅 상태로 연결합니다.
3. **설정 > 연결**에서 **무선 ADB 연결 사용**을 선택합니다.
4. 휴대폰 IP 주소를 비워두면 프로그램이 Wi-Fi 주소를 자동으로 찾습니다.
5. 연결 포트를 확인합니다. 기본값은 `5555`입니다.
6. **USB로 무선 준비**를 누릅니다.
7. 무선 연결 성공을 확인한 뒤 USB 케이블을 분리합니다.

IP 자동 감지에 실패하면 휴대폰의 Wi-Fi 상세 화면에서 IPv4 주소를 확인해
직접 입력하십시오.

### Android 11 이상 무선 페어링

1. 휴대폰의 **개발자 옵션 > 무선 디버깅**을 켭니다.
2. **페어링 코드로 기기 페어링**을 엽니다.
3. DX Manager에 휴대폰 IP, 페어링 포트와 6자리 코드를 입력합니다.
4. **페어링**을 누릅니다.
5. 페어링 완료 후 무선 디버깅 기본 화면에 표시된 **연결 포트**를 입력합니다.
6. **무선 연결**을 누릅니다.

페어링 포트와 실제 연결 포트는 서로 다를 수 있습니다. 페어링 코드는
설정이나 로그에 저장되지 않습니다.

### 무선 연결 문제

- PC와 휴대폰이 같은 Wi-Fi 이름을 사용해도 서로 통신하지 못할 수 있습니다.
- 게스트 Wi-Fi, AP 격리, 클라이언트 격리, VLAN과 회사 방화벽을 확인합니다.
- 휴대폰 재부팅 후에는 USB 무선 준비가 다시 필요할 수 있습니다.
- 5GHz에서 최초 연결이 실패하면 공유기 설정을 확인하거나 2.4GHz에서
  연결을 초기화한 뒤 다시 시도해 볼 수 있습니다.

## 8. 화면 캡처

캡처 단축키는 scrcpy 창이 활성화된 상태에서만 동작합니다.

1. `F8`을 누르면 scrcpy 창이 전면으로 오고 안내가 표시됩니다.
2. `F8`을 다시 누르면 scrcpy의 화면 영역만 캡처합니다.
3. 마우스로 드래그하면 선택한 영역을 캡처합니다.
4. `Esc`를 누르면 취소합니다.

드래그 캡처는 scrcpy 창 내부로 제한되지 않습니다. 웹페이지, 문서, 다른
프로그램 등 PC 화면의 필요한 영역을 선택해 캡처한 뒤 바로 휴대폰으로
전송하는 용도로도 사용할 수 있습니다.

캡처 결과는 기본적으로 실행 폴더의 `screenshot` 폴더에 저장됩니다.
**캡처 후 폰으로 전송**을 켜면 설정한 휴대폰 폴더에도 전송합니다.

DX Manager가 만든 가상 DeX 화면에서는 DeX 작업 표시줄의 스크린샷 버튼이
작동하지 않습니다. 화면을 저장하려면 DX Manager의 `F8` 캡처 기능을
사용하십시오.

## 9. 키 입력 보정

키 입력 보정은 scrcpy 창이 활성화된 경우에만 적용됩니다.

- **한영키 보정**: 한영키를 Android의 Shift+Space로 전달
- **오른쪽 Windows 키 보정**: Android 입력 호환성 보정
- **Enter 변환**: 사용 설정 시 시작 상태는 일반 Enter
- `Scroll Lock`: Enter 변환을 사용 설정했을 때 일반 Enter와 Shift+Enter 모드 전환
- 직접 입력한 Shift+Space를 무시하는 옵션 제공(기본값 꺼짐)

Windows용 scrcpy 4.0/SDL3에서는 Windows가 물리 오른쪽 Shift를 감지해도
Android로 전달되지 않는 현상을 재현했습니다. DX Manager는 SDL3 기반
scrcpy 4.x 클라이언트와의 호환을 위해 해당 scrcpy 창이 활성화된 동안에만
오른쪽 Shift를 왼쪽 Shift로 변환합니다. 일반적인 Shift 타이핑은 정상
동작하지만 해당 세션에서 Android는 좌우 Shift를 구분하지 못합니다.

기본 캡처 단축키는 `F8`, 종료 단축키는 `왼쪽 Alt+F8`입니다. 설정의
**키 입력** 페이지에서 입력 필드를 선택한 뒤 원하는 키 또는 키 조합을
누르면 변경할 수 있습니다.

### 자주 사용하는 scrcpy 단축키

다음은 Samsung DeX 자체 단축키가 아니라 scrcpy 창 단축키입니다. 아래 예시는
scrcpy의 기본 단축키 보조 키 중 하나인 왼쪽 `Alt`를 사용합니다.

| 단축키 | 동작 |
| --- | --- |
| `Alt+F` 또는 `F11` | 전체 화면 전환 |
| `Alt+G` | 현재 영상의 1:1 픽셀 크기에 맞춰 창 크기 조정 |
| `Alt+P` | 휴대폰 전원 버튼 누르기 |
| `Alt+O` | 휴대폰 화면 끄기 (`O`는 숫자 0이 아닌 영문자 O) |
| `Alt+Shift+O` | 휴대폰 화면 켜기 |
| `Alt+V` | PC 클립보드를 동기화하고 붙여넣기 |
| `Ctrl+V` | 활성 Android 앱에 Ctrl+V 전달(앱에 따라 동작) |

다른 [scrcpy 4.1 공식 단축키](https://github.com/Genymobile/scrcpy/blob/v4.1/doc/shortcuts.md)도
사용할 수 있지만, 일부 Android 시스템 단축키는 가상 DeX 화면에서 동작하지
않거나 휴대폰의 기본 화면에서 실행될 수 있습니다.

### 미니 컨트롤바

**설정 > 기본 > Scrcpy 창 옆에 미니 컨트롤바 표시**를 켜면 각 DeX·단일창에
전용 미니바가 나타납니다. 연결된 scrcpy 창을 따라다니며 휴대폰 화면 끄기·켜기,
전원 버튼, 전체 화면, 1:1 창 크기, 캡처와 **DX Manager 열기**를 제공합니다.
버튼에 마우스를 올리면 기능 설명과 해당 단축키가 표시됩니다.

**설정 > 기본**에서 왼쪽 또는 오른쪽 위치를 고를 수 있고, 맨 아래 버튼으로
접거나 펼칠 수 있습니다. 연결된 창의 활성화, 최소화와 앞뒤 순서를 따라가므로
뒤에 있는 세션의 미니바가 활성 세션 위를 가리지 않도록 관리됩니다.

## 10. 자동 숨김과 시스템 트레이

자동 숨김을 사용하면 설정된 시간 동안 입력이 없을 때 scrcpy 창과 DX
Manager UI가 숨겨지고 프로그램은 시스템 트레이로 이동합니다.

입력이 발생했다고 자동으로 다시 나타나지는 않습니다. Windows 작업
표시줄의 scrcpy 창을 클릭하거나, 트레이 아이콘을 두 번 클릭하거나, 트레이
메뉴에서 열기를 선택해 창을 복원합니다.

프로그램 창의 닫기 버튼은 DX Manager를 트레이로 숨깁니다. 완전히 종료하려면
`Left Alt+F8`을 누르거나 트레이 아이콘을 마우스 오른쪽 버튼으로 눌러
**종료**를 선택하십시오. 세션 정리가 끝날 때까지 휴대폰 연결을 유지하십시오.

## 11. 로그와 환경 점검

### 로그

로그는 현재 프로그램 실행 세션만 표시합니다. 필요한 경우 **로그 저장**을
눌러 파일로 보관하십시오.

로그에는 다음 정보가 포함될 수 있습니다.

- 선택된 ADB와 버전
- 장치 연결 상태
- DeX 및 단일창 실행 결과
- display ID 탐색 결과
- scrcpy 출력과 오류

여러 platform-tools 버전은 공통 프로토콜 문구인 `Android Debug Bridge
version 1.0.41`을 출력합니다. DX Manager는 그 다음 `Version ...` 줄에서 실제
빌드 값을 읽어 표시합니다. 번들 scrcpy ADB는 `37.0.0-14910828`, 번들 레거시
ADB는 `34.0.1-9979309`로 표시됩니다.

### 환경 점검

**설정 > 진단 > 환경 점검 실행**에서 ADB, scrcpy, Windows, 장치 연결과
주요 폴더 상태를 확인할 수 있습니다.

**선택 기기 버전** 카드에는 현재 선택한 휴대폰의 모델, 연결 방식, Android
버전, SDK 수준, One UI와 보안 패치가 표시됩니다. 호환성 판정은 참고 정보이며
실행을 차단하지 않습니다. 펌웨어 업데이트나 연결 방식 변경 뒤에는 **새로 고침**을
누르십시오.

**진단 보고서 저장**은 기기 이름, serial, IP 주소, 토큰과 로컬 경로를 가린 텍스트
보고서를 만듭니다. 외부 ADB·scrcpy 메시지에는 환경별 정보가 남을 수 있으므로
공유하기 전에 내용을 한 번 확인하십시오.

<p align="center">
  <img src="images/en/guide-device-diagnostics-v2-en.png" width="760" alt="선택 기기 진단과 DX Companion 상태">
</p>

진단 페이지에서 **고급 옵션 표시**를 누르면 기기 감시 주기, 가상
디스플레이 감지 제한시간, ADB Wake-up, 프로세스 제한시간과 캡처 선택
대기시간을 설정할 수 있습니다. 이러한 감시·복구용 값은 일반적으로 변경할
필요가 없습니다.

진단 페이지의 **DX Companion** 항목에서 번들 Companion을 현재 선택된 휴대폰에
설치·업데이트·재설치하거나 권한을 부여하고 삭제할 수 있습니다. 어떤 동작도
자동으로 시작되지 않습니다. DX Manager는 설치 전 정확한 APK 해시와 공식 서명을
확인하고, 설치 후에도 패키지명·버전·서명과 권한 상태를 다시 검증합니다. 다른
앱에는 권한을 부여하지 않습니다.

휴대폰이 연결되지 않았거나 정리 앱이 없거나 서명이 일치하지 않으면 버튼은
비활성화되고 이유가 표시됩니다. 이미 권한이 있으면 **권한 부여됨**으로
표시됩니다. 이 권한은 정리 앱이 Android의 가상화면 설정을 삭제하기 위한
것이며 임의의 ADB 명령 실행 권한을 제공하지 않습니다.

<p align="center">
  <img src="images/ko/guide-advanced-options-ko.png" width="900" alt="진단 메뉴의 고급 옵션">
</p>

### 앱 보안과 다중 디스플레이 제한

일부 금융·게임·스트리밍·보안 앱은 USB 디버깅이나 개발자 옵션이 켜진
환경에서 실행을 거부할 수 있습니다. 보안 화면 또는 DRM 콘텐츠가 검게
표시되거나 가상·보조 디스플레이 실행이 차단될 수도 있습니다. DX Manager는
이러한 앱과 Android의 보안 정책을 우회하지 않습니다.

다중 디스플레이를 완전히 지원하지 않는 앱은 DeX에서 실행해도 휴대폰 화면에
열릴 수 있습니다. 휴대폰에서 앱을 완전히 종료하거나 **선택 앱 강제 종료**를
사용한 뒤 다시 실행해 보십시오.

문제를 제보할 때는 비밀번호, 페어링 코드나 민감한 네트워크 정보가 없는지
확인한 뒤 저장한 로그를 첨부하십시오.

## 12. 선택형 DX Companion

**DX Companion 2.0.0**은 Android 복구 및 파일 전송 도구입니다. 휴대폰에 남은
보조 디스플레이 시뮬레이션 화면을 제거하고, PC가 복원하지 못한 개발자 옵션의
**절전모드 해제**를 끄며, 선택한 파일이나 폴더를 휴대폰에서 DX Manager로 보낼
수 있습니다. 평소에는 휴대폰을 연결한 상태에서 **DeX 중지**, `Left Alt+F8`
또는 트레이 메뉴의 **종료**를 사용하는 것이 우선입니다.

### 설치와 최초 1회 권한 부여

1. 휴대폰에서 USB 디버깅을 켜고 이 컴퓨터의 RSA 연결을 승인한 뒤 대상 휴대폰을
   DX Manager에 연결합니다.
2. **설정 > 진단 > DX Companion**을 엽니다.
3. **DX Companion 설치**를 누르고 확인합니다. DX Manager는 현재 선택된 휴대폰
   한 대에만 설치하고 검증 후 필요한 보호 권한까지 부여합니다.
4. 공식 앱을 직접 설치한 경우에는 **권한 부여**를 누릅니다. 번들 버전에 따라
   **업데이트** 또는 **재설치**가 표시되면 해당 버튼을 사용할 수 있습니다.
5. 설치된 버전과 번들 버전, **권한 부여됨** 상태를 확인합니다.

서명된 APK는 포터블 폴더의 `tools\companion\DX-Companion.apk`에 외부 파일로
들어 있습니다. APK만 복사하거나 따로 설치할 수는 있지만 Android 보호 권한을
스스로 얻을 수는 없습니다. 사용자가 설치 버튼을 누르기 전에는 DX Manager가
자동으로 설치하지 않습니다.

DX Manager는 설치된 앱의 package ID가
`io.github.mazemei.dxdisplaycleanup`인지 확인하고, 휴대폰에서 설치 APK를 가져와
공식 v2 서명 인증서와 일치하는지도 검사합니다. 연결 기기, 패키지와 서명이
모두 일치할 때만 버튼이 활성화되며, 권한 부여 직전과 직후에도 다시 검증합니다.
사후 검증이 실패하면 방금 부여한 권한을 회수합니다. 같은 패키지명을 사용한
다른 서명의 앱에는 권한을 부여하지 않습니다.

권한은 휴대폰 재부팅과 같은 공식 서명의 앱 업데이트 후에도 유지됩니다.
**DX Companion 삭제**는 현재 선택된 휴대폰의 파일 수신과 ADB reverse 연결을
먼저 정리한 뒤 앱을 삭제합니다. Android는 권한과 앱의 타일·위젯·설정도 함께
제거합니다. 이 보호 권한은 일반 Android 권한 창에서 직접 허용할 수 없습니다.

### 앱, 빠른 설정 타일과 홈 화면 위젯

- **앱 본체**: 두 상태를 확인하고 **가상화면 정리**, **절전모드 해제 끄기** 또는
  두 항목을 한 번에 정리할 수 있습니다.
- **빠른 설정 타일**: 알림창의 빠른 설정 편집에서 **DX Companion**을 추가하면
  휴대폰 어디서든 한 번 눌러 정리할 수 있습니다.
- **홈 화면 위젯**: 2 × 1 크기의 DX Companion 위젯에서 상태 확인, 정리와
  새로고침을 사용할 수 있습니다.
- **타일·위젯 설정**: 기본값은 가상화면과 절전모드 해제를 모두 정리합니다.
  앱 본체에서 가상화면만, 절전모드 해제만 또는 둘 다로 범위를 바꿀 수 있습니다.

### 연결이 끊긴 뒤 자동 정리

DX Companion은 DX Manager와 인증된 guardian 연결이 끊긴 뒤 일정 시간 기다렸다가
정리할 수 있습니다. 선택값은 **연결 해제 시 바로 정리**, **1분**, **5분**,
**10분**, **30분**, **자동으로 정리하지 않음**이며 기본값은 **5분**입니다.
대기 시간이 끝나기 전에 같은 인증 세션이 다시 연결되면 예약된 정리는
취소됩니다.

<p align="center">
  <img src="images/en/guide-companion-quick-settings-en.png" width="420" alt="DX Companion 빠른 설정 타일과 위젯 및 지연 정리 옵션">
</p>

따라서 일시적인 USB 또는 Wi-Fi 끊김만으로 기존 가상화면을 바로 지울 필요가
없습니다. Windows 종료 시 DX Manager는 새 ADB 보조 프로세스를 실행하지 않고,
이미 연결되어 검증된 Companion 세션이 있을 때만 즉시 정리를 요청합니다. 이는
최선 노력 방식의 보조 장치이므로 가능하면 DX Manager를 정상 종료하는 방법을
우선 사용하십시오.

상태 표시는 다음과 같습니다.

- 컬러 DX 아이콘: 선택한 정리 대상 중 하나 이상이 활성 상태
- 흑백 DX 아이콘: 선택한 정리 대상이 이미 모두 정리된 상태
- 경고 표시: 권한 없음 또는 상태 확인 실패

정리 버튼은 Android의 전역 `overlay_display_devices` 설정 자체를 삭제하고
다시 조회해 실제로 제거됐는지 확인합니다. Android에는 이 설정이 하나만
있으므로 DX Manager가 만든 화면과 개발자 옵션에서 사용자가 직접 선택한 보조
디스플레이를 구분할 수 없습니다. 정리하면 현재 설정된 보조 디스플레이
시뮬레이션 화면이 모두 제거됩니다.

보호된 `WRITE_SECURE_SETTINGS` 사용 범위는 보조 디스플레이 시뮬레이션 설정과
Android의 절전모드 해제 개발자 옵션으로 한정됩니다. 네트워크 권한은 DX
Manager와 인증된 로컬 전송·guardian 세션에만 사용하며 분석 수집, 클라우드
전송과 임의 shell 실행 기능은 포함하지 않습니다.

<p align="center">
  <img src="images/en/guide-companion-home-en.png" width="420" alt="휴대폰에 남은 보조 화면이 표시된 DX Companion 정리 화면">
</p>

앱을 사용하지 않아도 [FAQ의 수동 제거 절차](FAQ_KO.md#q1-휴대폰에-작은-화면보조-디스플레이이-남아-있습니다)로
같은 화면을 제거할 수 있습니다.

### 휴대폰에서 PC로 파일과 폴더 보내기

1. DX Manager를 실행하고 전송할 휴대폰을 USB 또는 무선 ADB로 연결합니다.
2. DX Companion의 **파일 전송** 탭에서 **DX Manager가 연결되어 파일을 받을
   준비가 되었습니다**라는 안내를 확인합니다.
3. 파일은 갤러리나 내 파일에서 선택한 뒤 Android 공유 메뉴의 **DX Manager로
   보내기**를 선택합니다.
4. 폴더는 Android 공유 메뉴로 보낼 수 없으므로 DX Companion의 **폴더 보내기 >
   폴더 선택**을 사용합니다.

<p align="center">
  <img src="images/en/guide-companion-file-transfer-en.png" width="420" alt="DX Companion 파일 및 폴더 전송 화면">
</p>

받을 위치는 DX Manager의 **설정 > 경로 / ADB > 휴대폰→PC 저장 폴더**에서
변경할 수 있습니다. 전송 데이터는 현재 선택된 휴대폰의 인증된 ADB reverse
세션을 통해 PC로 직접 전달되며, 휴대폰에 별도의 임시 복사본을 만들지 않습니다.
PC 대상 폴더에 같은 이름이 있으면 원본을 덮어쓰지 않고 `이름 (1)`, `이름 (2)`
형식으로 저장합니다.

DX Manager가 실행 중이 아니거나 대상 휴대폰이 연결되지 않았거나, 검증된 DX
Companion이 설치되지 않은 경우에는 연결 대기 안내가 표시되고 전송이 시작되지
않습니다. 여러 파일을 공유할 수 있으며 폴더는 하위 구조와 빈 폴더를 유지합니다.

## 13. 언어, 테마와 설정 초기화

<p align="center">
  <img src="images/ko/guide-settings-basic-ko.png" width="900" alt="DX Manager 기본 설정 화면">
</p>

- 표시 언어: 자동, 한국어, 영어
- 앱 테마: Windows 설정 사용, 라이트, 다크
- 테마는 저장 즉시 적용됩니다.
- 일부 언어 및 경로 변경은 재시작 후 완전히 반영될 수 있습니다.

모든 옵션을 초기 상태로 되돌리려면
**설정 > 진단 > 모든 설정 기본값 복원**을 사용하십시오.

설정 파일은 실행 폴더의 `config/settings.json`에 저장됩니다.

## 14. 자주 묻는 질문

사용 중 궁금한 점이나 문제 해결 방법은 [English FAQ](FAQ_EN.md)와
[한국어 자주 묻는 질문](FAQ_KO.md)을 참조하십시오.

## 15. 제거

DX Manager는 별도 설치 프로그램을 사용하지 않습니다.

1. DX Manager를 완전히 종료합니다.
2. 필요한 스크린샷과 로그를 백업합니다.
3. 압축을 풀었던 DX Manager 폴더를 삭제합니다.

Windows 자동 실행을 사용했다면 삭제 전에 설정에서 자동 실행을
해제하십시오.

## 상표 및 제3자 구성요소

DX Manager는 독립적으로 개발된 도구이며 Samsung Electronics 또는
Genymobile과 제휴·후원·보증 관계가 없습니다.

Samsung과 Samsung DeX는 Samsung Electronics Co., Ltd.의 상표입니다.
scrcpy와 동봉된 구성요소는 각각의 라이선스를 따릅니다. 자세한 내용은
[`THIRD_PARTY_NOTICES.md`](../DexManager/licenses/THIRD_PARTY_NOTICES.md)를
참조하십시오.

## 개발자와 프로젝트

- 개발자: [maze](https://github.com/maze-mei)
- GitHub: [maze-mei/DX-Manager](https://github.com/maze-mei/DX-Manager)
- 라이선스: [MIT License](../LICENSE)
- Copyright © 2026 maze

DX Manager는 개인이 독립적으로 개발한 프로젝트입니다.