프로젝트 소개

QtScrcpy는 컴퓨터에서 USB 또는 로컬 네트워크를 통해 안드로이드 기기를 표시하고 제어하는 오픈 소스 데스크톱 애플리케이션입니다. 루트 권한이 필요하지 않으며 GNU/Linux, Windows, macOS에서 실행됩니다. 이 프로젝트는 Genymobile의 scrcpy를 기반으로 하며, C++/Qt/OpenGL/FFmpeg 스택으로 재구현되었고 Apache 2.0 라이선스를 따릅니다. README에 설명된 핵심 기능: - 안드로이드 기기 화면의 실시간 표시. 목표로 제시된 사양은 30–60 fps, 1920×1080 이상 해상도, 낮은 지연 시간(35–70 ms), 첫 프레임까지 약 1초입니다. - 멀티터치 지원을 포함한 기기의 실시간 마우스 및 키보드 제어. - 화면 녹화 및 PNG 스크린샷. 창을 표시하지 않는 백그라운드 녹화도 포함됩니다. - 동일 LAN을 통한 무선 연결. ADB 디버깅 활성화, adbd 시작, 기기 IP로 연결하는 단계가 문서화되어 있습니다. - 여러 기기 동시 연결 및 그룹 제어. 하나의 입력을 여러 휴대폰에 동시에 적용할 수 있습니다. - 파일을 비디오 창으로 끌어다 놓는 방식의 파일 전송 및 APK 설치. - 컴퓨터와 기기 간 양방향 클립보드 동기화(일부 작업은 Android 7+ 필요). - sndcpy 기반으로 기기 스피커에서 컴퓨터로 오디오 전달. Android 10+로 제한됩니다. - 키보드와 마우스 동작을 기기 터치와 클릭으로 변환하는 사용자 지정 키 매핑 스크립트. 일부 게임용 기본 스크립트가 제공되며, 사용자는 keymap 디렉터리에 자신만의 스크립트를 추가할 수 있습니다. - 전체 화면, 창 크기 조정, HOME/BACK/APP_SWITCH/MENU, 볼륨, 전원, 알림 패널, 클립보드 작업을 위한 키보드 단축키 모음. 요구 사항 및 사용 참고: Android API 21(Android 5.0) 이상, 기기에서 ADB 디버깅 활성화, 무선 사용 시 휴대폰과 PC가 동일 LAN에 있어야 합니다. Windows와 macOS용으로 ADB가 포함된 사전 빌드 패키지가 제공되며, Linux 사용자는 AUR 패키지나 사전 빌드 아카이브를 사용할 수 있습니다. 소스에서 빌드하려면 Qt 5.12 이상과 CMake 또는 qmake가 필요하며, Android 서버 구성 요소는 Android Studio로 별도 빌드합니다. README는 또한 작성자가 별도의 상용 도구인 QuickMirror와 QuickAssistant를 개발한다고 언급합니다. 여기에는 일괄 캐스팅, OTG 미러링, 인터페이스 기반 키 매핑 편집, 스크린샷/녹화 같은 추가 기능이 있습니다. 이들은 QtScrcpy 저장소 자체의 일부가 아닙니다.