scrcpy

KO | EN

gitlite — search

#javascript #python #react #ai #golang #machine-learning #rust #awesome #kubernetes #vue #pytorch #security #openai #mcp

(★ 147,767)

Android 기기를 화면에 표시하고 제어하세요

scrcpy 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

> [!WARNING]
> **이 GitHub 저장소(<https://github.com/Genymobile/scrcpy>)만이 이 프로젝트의 유일한 공식
> 출처입니다. 이름에 `scrcpy`가 포함되어 있더라도, 출처가 불분명한 웹사이트에서 릴리즈를
> 다운로드하지 마세요.**

# scrcpy (v4.1)

_발음: "**scr**een **c**o**py**"_

이 애플리케이션은 USB나 [TCP/IP](doc/connection.md#tcpip-wireless)를 통해 연결된 Android 기기의 화면(비디오 및 오디오)을 미러링하고 컴퓨터의 키보드와 마우스로 제어할 수 있게 해줍니다. _root_ 권한이나 기기에 앱을 설치할 필요가 없습니다. _Linux_, _Windows_, _macOS_에서 작동합니다.

[![Linux](https://img.shields.io/badge/Linux-download-orange?style=for-the-badge&logo=linux)](https://raw.githubusercontent.com/Genymobile/scrcpy/master/doc/linux.md)&nbsp;
[![Windows](https://img.shields.io/badge/Windows-download-blue?style=for-the-badge&logo=windows)](https://raw.githubusercontent.com/Genymobile/scrcpy/master/doc/windows.md)&nbsp;
[![macOS](https://img.shields.io/badge/macOS-download-brightgreen?style=for-the-badge&logo=apple)](https://raw.githubusercontent.com/Genymobile/scrcpy/master/doc/macos.md)&nbsp;

![screenshot](https://raw.githubusercontent.com/Genymobile/scrcpy/master/assets/screenshot-debian-600.jpg)

주요 특징은 다음과 같습니다:

- **가벼움**: 네이티브 방식이며, 기기 화면만 표시합니다.
 - **성능**: 기기에 따라 30~120fps 지원
 - **고화질**: 1920×1080 이상
 - **낮은 지연 시간**: [35~70ms][lowlatency]
 - **빠른 시작 시간**: 첫 번째 이미지가 표시되는 데 약 1초 소요
 - **비침해성**: Android 기기에 아무것도 남기지 않고 설치되지 않습니다.
 - **사용자 친화적**: 계정, 광고, 인터넷 연결 불필요
 - **자유로움**: 무료 오픈 소스 소프트웨어

[lowlatency]: https://github.com/Genymobile/scrcpy/pull/646

제공하는 기능은 다음과 같습니다:
 - [오디오 전달](doc/audio.md) (Android 11 이상)
 - [녹화](doc/recording.md)
 - [가상 디스플레이](doc/virtual-display.md)
 - [Android 기기 화면이 꺼진 상태](doc/device.md#turn-screen-off)에서의 미러링
 - 양방향 [복사-붙여넣기](doc/control.md#copy-paste)
 - [설정 가능한 화질](doc/video.md)
 - [카메라 미러링](doc/camera.md) (Android 12 이상)
 - [웹캠으로 미러링 (V4L2)](doc/v4l2.md) (Linux 전용)
 - 물리적 [키보드][hid-keyboard] 및 [마우스][hid-mouse] 시뮬레이션 (HID)
 - [게임패드](doc/gamepad.md) 지원
 - [OTG 모드](doc/otg.md)
 - 기타 기능…

[hid-keyboard]: doc/keyboard.md#physical-keyboard-simulation
[hid-mouse]: doc/mouse.md#physical-mouse-simulation

## 사전 요구 사항

Android 기기는 최소 API 21(Android 5.0) 이상이 필요합니다.

[오디오 전달](doc/audio.md)은 API 30 이상(Android 11 이상)에서 지원됩니다.

기기에서 [USB 디버깅을 활성화][enable-adb]했는지 확인하세요.

[enable-adb]: https://developer.android.com/studio/debug/dev-options#enable

일부 기기(특히 Xiaomi)에서는 다음과 같은 오류가 발생할 수 있습니다:

```
Injecting input events requires the caller (or the source of the instrumentation, if any) to have the INJECT_EVENTS permission.
```

이 경우, 키보드와 마우스로 제어하려면 `USB 디버깅`과 다른 항목인 [추가 옵션][control]인 `USB 디버깅(보안 설정)`을 활성화해야 합니다. 이 옵션을 설정한 후에는 기기를 재부팅해야 합니다.

[control]: https://github.com/Genymobile/scrcpy/issues/70#issuecomment-373286323

[OTG 모드](doc/otg.md)에서 scrcpy를 실행할 때는 USB 디버깅이 필요하지 않습니다.

## 앱 다운로드

- [Linux](doc/linux.md)
 - [Windows](doc/windows.md) ([실행 방법](doc/windows.md#run) 참조)
 - [macOS](doc/macos.md)

## 필수 팁

- [해상도 낮추기](doc/video.md#size)를 통해 성능이 크게 향상될 수 있습니다 (`scrcpy -m1024`)
 - [_우클릭_](doc/mouse.md#mouse-bindings)은 `BACK`을 실행합니다.
 - [_휠 클릭_](doc/mouse.md#mouse-bindings)은 `HOME`을 실행합니다.
 - <kbd>Alt</kbd>+<kbd>f</kbd>를 누르면 [전체 화면](doc/window.md#fullscreen)이 토글됩니다.
 - 그 외에도 많은 [단축키](doc/shortcuts.md)가 있습니다.

## 사용 예시

다양한 옵션이 있으며, 별도의 페이지에 [문서화](#user-documentation)되어 있습니다.
다음은 몇 가지 일반적인 예시입니다.

- 화면을 H.265로 캡처하고(더 나은 화질), 크기를 1920으로 제한하고, 프레임 레이트를 60fps로 제한하며, 오디오를 비활성화하고, 물리적 키보드를 시뮬레이션하여 기기를 제어합니다:

```bash
    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  # 짧은 버전
    ```

- 새 가상 디스플레이에서 VLC를 시작합니다(기기 디스플레이와 분리됨):

```bash
    scrcpy --new-display=1920x1080 --start-app=org.videolan.vlc
    ```

- 16 Mbps 비트레이트의 H.265를 사용하여 새로운 _flex_ 디스플레이에서 VLC를 시작하고, 화면이 꺼지지 않도록 디스플레이를 활성 상태로 유지합니다:

```bash
    scrcpy --new-display -x --keep-active --start-app=org.videolan.vlc --video-codec=h265 -b16M
    ```

- 기기 카메라를 1920x1080 해상도의 H.265(및 마이크)로 MP4 파일에 녹화합니다:

```bash
    scrcpy --video-source=camera --video-codec=h265 --camera-size=1920x1080 --record=file.mp4
    ```

- 기기의 전면 카메라를 캡처하여 컴퓨터에서 웹캠으로 노출합니다(Linux 전용):

```bash
    scrcpy --video-source=camera --camera-size=1920x1080 --camera-facing=front --v4l2-sink=/dev/video2 --no-playback
    ```

- 물리적 키보드와 마우스를 시뮬레이션하여 미러링 없이 기기를 제어합니다(USB 디버깅 불필요):

```bash
    scrcpy --otg
    ```

- 컴퓨터에 연결된 게임패드를 사용하여 기기를 제어합니다:

```bash
    scrcpy --gamepad=uhid
    scrcpy -G  # 짧은 버전
    ```

## 사용자 문서

이 애플리케이션은 다양한 기능과 설정 옵션을 제공합니다. 이들은 다음 페이지에 문서화되어 있습니다:

- [연결](doc/connection.md)
 - [비디오](doc/video.md)
 - [오디오](doc/audio.md)
 - [제어](doc/control.md)
 - [키보드](doc/keyboard.md)
 - [마우스](doc/mouse.md)
 - [게임패드](doc/gamepad.md)
 - [기기](doc/device.md)
 - [창](doc/window.md)
 - [녹화](doc/recording.md)
 - [가상 디스플레이](doc/virtual-display.md)
 - [터널](doc/tunnels.md)
 - [OTG](doc/otg.md)
 - [카메라](doc/camera.md)
 - [Video4Linux](doc/v4l2.md)
 - [단축키](doc/shortcuts.md)

## 리소스

- [FAQ](FAQ.md)
 - [번역][wiki] (최신 상태가 아닐 수 있음)
 - [빌드 방법](doc/build.md)
 - [개발자](doc/develop.md)
 - [릴리즈 서명 확인](doc/verify-release.md)

[wiki]: https://github.com/Genymobile/scrcpy/wiki

## 아티클

- [scrcpy 소개][article-intro]
- [이제 무선으로 작동하는 Scrcpy][article-tcpip]
- [오디오를 지원하는 Scrcpy 2.0][article-scrcpy2]

[article-intro]: https://blog.rom1v.com/2018/03/introducing-scrcpy/
[article-tcpip]: https://www.genymotion.com/blog/open-source-project-scrcpy-now-works-wirelessly/
[article-scrcpy2]: https://blog.rom1v.com/2023/03/scrcpy-2-0-with-audio/

## 연락처

버그 신고, 기능 요청 또는 일반적인 질문은 [issue]를 열어주세요.

버그 신고의 경우, 먼저 [FAQ](FAQ.md)를 읽어보시면 문제에 대한 해결책을 바로 찾으실 수도 있습니다.

[issue]: https://github.com/Genymobile/scrcpy/issues

다음 채널도 이용하실 수 있습니다:

- Reddit: [`r/scrcpy`](https://www.reddit.com/r/scrcpy)
 - BlueSky: [`@scrcpy.bsky.social`](https://bsky.app/profile/scrcpy.bsky.social)
 - Twitter: [`@scrcpy_app`](https://twitter.com/scrcpy_app)

## 기부

저는 _scrcpy_의 작성자이자 메인테이너인 [@rom1v](https://github.com/rom1v)입니다.

이 애플리케이션이 마음에 드신다면, [제 오픈 소스 작업을 후원][donate]하실 수 있습니다:
 - [GitHub Sponsors](https://github.com/sponsors/rom1v)
 - [Liberapay](https://liberapay.com/rom1v/)
 - [PayPal](https://paypal.me/rom2v)

[donate]: https://blog.rom1v.com/about/#support-my-open-source-work

## 라이선스

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.

scrcpy

scrcpy 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

scrcpy

scrcpy 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README