DroidDeck
- 추천0
- GitHub 별21K
- 게임라이선스GPL-3.0
안드로이드에서 스팀 게이밍 모드와 리눅스 데스크톱을 쓰는 앱. GOG·Epic·Xbox 연동, 스팀 VR 지원(GPL-3.0)
요약
안드로이드에서 스팀 게이밍 모드와 리눅스 데스크톱을 쓰는 앱. GOG·Epic·Xbox 연동, 스팀 VR 지원(GPL-3.0)
설명
DroidDeck는 SteamOS 경험을 안드로이드로 가져옵니다. Steam 게이밍 모드, 완전한 리눅스 데스크톱, GOG · Epic Games · Xbox 등 스토어 연동, Steam VR 등을 지원합니다!
100% 오픈소스. 광고 없음. 텔레메트리 없음. 독점 구성 요소 없음. 숨긴 소스 없음.

공식 웹사이트는 droid-deck.dev입니다. DroidDeck는 이 저장소의 Releases에서만 내려받으세요.

설치
- Adreno 730 이상 또는 아무 8xx 계열의 Android 9 이상. Adreno 6xx, Mali, Xclipse, PowerVR은 실험적입니다. Adreno 710은 현재 지원하지 않습니다. 루트는 필요 없습니다.
- 런타임용으로 약 3GB, 데스크톱과 에뮬레이터용으로 1.1GB의 여유 공간이 필요합니다.
- APK를 설치하고, 리눅스 런타임을 설치한 뒤, Play를 누르고 Steam에 로그인합니다.
- Android 14 이상에서는 개발자 옵션의 Disable child process restrictions를 켭니다. Android 12와 13에서는 Steam을 처음 실행할 때 Fix it for me 버튼이 나와 설정 과정을 안내합니다.
스마트 안경 설정은 지원 표에 있습니다. 릴리스 노트는 docs/releases에 있습니다.
도움말, 미리보기 빌드, 기기 보고는 Discord에서 받습니다. 버그는 #bug-reports에 Share logs로 만든 zip과 함께 올려 주세요.
빌드
Docker, Java 17, Android SDK와 NDK, rustup으로 설치한 Rust, Go, 호스트 C 컴파일러, x86_64와 i686 MinGW-w64 컴파일러(i686은 Debian과 Ubuntu가 제공하는 DWARF-2 예외 방식이어야 합니다. Homebrew 같은 SJLJ 빌드는 Rust의 i686-pc-windows-gnu를 링크하지 못합니다), GitHub CLI, Python 3, zstd가 필요합니다. x86_64 Linux에서는 Docker에 arm64 binfmt 핸들러도 필요합니다(docker run --privileged --rm tonistiigi/binfmt --install arm64).
tools/build_local.sh
APK는 app/build/outputs/apk/release/에 생깁니다. tools/deploy_local.sh로 설치합니다. 처음 실행한 뒤에는 ./gradlew :app:assembleRelease가 준비된 입력을 재사용합니다. 단위 테스트는 ./gradlew -PskipRust=true :app:testDebugUnitTest로, 헬퍼와 프리로드 테스트는 bash tools/test_local.sh로 실행합니다.
Windows에서는 tools/run_windows.ps1과 tools/prepare_windows_runtime.py를 보세요.
한계
호환성과 성능은 기기마다 다릅니다. 데스크톱 합성은 소프트웨어 렌더링이고, proot 아래에서는 Firefox 샌드박스가 줄어듭니다.
크레딧과 라이선스
DroidDeck는 GPL-3.0입니다. Steam과 Proton은 Valve Corporation의 것입니다. VITURE, RayNeo, XREAL, Rokid, REDMAGIC, Nintendo Switch, Joy-Con은 각 소유자의 상표입니다. 이 프로젝트는 그 어느 곳과도 관련이 없습니다.
런타임, Wine, Proton
- 런타임, 심(shim), 입력, 컨트롤러 작업은 maxjivi05의 WinNative와 Bannerlator 위에 만들었습니다.
- mmap 링 버퍼 컨트롤러 입력은 ribbit384가 만들었습니다(WinNative #345).
- FEX(MIT)가 x86 코드를 실행합니다. DroidDeck의 빌드는 플랫폼 이름을
AT_PLATFORM아래에 넣어, VHSgunzo의 sharun AppImage(MIT)가 그 userland-execve 로더(MIT)로 시작되게 하고, GL thunk는 X 오류를 프로그램 자신의 오류 처리기에 넘깁니다. FEX의 코드 디스크 캐시는 소스에서 확인했습니다. - x86 AppImage와, 런타임이 안드로이드에서 풀리지 않는 arm64 AppImage는 VHSgunzo의 uruntime(MIT)으로 풉니다. 수정 없이 라이선스와 함께 넣었습니다.
- OpenSSL 3을 링크하는 x86 프로그램은 Steam Linux Runtime 4.0에 든 것을 씁니다. x86 리눅스 게임은 pressure-vessel이 쓰는
/etc/asound.conf를 받습니다. WriteProcessMemory훅은 Wine 11 이전에 Wine의server/ptrace.c가 하던 방식대로/proc/<pid>/mem으로 되돌아갑니다.- noexec 저장소의 Windows 프로그램은 이미지 페이지의 실행 가능한 복사본을 받습니다. Wine 자신의 프로세스에 noexec 심이 필요하다는 @yujikaido의 droiddeck-rp4pro 발견을 따랐습니다.
- Wine 쓰기 감시는 Proton의
dlls/ntdll/unix/virtual.c(LGPL-2.1-or-later)에 있는 userfaultfd 지원을 씁니다. libddsession이 arm64 시스템 호출 번호를 제공하고/proc/self/pagemap으로PAGEMAP_SCAN에 답합니다. - libddsession은 Wine의 arm64
SIGUSR2컨텍스트 핸들러(dlls/ntdll/unix/signal_arm64.c, LGPL-2.1-or-later)를 Linux의arch/arm64/kernel/signal.c처럼 배치한 프레임 위에서 그 자리에서 실행하고,dlls/ntdll/unix/process.c의fill_vm_counters에는 커널의/proc/<pid>/status를 그대로 제공합니다. - droiddeck-ntsync는
Documentation/userspace-api/ntsync.rst(GPL-2.0)에 있는 Linux ntsync 의미를 따릅니다. - proot 빠른 경로는 PRoot의
path/binding.c(GPL-2.0-or-later)처럼 바인딩 순서를 정합니다. - DiRT 3과 DiRT Showdown은 Carsten Gottschling의 수정에 바탕한 RoccoC의 DiRTTelemetryErrorFix(MIT)와 같은 방식으로 텔레메트리 소켓을 유지합니다.
- PowerVR의 Zink는 Icenowy Zheng의 업스트림 Mesa 수정 d55418dae7(MIT)을 런타임 패치로 실어 컬러 텍스처를 컬러로 유지합니다.
- 게임과 에뮬레이터 같은 AppImage · Flatpak · Snap 프로그램은 Steam 클라이언트처럼 기본으로
TU_DEBUG=sysmem을 씁니다. Turnip sysmem 렌더링은 성능 설정에서 끌 수 있지만, 항상 이를 쓰는 Adreno 710/720 드라이버는 예외입니다. - Black Ops III와 Dark Souls Remastered는 ARM64 Proton에서 실패하는
311210.py와570940.py가 든 umu-protonfixes(BSD-2-Clause) 없이 시작합니다. - Dingo Shenanigans의 ReSkate(GPL-3.0)는 README의 실행 옵션과 D3D12 기능 수준 12_1을 씁니다.
- arm64 클라이언트의 로그인은 deadlock-api-ingest의
ConnectCache형식으로 Steam에 저장된 토큰을 읽어 확인했습니다.
스토어
- Epic Games와 GOG는 Phobos가 Legendary와 gogdl을 고쳐 쓴 것 위에 만들었습니다. GOG 설치 스크립트 레지스트리 항목은 Heroic Games Launcher(GPL-3.0)가 읽는 방식대로 읽습니다. GOG 클라우드 저장소 요청은 gogdl과 Lutris(GPL-3.0)가 보내는 Galaxy 통신 서비스 User-Agent를 보냅니다.
- Epic의 공식 리눅스 런처 미리보기는 FEX로 실행됩니다. 이 구성은 Epic이 공개한 리눅스 지원 범위 밖입니다.
- 런처의 .deb는 필요한 WebKitGTK와 GTK 3 라이브러리를 수정하지 않은 Debian 13 패키지에서 받습니다. #2268에 있는 @zooluis의 조사를 따랐습니다.
- Battle.net은 @kayakyakr가 만들었습니다. Blizzard의 자체 클라이언트를 Proton에서 실행하며(Blizzard에서 내려받고, 포함하지 않습니다) Battle.net Shop의 키 아트를 보여 줍니다. Steam 없이는 게임이 Proton의
dlls/winebus.sys에 있는PROTON_SPOOF_STEAMINPUT_VIDPID로 패드를 Xbox 360 컨트롤러로 인식합니다. - EA 스토어는 ArmchairDevelopers의 Maxima(GPL-3.0)가 문서화한 EA 앱 프로토콜을 따릅니다. 로그인, GraphQL 쿼리(EA가 해시로 맞추므로 원문 그대로 포함), 빌드 아카이브, 온라인 활성화 라이선스, LSX 게임 엔드포인트입니다. 코드는 DroidDeck 자체 것입니다.
- Battle.net 설치는 @barncastle의 Battle.Net-Installer처럼, wowdev.wiki의 요청으로 Blizzard의 Agent를 구동합니다. 코드를 가져오지 않고 읽기만 한 것: @mubaraknumann의 unifideck, @djmittens의 neo-mittens
bnetswitch, @BCD1210의 soju, Lutris의product.db리더. - Rockstar 런처 서비스는 게임 옆의 실행 파일에서 런처 파이프 이름을 찾습니다. CitizenFX의
ros-patches-five가 GTA V가GTAVLauncher_Pipe를 여는 것을 보여 주고, @pingod의 rdr2-linux-launcher가 Rockstar의 보호된 실행 파일은 그런 문자열을 실행 중에만 해석한다고 적었기 때문입니다. 코드는 가져오지 않고 읽기만 했습니다. - 월드 오브 워크래프트 애드온 가져오기는 WowUp처럼 임시 복사본으로 애드온 폴더를 교체하고, WoWDeck처럼 플레이버 폴더를 읽습니다. 둘의 코드는 쓰지 않았습니다.
- 월드 오브 워크래프트 애드온 다운로드 창은 WoWInterface를 MMOUI API로 검색합니다. CurseForge는 API와 키 없이 사용자의 브라우저에서 열립니다.
- Xbox 스토어는 @domsvoboda의 nexus-backend 0.2.15(GPL-3.0, Xodus의 포크)를 실행하고, Xbox 게임은 그의 nexus-runtime(LGPL-2.1-or-later)의 Windows 모듈, 곧 C++ nexus-xgameruntime과
wintypes.dll을 불러옵니다. 콘텐츠 라이선스는 nexus-backend의 스토어 라이선스 경로(커밋27c335e)처럼 위임 압축 기기 티켓을 라이선스 전송 형식으로 보냅니다. Minecraft의 GameInput 설정은 @Wyze3306의 BedrockOnLinux(MIT)와 대조해 확인했습니다. - Xbox 클라우드 게이밍 플레이어는 @unknownskl의 Greenlight(MIT) WebRTC 클라이언트를 쓰고, 제안(offer) 조정과 선명화는 @redphx의 Better xCloud(MIT)를 따릅니다.
tools/xcloud-player/NOTICE.md를 보세요. - itch.io butler 팩에는 butler의
7z.so, 곧 Igor Pavlov의 7-Zip을 itch.io가 빌드한 것(LGPL-2.1, RAR 코드에는 unRAR 제한)이 수정 없이 들어 있습니다. 다른 아카이브는 Apache Commons Compress와 런타임의 bsdtar(libarchive)를 씁니다. - 스토어는 DroidDeck 자체의 bubblewrap 심을 통해 Flatpak(LGPL-2.1)을 씁니다. Chromium과 Electron 앱은 @refi64의 zypak(BSD-3-Clause)이 항상 Flatpak의 스폰 포털을 쓰기 때문에 직접 시작합니다.
- 폴더 동기화는 @researchxxl의 syncthing-android 포크(MPL-2.0)에서 빌드한 Syncthing(MPL-2.0)을 실행합니다.
오디오, 비디오, HUD
- Steam 오디오는 @The412Banner의 DirectAudio PulseAudio 싱크(LGPL-2.1-or-later)를 거치며,
tools/directaudio/sink에서 빌드합니다. - DroidDeck HUD는 @The412Banner의 FusionHUD(출처 표기 조항이 붙은 GPL-3.0)입니다. 측정값은 Valve의 MangoHud 빌드(MIT)와 맞고, 프레임 시간은 gamescope 패치 0125에서 가져옵니다.
- HUD의 CPU, GPU 부하, 온도, 배터리 읽기는 @xXJSONDeruloXx의 작업에서 왔습니다.
- LSFG 프레임 생성은 Camille LaVey와 Eden 프로젝트에서 왔고, lsfg-vk를 따라 @maxjivi05가 이식했습니다. 내 Lossless Scaling 사본이 필요하며 그 셰이더는 포함하지 않습니다.
- 블랙 프레임 삽입은 @artzox의 BFI Presenter(GPL-3.0) 설계를 따릅니다. 스트로브는 디스플레이의 주사율 클록에서 돌고 게임은 켜진 주사율에 맞춰 속도를 조절합니다. 둘 다 Blur Busters의 MPRT와 모션 블러 연구 위에 있습니다. BFI Presenter의 코드는 쓰지 않았습니다.
- 원격 플레이는 안드로이드의 MediaCodec이나 Steam 런타임에 든 FFmpeg(LGPL-2.1-or-later)로 디코딩합니다. Qualcomm 저지연 설정은 Moonlight(GPL-3.0)를 따릅니다.
- PipeWire(MIT) 소켓은 그
module-access.c의 설정을 쓰고, WirePlumber(MIT)는 그 클라이언트들에게 전체 권한을 유지합니다.
데스크톱
- KDE pacman 저장소는 Arch Linux ARM의 스냅숏이며 pacman(GPL-2.0-or-later)으로 설치합니다.
- KWin(GPL-2.0-or-later)은
wayland_backend.cpp가 TODO로 남겨 둔 스크롤 데이터를 넘기도록 패치했습니다. - 코드를 가져오지 않고 읽기만 한 것: Qt의
qwaylandinputdevice.cpp와qguiapplication.cpp, Konsole의TerminalDisplay.cpp, Mesa의u_threaded_context.c와zink_resource.c. - Steam 키보드 창 규칙은 Valve의
steamdeck-kde-presets와 Bazzite의0001-steam-virtual-keyboard.patch를 따릅니다. - Steam의 찾아보기 버튼은 PyGObject(LGPL-2.1-or-later)로 GTK 3 파일 선택기를 열고, gamescope(BSD-2-Clause)가
GetAppIdFromReaper로 Steam 위에 보여 줍니다. - AYN Odin 2의 가짜 두 번째 디스플레이는 @SapphireRhodonite의 WatermelonDS 0.0.5 노트와 iiSU #363으로 확인했으며, 그 코드는 가져오지 않았습니다.
스마트 안경
- WinNative의 VITURE 작업 위에 만들었습니다. 프로토콜은 @wheaney의 XRLinuxDriver, @badicsalex의 ar-drivers-rs, go-macos/iokit와 대조했습니다. 선택 사항인 VITURE SDK는 포함하지 않습니다.
- VITURE 프로토콜 V2 프레임은 Holger Bartnick의 @elasticjava viture-v2(MIT)를 고쳐 썼습니다.
docs/third-party/viture-v2를 보세요. - RayNeo는 @informalTechCode의 RayNeo-Air-Series-3DoF-Scaffold(Apache-2.0)를 고쳐 쓰고, @verncat의 RayNeo-Air-3S-Pro-OpenVR(MIT)와 Monado(BSL-1.0)를 참고합니다. docs/third-party/rayneo를 보세요.
- XREAL 1S는 @wheaney의 XRLinuxDriver와 xrealOneDeviceKit, @rohitsangwan01의 xreal_one_driver(MIT), @0xcaff의 xr-tools를 참고합니다.
- Rokid는 ar-drivers-rs, @badicsalex의 Void Computing 글, Monado의 Rokid 드라이버를 따릅니다.
- REDMAGIC 디스플레이 관련 발견은 @mekhontsev의 MagicDesk 조사와 @Coding-BR의 디컴파일한 Nubia 커널을 바탕으로 했습니다.
VR, Joy-Con, 손 추적
- Joy-Con VR은 Google의 GVR SDK for Unity(Apache-2.0)에서 팔 모델을 가져오고, Valve의 OpenVR
handskeletonsimulation샘플(BSD-3-Clause)에서 손 골격을 고쳐 씁니다. 이 샘플은 Monado에 있는 Moshi Turner의 작업을 따릅니다. Index 오프셋은 Monado의vive_poses.c(BSL-1.0)에서 왔습니다. - Joy-Con 조사: Daniel J. Ogorchock의 Linux hid-nintendo, @dekuNukem의 Nintendo_Switch_Reverse_Engineering, SDL, AOSP. ALVR, OpenComposite, PSMoveSteamVRBridge, @F8LEFT의 JoyConVr, @krnelpan1c의 Daydream-Controller-SteamVR, @yoyobuae의 joyconvr, Moonlight, Dolphin과 대조했습니다. docs/third-party/joycon을 보세요.
- 카메라 손 추적은 CameraX 프레임(Apache-2.0) 위에서 Google의 MediaPipe Pose Landmarker(Lite), BlazePose GHUM 3D, Hand Landmarker(Apache-2.0)를 실행하며 사용 보고는 꺼져 있습니다. JoyConVr의 카메라 앱(MIT)과 대조했습니다.
- 추적 수학: GVR 팔 모델의 가속도계 모드, Eric Foxlin의 영속도 갱신, Frosio · Pedersini · Borghese의 가속도계 자동 보정, 칼만 필터(Kalman, 1960), Horn의 쿼터니언 방법(1987), 1€ 필터(Casiez, Roussel, Vogel, 2012).
- 제스처는 ALVR의
hand_gestures.rs(MIT)와 Meta Quest의 메뉴 핀치를 따르며, HaGRID 사진(CC BY-SA 4.0, 포함하지 않음)으로 조정했습니다. - 장갑 모델은 OpenVR의 렌더 모델 참조를 따르고, 서피스 네트(Gibson, 1998; Mikola Lysenko)로 메시를 만들며, Inigo Quilez의 스무스 최솟값, 거리장 앰비언트 오클루전, 다각형 거리(MIT)를 씁니다. docs/third-party/handtracking을 보세요.
Star history
평점
- 5점
- 0
- 4점
- 0
- 3점
- 0
- 2점
- 0
- 1점
- 0