
Android 기기를 표시하고 제어하세요
이 GitHub 저장소(https://github.com/Genymobile/scrcpy)는 이 프로젝트의 유일한 공식 소스입니다. 이름에 scrcpy가 포함되어 있더라도 임의의 웹사이트에서 릴리스를 다운로드하지 마십시오.
"screen copy"로 발음합니다
이 애플리케이션은 USB 또는 TCP/IP로 연결된 Android 기기의 화면과 오디오를 미러링하고, 컴퓨터의 키보드와 마우스로 제어할 수 있게 해줍니다. 기기에 루트 권한이나 별도 앱 설치가 필요하지 않습니다. Linux, Windows, _macOS_에서 작동합니다.

초점을 맞춘 점:
기능은 다음과 같습니다:
Android 기기는 최소 API 21(Android 5.0)이 필요합니다.
오디오 전달은 API >= 30(Android 11+)에서 지원됩니다.
기기에서 USB 디버깅을 활성화했는지 확인하세요.
일부 기기(특히 Xiaomi)에서는 다음과 같은 오류가 발생할 수 있습니다:
Injecting input events requires the caller (or the source of the instrumentation, if any) to have the INJECT_EVENTS permission.
이 경우 키보드와 마우스로 제어하려면 USB 디버깅 (보안 설정) (이는 USB 디버깅과 다른 항목입니다) 옵션을 추가로 활성화해야 합니다. 이 옵션을 설정한 후에는 기기를 재부팅해야 합니다.
OTG 모드에서 scrcpy를 실행할 때는 USB 디버깅이 필요하지 않습니다.
scrcpy -m1024)BACK 실행HOME 실행많은 옵션이 있으며, 별도 페이지에 문서화되어 있습니다. 여기서는 일반적인 예시 몇 가지를 소개합니다.
H.265(더 나은 품질)로 화면 캡처, 크기 1920 제한, 프레임률 60fps 제한, 오디오 비활성화, 물리적 키보드 시뮬레이션으로 제어:
scrcpy --video-codec=h265 --max-size=1920 --max-fps=60 --no-audio --keyboard=uhid
scrcpy --video-codec=h265 -m1920 --max-fps=60 --no-audio -K # short version
기기 디스플레이와 별도인 새로운 가상 디스플레이에서 VLC 실행:
scrcpy --new-display=1920x1080 --start-app=org.videolan.vlc
새로운 플렉스 디스플레이에서 H.265, 비트레이트 16Mbps로 VLC 실행, 디스플레이를 계속 켜 둠:
scrcpy --new-display -x --keep-active --start-app=org.videolan.vlc --video-codec=h265 -b16M
기기 카메라를 H.265, 1920x1080(마이크 포함)으로 MP4 파일에 녹화:
scrcpy --video-source=camera --video-codec=h265 --camera-size=1920x1080 --record=file.mp4
기기의 전면 카메라를 캡처하여 컴퓨터의 웹캠으로 노출(Linux):
scrcpy --video-source=camera --camera-size=1920x1080 --camera-facing=front --v4l2-sink=/dev/video2 --no-playback
물리적 키보드와 마우스 시뮬레이션으로 미러링 없이 기기 제어(USB 디버깅 불필요):
scrcpy --otg
컴퓨터에 연결된 게임패드로 기기 제어:
scrcpy --gamepad=uhid
scrcpy -G # short version
이 애플리케이션은 다양한 기능과 설정 옵션을 제공합니다. 다음 페이지에 문서화되어 있습니다:
버그 리포트, 기능 요청, 일반 질문은 이슈를 열 수 있습니다.
버그 리포트의 경우 먼저 FAQ를 읽어보시면 즉시 해결 방법을 찾을 수 있습니다.
다음도 사용할 수 있습니다:
r/scrcpy@scrcpy.bsky.social@scrcpy_app저는 _scrcpy_의 저자이자 유지관리자인 @rom1v입니다.