Releases: ai-blink/scrcpy-gui
Release list
v0.3.0
v0.2.0
v0.1.7-beta 이후 전체 변경
새 기능
- PowerShell 없이 실행되는 독립 WPF 설정 앱
- 여러 휴대폰의 별칭·모델명·기본 기기·연결 상태·최근 사용 관리
- 마지막 선택 기기 및 자동 선택 모드 복원
- 무선 페어링 코드 입력 흐름과 가이드
개선 및 수정
- 기기 선택 상태와 오프라인 상태 표시 개선
- 기기 관리 창 다크 테마 및 긴 목록 레이아웃 개선
- 명령어 미리보기를 최대 3줄로 표시
- 표시 이름 중복 시에도 기기 ID로 정확히 선택
- --screen-off-timeout=500 기본 자동 추가 제거
- PowerShell 구현을 관심사별 모듈로 분리
전체 내역은 CHANGELOG.md를 참고하세요.
v0.2.0-beta
주요 변경
- 여러 휴대폰의 별칭, 모델명, 기본 기기, 연결 상태, 최근 사용을 관리하는 휴대폰 관리 창을 추가했습니다.
- 선택 기기 상태와 자동/명시 선택 복원을 개선했습니다.
- 명령어 미리보기를 최대 3줄로 표시해 가로 스크롤바가 내용을 가리지 않게 했습니다.
- 화면을 자동으로 끄던 --screen-off-timeout=500 기본 추가를 제거했습니다.
자세한 내용은 CHANGELOG.md를 참고하세요.
v0.1.7-beta
무선 페어링 protocol fault 수정
adb pair가 protocol fault (couldn't read status message): No error로
실패하는 문제를 실제 기기로 근본 원인까지 확인했습니다.
- adb 데몬 재시작으로 1회 자동 재시도 (데몬 노후화 케이스 대응)
- 그래도 실패하면, 실제 원인이었던 Windows 네트워크 프로필 "공용"
(재부팅 후 흔함 — 방화벽이 로컬 페어링 연결을 차단)을 에러 메시지에서
바로 안내 - README 무선 페어링 섹션에 동일 트러블슈팅 문구 추가
전체 변경: v0.1.6-beta...v0.1.7-beta
v0.1.6-beta
v0.1.5-beta 를 쓰고 계시면 이 판으로 올려주세요. v0.1.5 의 [기기 찾기] 는 실제로는 잘 붙지 않습니다(아래 참고).
[기기 찾기] 가 실제로 동작하도록 고쳤습니다
v0.1.5 에서 넣은 [기기 찾기] 를 실사용 조건에서 재보니 연결 복구에 실패했습니다. 원인 두 가지를 고쳤습니다.
- 한 번만 보고 판정하던 문제 — 연결이 끊긴 직후에는 기기 목록이 비어 있거나
offline로 보이다가
몇 초 뒤에야 정상으로 바뀝니다. v0.1.5 는 그 순간을 놓치고 곧장 실패로 안내했습니다. 이제 잠시 지켜봅니다. - 진짜 원인은 mDNS 가 아니라 죽은 adb 데몬이었습니다 — 오래 떠 있던 adb 는 기기 탐색이 멈춰 있어,
아무리 기다려도 폰이 잡히지 않습니다. 이제 그 경우 adb 를 다시 시작해서 되살립니다.
고친 뒤 실측: PC 쪽 연결이 끊긴 상태에서 약 20초 만에 자동 복구되었고, 폰은 손대지 않았습니다(2회 재현).
이제 [기기 찾기] 는 이렇게 동작합니다
- 폰이 스스로 붙는지 몇 초 기다립니다
- 안 되면 adb 를 다시 시작하고 다시 기다립니다 ← 대부분 여기서 붙습니다
- 그래도 안 되면 같은 Wi-Fi 에서 폰 주소를 직접 찾아, 응답하는 주소에만 연결합니다
각 단계가 하단 상태줄에 그대로 표시됩니다.
⚠️ 2단계는 adb 를 재시작하므로 열려 있는 미러링 창이 끊깁니다. 그 단계에 들어가기 전에 상태줄로 알립니다.
아직 확인하지 못한 것
위 검증은 PC 쪽 연결만 끊은 상태에서 한 것입니다. 폰이 Wi-Fi 에서 빠졌다가 돌아온 상황은
조건이 달라서(폰 쪽 포트가 바뀌고, 기기에 따라 무선 디버깅 토글이 꺼질 수 있음) 아직 재보지 못했습니다.
그래서 이번 판도 pre-release 입니다.
설치
ZIP 을 풀고 scrcpy-gui.bat 을 실행하세요. scrcpy 가 없으면 창의 [설정] → [공식 최신 버전 설치] 로
Genymobile 공식 릴리스를 내려받아 SHA-256 검증 후 설치할 수 있습니다.
v0.1.5-beta
⚠️ 이 판의 [기기 찾기] 는 실제로는 잘 붙지 않습니다. 연결이 끊긴 직후를 실패로 오판하는 결함이 있습니다.
v0.1.6-beta 를 쓰세요.
폰을 만지지 않고 다시 연결 — [기기 찾기]
상단에 [기기 찾기] 버튼이 생겼습니다. 폰이 목록에서 사라졌을 때 폰을 집어 들지 않고 PC에서 복구합니다.
- 누르면 순서대로 시도합니다: 이미 연결됐는지 확인 → 같은 Wi-Fi에서 검색 → 응답하는 주소만 골라냄 → 연결
- 진행 단계가 하단 상태줄에 그대로 보입니다
- 응답 없는 주소는 먼저 걸러내므로, 죽은 주소에 매달려 멈추지 않습니다
꺼진 기기도 목록에 남습니다
- 전에 연결했던 기기를 기억해, 지금 꺼져 있어도 (오프라인) 으로 목록에 표시합니다.
기존에는 목록에서 아예 사라져 다시 고를 수조차 없었습니다 - 기기 이름 앞에 모델명(예:
SM_S918N)이 붙어 알아보기 쉬워졌습니다 - 연결되지 않은 기기를 고른 채 [실행]을 누르면 막고 [기기 찾기]를 안내합니다
알려진 제한
- [기기 찾기]의 검색 경로는 아직 실사용 검증이 끝나지 않았습니다. 개발 환경에서 폰이 이미 연결돼 있어
첫 단계에서 끝나버려, 검색 → 연결 구간까지 도달한 적이 없습니다. 폰이 끊긴 상태에서의 동작은 확인이 필요합니다.
이 때문에 이번 판도 pre-release 입니다. - 무선 디버깅으로 붙은 기기는 환경에 따라 기기 ID가
IP:포트가 아니라 mDNS 이름으로 잡힙니다.
그 이름으로는adb connect가 되지 않아, [기기 찾기]가 주소를 다시 찾아 연결합니다.
설치
ZIP을 풀고 scrcpy-gui.bat 을 실행하세요. scrcpy가 없으면 창의 [설정] → [공식 최신 버전 설치] 로
Genymobile 공식 릴리스를 내려받아 SHA-256 검증 후 설치할 수 있습니다.
v0.1.4-beta
첫 무선 연결 자동화
- GUI에서 설치한 adb.exe 절대 경로로 무선 페어링을 수행합니다. 전역 PATH·터미널·USB 연결이 필요 없습니다.
- 자동 설치 뒤에는 상단 [무선 페어링]으로 바로 다음 행동을 안내합니다.
- 무선 디버깅 허용 대기와 offline 상태를 GUI에 표시하고 복구 방법을 안내합니다.
실행 흐름 통합
- scrcpy_run.bat도 설정 GUI를 열어 설치·페어링·실행 경로를 하나로 유지합니다.
- README와 설치 안내를 GUI 중심 흐름으로 갱신했습니다.
v0.1.3-beta
PowerShell 7 시작 복구
- 실행 BAT가 표준 PowerShell 7 설치 경로를 먼저 확인하고, PATH는 마지막으로만 사용합니다.
- PowerShell 7이 없으면 원래의 명령어 찾기 오류 대신 설치 방법을 안내합니다.
문서
- README와 설치 안내에 새 시작 동작과 복구 방법을 추가했습니다.
v0.1.2-beta
문서와 캡처
- README 첫 화면에 실제 설정 GUI 캡처와 명령어 미리보기 설명을 추가했습니다.
- GUI의 설치 안내 HTML에도 같은 캡처와 접근성 있는 대체 텍스트를 넣었습니다.
- 배포 ZIP에 캡처 자산을 포함합니다.
v0.1.1-beta
화면을 끄고 PC로 사용
- 하나의 토글이
--turn-screen-off --keep-active를 함께 설정합니다. - 충전 중 활성 유지·화면 자동 꺼짐 시간·보기 전용의 충돌 상태를 자동으로 정리하고, 원래 선택은 모드를 끄면 복원합니다.
- 직접 추가 인자로
--no-control/-n과 화면 끄기를 함께 전달하면 실행과 배치 파일 생성을 막습니다.
문서와 버전
- README에 화면을 끈 원격 제어의 동작과 제약을 추가했습니다.
- GUI 표기와 prerelease 태그를
v0.1.1-beta로 올렸습니다.
검증
- PowerShell 구문 검사
- 화면 끄기·보기 전용 충돌 조합 검사
- 공식 scrcpy 릴리스 조회