
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입니다.
이 애플리케이션이 마음에 드신다면 제 오픈 소스 작업을 지원해 주실 수 있습니다:
Copyright (C) 2018 Genymobile
Copyright (C) 2018-2026 Romain Vimont
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.