본문으로 건너뛰기
오픈소스 전체 목록

DroidDeck

  • 추천0
  • GitHub 별21K
  • 게임라이선스GPL-3.0

안드로이드에서 스팀 게이밍 모드와 리눅스 데스크톱을 쓰는 앱. GOG·Epic·Xbox 연동, 스팀 VR 지원(GPL-3.0)

원본:Droid-Deck/DroidDeck

요약

안드로이드에서 스팀 게이밍 모드와 리눅스 데스크톱을 쓰는 앱. GOG·Epic·Xbox 연동, 스팀 VR 지원(GPL-3.0)

설명

DroidDeck 배너

DroidDeck는 SteamOS 경험을 안드로이드로 가져옵니다. Steam 게이밍 모드, 완전한 리눅스 데스크톱, GOG · Epic Games · Xbox 등 스토어 연동, Steam VR 등을 지원합니다!

100% 오픈소스. 광고 없음. 텔레메트리 없음. 독점 구성 요소 없음. 숨긴 소스 없음.

DroidDeck 0.7.1 APK 다운로드 DroidDeck Discord 참여

Star History 순위

Droid-Deck/DroidDeck | Trendshift (C) Droid-Deck/DroidDeck | Trendshift (Kotlin)

Retroid Pocket Duo에서: DroidDeck 런처에서 Steam을 실행하고, Steam Big Picture에서 팩맨을 열어 플레이한 뒤 게임을 종료하고, 전원 메뉴에서 데스크톱으로 전환하는 모습

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

라이브러리에서 소스 칩을 바꾸고, 카드 크기를 조절하고, 필터 메뉴를 여는 모습 화면 컨트롤과 함께 Proton으로 실행되는 Windows 게임 휴대용 기기 하나에서 컨트롤러 두 개로 화면을 나눠 플레이하는 모습 Discover가 열린 Kubuntu 데스크톱

설치

  1. Adreno 730 이상 또는 아무 8xx 계열의 Android 9 이상. Adreno 6xx, Mali, Xclipse, PowerVR은 실험적입니다. Adreno 710은 현재 지원하지 않습니다. 루트는 필요 없습니다.
  2. 런타임용으로 약 3GB, 데스크톱과 에뮬레이터용으로 1.1GB의 여유 공간이 필요합니다.
  3. APK를 설치하고, 리눅스 런타임을 설치한 뒤, Play를 누르고 Steam에 로그인합니다.
  4. 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으로 확인했으며, 그 코드는 가져오지 않았습니다.

스마트 안경

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

Star history 차트

저장소: https://github.com/Droid-Deck/DroidDeck

평점

–평가 0개 기준
5점
0
4점
0
3점
0
2점
0
1점
0