01
라이브러리
게임을 최대 48개까지 담습니다. 각 게임은 sce_sys/param.json의 이름과 sce_sys/icon0.png의 표지를 보여 줍니다. 그리드와 표를 전환하고, 이름·타이틀 ID·폴더로 검색하며, 게임 파일이나 저장 데이터를 건드리지 않고 항목을 지울 수 있습니다. 아래에는 “폴더 선택”, “PKG 추출”, “게임 실행”이 있습니다.
런처 · Windows와 Linux
모든 세션은 런처에서 시작합니다. 런처는 게임 라이브러리를 보관하고, 그래픽 드라이버를 확인하고, 입력과 화면 설정을 저장하고, 디버그 패키지를 추출한 뒤 그 설정으로 game-run을 실행합니다. Windows에서는 네이티브 Win32 인터페이스를, Linux에서는 같은 페이지를 가진 GTK 3 버전을 사용합니다.

네 개의 페이지
01
게임을 최대 48개까지 담습니다. 각 게임은 sce_sys/param.json의 이름과 sce_sys/icon0.png의 표지를 보여 줍니다. 그리드와 표를 전환하고, 이름·타이틀 ID·폴더로 검색하며, 게임 파일이나 저장 데이터를 건드리지 않고 항목을 지울 수 있습니다. 아래에는 “폴더 선택”, “PKG 추출”, “게임 실행”이 있습니다.
02
게임패드, 키보드를 DualSense로 사용, 또는 둘 다를 선택합니다. Windows에서는 DualSense와 DualShock 4를 USB나 Bluetooth로 직접 읽고, Xbox 호환 패드는 XInput 슬롯 1–4를 사용합니다. DualSense의 각 버튼에 키를 지정할 수 있으며, WASD는 왼쪽 스틱을, Alt + 방향키는 오른쪽 스틱을 조작합니다. “테스트”는 1초간 진동하고 라이트바 색을 차례로 바꿉니다.
03
어떤 게임을 선택했든 모든 로컬 저장 슬롯을 타이틀 ID별로 묶어 보여 주고 저장 폴더를 엽니다. 저장 데이터는 에뮬레이터 홈의 savedata/<titleId>/<slot>/에 있으며 명령줄에서 직접 실행할 때도 공유됩니다.
04
인터페이스 언어, 출력 해상도(1080p, 1440p, 4K, 8K, 기본값 1080p), “속도” 또는 “그래픽” 렌더링 프리셋, 사운드 출력, 게임 창 제목의 FPS 카운터, 게임이 제공하는 경우 성능 모드, 그리고 그래픽 API(Vulkan 또는 실험적인 DirectX 12). 해상도, 프리셋, API는 다음 실행부터 적용됩니다.


게임 전에
시작할 때 런처는 Vulkan 로더에 인스턴스와 장치를 요청합니다. GPU 이름과 API 버전을 보여 주거나, 런타임이 없거나 장치를 찾지 못했거나 드라이버가 1.2 미만이라고 알려 줍니다.
선택한 폴더와 그 하위의 decrypted 폴더에서 eboot.bin을 찾은 뒤, 폴더 전체를 /app0으로 마운트하고 game-run을 실행합니다.
Windows가 game-run.exe를 실행하지 않으면 런처가 예상 원인(스마트 앱 컨트롤, 보안 소프트웨어, 액세스 거부, 손상된 파일)을 설명하고, 버그 보고를 위해 Windows 오류 번호를 남깁니다.
“업데이트 확인”은 GitHub Releases에 최신 공개 버전을 묻고, 더 새로우면 링크를 보여 줍니다. Linux에서는 curl을 사용합니다.
그래픽 API
설정에 그래픽 API 카드가 있습니다. 선택은 ps5pcem.ini에 graphics_api=vulkan 또는 graphics_api=d3d12로 저장되고, 다음 실행 때 PS5_GRAPHICS_API로 game-run에 전달됩니다. 기본값은 Vulkan입니다. DirectX 12는 모든 언어에서 실험적이라고 표시되며, 사이드바는 Vulkan 상태 대신 DirectX 12를 보여 줍니다.

내부 동작
설정은 환경 변수로 실행기에 전달되므로, 같은 변수를 직접 지정하면 명령줄에서 바로 실행해도 똑같이 동작합니다.
| 변수 | 값 | 의미 |
|---|---|---|
| PS5_INPUT_MODE | controller | keyboard | hybrid | 입력 장치: 게임패드, 키보드 또는 둘 다 |
| PS5_CONTROLLER_INDEX | 0–3 | XInput 슬롯 |
| PS5_KEYMAP | cross=32,circle=69,… | DualSense 각 버튼에 지정한 키(가상 키 코드) |
| PS5_OUTPUT_RESOLUTION | 1080 | 1440 | 2160 | 4320 | 설정에서 고른 출력 해상도 |
| PS5_GRAPHICS_API | vulkan | d3d12 | 이번 실행의 렌더러: 기본값은 Vulkan이며, Windows 전용 실험적 DirectX 12 백엔드도 고를 수 있습니다(dx12도 허용). |
| PS5_PERFORMANCE_MODE | speed | graphics | “속도” 또는 “그래픽” 렌더링 프리셋 |
| PS5_GAME_PRESET | default | performance | 스위치가 켜져 있으면 게임의 성능 모드를 요청 |
| PS5_SHOW_FPS | 1 | 측정한 프레임 속도를 창 제목에 표시 |
| PS5_AUDIO_DISABLED | 1 | 호스트 사운드 출력을 끔(AudioOut 타이밍은 유지) |
설정 파일
Linux
0.3.5부터 GTK 3, Cairo, Pango 기반 런처가 Windows 버전과 같은 페이지와 문구를 그리고 같은 설정을 저장합니다. 키보드 입력은 작동하지만 Sony HID와 XInput 컨트롤러, 진동, 라이트바는 아직 Windows 기능입니다. Linux 버전은 실험적이며, Windows의 게임 결과는 Linux 결과가 아닙니다.
Linux 설치 안내연혁
각 줄에는 그 변경이 처음 포함된 공개 릴리스가 적혀 있습니다.
첫 Windows 런처: 표지가 있는 8개 게임 라이브러리, 저장 데이터 탐색, 게임패드·키보드·하이브리드 입력. 영어, 러시아어, 독일어, 프랑스어 지원.
간체 중국어, 스페인어, 아랍어, 포르투갈어가 인터페이스에 추가되었으며, 아랍어는 오른쪽에서 왼쪽으로 읽습니다.
출력 해상도와 “속도/그래픽” 프리셋. Vulkan을 가정하지 않고 시작할 때 확인합니다.
“PKG 추출”과 런처 옆에 함께 제공되는 pkgextractor. 실행 중인 릴리스를 표시합니다.
런처 안에서 보는 추출 진행 상황과 로그. 게임 성능 모드 스위치.
실행 실패 설명: 스마트 앱 컨트롤, 보안 소프트웨어, 액세스 거부, 손상된 파일.
그리드와 표 보기, 검색, 업데이트 확인을 갖춘 48개 게임 라이브러리. Linux용 네이티브 GTK 3 런처.
터키어, 일본어, 힌디어, 한국어 추가. 언어 선택이 6개씩 두 줄로 바뀌었습니다.
설정에 그래픽 API 선택 추가: 기본값 Vulkan 또는 Windows의 실험적 네이티브 DirectX 12 백엔드. Linux는 Vulkan을 유지합니다.
12개 인터페이스 언어