mirror of
https://github.com/PodeCaradox/GalaxyQuest-SteamFrame.git
synced 2026-10-18 22:01:24 +02:00
Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
 PodeCaradoxandClaude Opus 5.5
|
4715a1910a | ||
|
PodeCaradoxandClaude Opus 5.5
|
b9a7ebbe67 | ||
|
PodeCaradoxandClaude Opus 5.5
|
f6f1df084f | ||
|
PodeCaradoxandClaude Opus 5.5
|
c6d3a84f01 |
No files matched your search
+53
-84
@@ -1,7 +1,5 @@
|
||||
# GalaxyQuest auf der Steam Frame
|
||||
|
||||
*English: [STEAM-FRAME.md](STEAM-FRAME.md)*
|
||||
|
||||
Super Mario Galaxy in VR, nativ auf der **Valve Steam Frame** (SteamOS, arm64):
|
||||
der Spielcode des [Petari-Projekts](https://github.com/SMGCommunity/Petari)
|
||||
läuft direkt auf dem Prozessor der Frame, das Bild geht über OpenXR an
|
||||
@@ -23,96 +21,52 @@ in der [README](README.md).
|
||||
europäischen Disc (RMGR01; das Spiel meldet sie als RMGP01). Die
|
||||
europäische (RMGP01) und die amerikanische (RMGE01) laufen in der
|
||||
Quest-Fassung.
|
||||
- Einen **PC** mit Linux oder Windows mit WSL2, um das Programm einmal zu
|
||||
bauen. Einen fertigen Download gibt es nicht.
|
||||
- Aus den **Releases** dieses Repositorys `GalaxyQuest-SteamFrame-arm64.tar.gz`.
|
||||
|
||||
Den Rest macht dann `install.sh` aus dem gebauten Archiv auf der Frame: es
|
||||
entpackt die Disc (mit Dolphins `dolphin-tool`; fehlt Dolphin, installiert
|
||||
das Skript es aus Flathub), wandelt die Spieldateien um (einige Minuten,
|
||||
3,3 GB) und trägt das Spiel in Steam ein.
|
||||
Einen PC brauchst du nicht: `install.sh` aus dem Archiv entpackt die Disc auf
|
||||
der Frame (mit Dolphins `dolphin-tool`; fehlt Dolphin, installiert das Skript
|
||||
es aus Flathub), wandelt die Spieldateien um (einige Minuten, 3,3 GB) und
|
||||
trägt das Spiel in Steam ein.
|
||||
|
||||
## 1. Bauen (PC)
|
||||
## 1. Installieren
|
||||
|
||||
1. **Nur Windows:** PowerShell öffnen und Ubuntu in WSL2 installieren,
|
||||
dann *Ubuntu 24.04* im Startmenü öffnen und alles Weitere dort:
|
||||
**Variante A – direkt auf der Frame:**
|
||||
|
||||
```
|
||||
wsl --install -d Ubuntu-24.04
|
||||
```
|
||||
|
||||
2. Werkzeuge installieren (CMake 3.24+, clang 16+, lld, Ninja; getestet mit
|
||||
clang 20, `sudo apt install clang-20`, falls das Standard-clang
|
||||
scheitert):
|
||||
|
||||
```
|
||||
sudo apt update
|
||||
sudo apt install git clang lld cmake ninja-build python3 curl
|
||||
```
|
||||
|
||||
3. Valves Steam-Runtime-4-SDK für arm64 herunterladen (etwa 1 GB):
|
||||
|
||||
```
|
||||
mkdir -p ~/steamrt4-arm64-sdk/sysroot && cd ~/steamrt4-arm64-sdk
|
||||
curl -O https://repo.steampowered.com/steamrt4/images/latest-public-beta/com.valvesoftware.SteamRuntime.Sdk-arm64-steamrt4-sysroot.tar.gz
|
||||
tar -xzf com.valvesoftware.SteamRuntime.Sdk-arm64-steamrt4-sysroot.tar.gz -C sysroot --exclude='./dev/*'
|
||||
```
|
||||
|
||||
4. Quellcode holen und bauen. Im Linux-Heimordner lassen, nicht auf einem
|
||||
Windows-Laufwerk oder USB-Stick (dort fehlt das Recht zum Ausführen):
|
||||
|
||||
```
|
||||
git clone https://github.com/PodeCaradox/GalaxyQuest-SteamFrame.git ~/GalaxyQuest
|
||||
cd ~/GalaxyQuest
|
||||
ARCH=arm64 STEAMRT4_ARM64_SYSROOT=~/steamrt4-arm64-sdk/sysroot ./build_linux.sh
|
||||
```
|
||||
|
||||
Ergebnis: `~/GalaxyQuest/build-linux-arm64/GalaxyQuest-SteamFrame-arm64.tar.gz`
|
||||
(beim ersten Mal etwa 10 Minuten; nach `git pull` wird nur Geändertes
|
||||
neu gebaut). Unter Windows öffnet `explorer.exe build-linux-arm64` im
|
||||
Ubuntu-Fenster den Ordner im Explorer.
|
||||
|
||||
## 2. Auf die Frame bringen und installieren
|
||||
|
||||
**Variante A – USB-Stick, ohne Netzwerk:**
|
||||
|
||||
1. `GalaxyQuest-SteamFrame-arm64.tar.gz` und dein Disc-Abbild (hier
|
||||
`smg.iso`) auf einen USB-Stick kopieren.
|
||||
2. Frame in den Desktop-Modus schalten, den Stick einstecken.
|
||||
3. Im Dateimanager (Dolphin) beide Dateien vom Stick in den Persönlichen
|
||||
Ordner kopieren, dann Rechtsklick auf das Archiv → *Entpacken → Hierher
|
||||
entpacken*: es entsteht der Ordner `GalaxyQuest`. (Nicht auf dem Stick
|
||||
entpacken: dort fehlt dem Programm das Recht, ausgeführt zu werden.)
|
||||
1. Frame in den Desktop-Modus schalten.
|
||||
2. Archiv und Disc-Abbild in den Persönlichen Ordner holen (Download im
|
||||
Browser oder vom USB-Stick kopieren).
|
||||
3. Das Archiv dort entpacken (Rechtsklick → *Entpacken → Hierher
|
||||
entpacken*): es entsteht der Ordner `GalaxyQuest`. Nicht auf dem Stick
|
||||
entpacken: dort fehlt dem Programm das Recht, ausgeführt zu werden.
|
||||
4. Konsole öffnen und, mit dem Pfad zu deinem Disc-Abbild:
|
||||
|
||||
```
|
||||
~/GalaxyQuest/install.sh ~/smg.iso
|
||||
~/GalaxyQuest/install.sh ~/Downloads/SuperMarioGalaxy.iso
|
||||
```
|
||||
|
||||
**Variante B – über das Netzwerk (SSH):**
|
||||
**Variante B – vom PC über das Netzwerk (SSH):**
|
||||
|
||||
1. Einmalig auf der Frame: *Einstellungen → System → Entwicklermodus*
|
||||
einschalten und in den Entwickler-Einstellungen ein Passwort für den
|
||||
Benutzer `steamos` setzen. Damit ist SSH an. (Ohne Entwicklermodus geht
|
||||
es auch in der Konsole des Desktop-Modus: `passwd`, dann
|
||||
`sudo systemctl enable --now sshd`.)
|
||||
2. Auf dem PC (Windows-PowerShell, Linux-Terminal oder das Ubuntu-Fenster),
|
||||
im Ordner mit Archiv und Disc-Abbild:
|
||||
Einmalig auf der Frame im Desktop-Modus eine Konsole öffnen:
|
||||
|
||||
```
|
||||
scp GalaxyQuest-SteamFrame-arm64.tar.gz smg.iso steamos@frame.local:
|
||||
ssh steamos@frame.local "tar -xzf GalaxyQuest-SteamFrame-arm64.tar.gz && ~/GalaxyQuest/install.sh ~/smg.iso && rm ~/smg.iso"
|
||||
```
|
||||
```
|
||||
passwd # Passwort setzen, falls noch keins
|
||||
sudo systemctl enable --now sshd
|
||||
```
|
||||
|
||||
Beide fragen nach dem Passwort aus Schritt 1. Wird `frame.local` nicht
|
||||
gefunden (in WSL häufig), die IP-Adresse der Frame nehmen (`ip a` in der
|
||||
Konsole der Frame). Im Ubuntu-Fenster liegt ein Disc-Abbild aus den
|
||||
Windows-Downloads unter `/mnt/c/Users/<du>/Downloads/smg.iso`.
|
||||
Dann auf dem PC (Windows-PowerShell oder Linux-Terminal), im Ordner mit dem
|
||||
Archiv und dem Disc-Abbild (hier `smg.iso`; `frame.local` geht meistens, sonst
|
||||
die IP-Adresse aus `ip a` auf der Frame):
|
||||
|
||||
Ohne Prolog- und Abspann-Film (2,3 GB weniger) hinter dem Disc-Abbild
|
||||
`--no-movies` anhängen. Hast du die Disc schon entpackt (Ordner mit `sys` und
|
||||
`files`), geht statt des Abbilds auch dieser Ordner.
|
||||
```
|
||||
scp GalaxyQuest-SteamFrame-arm64.tar.gz smg.iso steamos@frame.local:
|
||||
ssh steamos@frame.local "tar -xzf GalaxyQuest-SteamFrame-arm64.tar.gz && ~/GalaxyQuest/install.sh ~/smg.iso && rm ~/smg.iso"
|
||||
```
|
||||
|
||||
## 3. In Steam einrichten
|
||||
Ohne Prolog- und Abspann-Film (2,3 GB weniger) hinten `--no-movies`
|
||||
anhängen. Hast du die Disc schon entpackt (Ordner mit `sys` und `files`),
|
||||
geht statt des Abbilds auch dieser Ordner.
|
||||
|
||||
## 2. In Steam einrichten
|
||||
|
||||
Das Skript trägt das Spiel in Steam ein, wenn Steam läuft (sonst: Steam →
|
||||
*Spiele* → *Ein Nicht-Steam-Spiel zur Bibliothek hinzufügen* → *Durchsuchen*
|
||||
@@ -124,7 +78,7 @@ Eintrags:
|
||||
|
||||
Zurück in den VR-Modus wechseln und GalaxyQuest aus der Bibliothek starten.
|
||||
|
||||
## 4. Ohne install.sh (von Hand)
|
||||
## 3. Ohne install.sh (von Hand)
|
||||
|
||||
Auf der Frame gehört das Programm nach `~/GalaxyQuest/`, der *Inhalt* des
|
||||
umgewandelten Ordners nach `~/.local/share/GalaxyQuest/game/` (dort direkt
|
||||
@@ -141,7 +95,7 @@ Findet das Spiel keine Daten im Heimordner, zeigt es beim Start eine Liste
|
||||
der Ordner mit Spieldaten (auch auf SD-Karte und USB-Stick); dort einen
|
||||
auswählen, das Spiel merkt ihn sich.
|
||||
|
||||
## 5. Bildwiederholrate
|
||||
## 4. Bildwiederholrate
|
||||
|
||||
Das Spiel läuft mit 60 Bildern pro Sekunde und zeigt jedes genau zwei
|
||||
Bildwechsel lang, wenn das Headset mit **120 Hz** läuft; beim zweiten dreht
|
||||
@@ -204,16 +158,31 @@ Hinweis zum Handgelenksriemen beim Start auf Niederländisch).
|
||||
und `files` liegen). *Not converted* heißt: noch mit `cook.py` umwandeln.
|
||||
- **Ruckelt:** prüfen, ob SteamVR für GalaxyQuest 120 Hz nutzt (siehe
|
||||
oben); im Protokoll zeigen Zeilen mit `missed … refreshes`, wie oft ein
|
||||
Bild zu spät kam. Andere Programme im Hintergrund (etwa ein Chat-Programm,
|
||||
das Video überträgt) nehmen dem Spiel Rechenzeit.
|
||||
Bild zu spät kam.
|
||||
- **Bild schliert bei Kopfbewegungen:** in `petari_vr.ini` muss
|
||||
`timewarp = 1` gelten (Standard): dann dreht das Spiel jedes der 120
|
||||
Bilder pro Sekunde auf die aktuelle Kopfhaltung nach, was SteamVR selbst
|
||||
nicht tut.
|
||||
|
||||
## Entwicklung
|
||||
## Selbst bauen
|
||||
|
||||
Ein Entwicklungsstand direkt auf die Frame: `tools/push_frame.sh steamos@frame.local [cooked-Ordner]`.
|
||||
Gebaut wird unter Linux oder WSL2 mit **Ubuntu 24.04** (CMake 3.24+,
|
||||
clang 16+), gegen Valves Steam-Runtime-4-SDK für arm64:
|
||||
|
||||
```
|
||||
sudo apt install clang lld cmake ninja-build python3 curl
|
||||
mkdir -p ~/steamrt4-arm64-sdk/sysroot && cd ~/steamrt4-arm64-sdk
|
||||
curl -O https://repo.steampowered.com/steamrt4/images/latest-public-beta/com.valvesoftware.SteamRuntime.Sdk-arm64-steamrt4-sysroot.tar.gz
|
||||
tar -xzf com.valvesoftware.SteamRuntime.Sdk-arm64-steamrt4-sysroot.tar.gz -C sysroot --exclude='./dev/*'
|
||||
cd ~/GalaxyQuest # dieses Repository, nicht auf einem exFAT-Stick
|
||||
ARCH=arm64 STEAMRT4_ARM64_SYSROOT=~/steamrt4-arm64-sdk/sysroot ./build_linux.sh
|
||||
```
|
||||
|
||||
Ergebnis in `build-linux-arm64/`: `galaxyquest`, `libopenxr_loader.so.1`,
|
||||
`libjsoncpp.so.26` und daraus gepackt `GalaxyQuest-SteamFrame-arm64.tar.gz`
|
||||
(das Release-Archiv, mit `install.sh` aus `platform/linux/` und dem
|
||||
Konverter). Ein Entwicklungsstand auf die Frame:
|
||||
`tools/push_frame.sh steamos@frame.local [cooked-Ordner]`.
|
||||
|
||||
Was sich gegenüber der Quest-Fassung ändert, steht in
|
||||
[docs/TECHNICAL.md](docs/TECHNICAL.md) unter „Steam Frame (Linux)“.
|
||||
@@ -10,132 +10,9 @@
|
||||
|
||||
# GalaxyQuest
|
||||
|
||||
## Steam Frame port
|
||||
|
||||
This is a fork of [bigmak94/GalaxyQuest](https://github.com/bigmak94/GalaxyQuest)
|
||||
that also runs natively on Valve's **Steam Frame** (SteamOS, arm64).
|
||||
How to build and install it is below; controls, settings and
|
||||
troubleshooting are in [STEAM-FRAME.md](STEAM-FRAME.md) (English) and
|
||||
[ANLEITUNG-STEAM-FRAME.md](ANLEITUNG-STEAM-FRAME.md) (Deutsch).
|
||||
|
||||
> **Notice.** This is an unofficial, non-commercial fan project. It is not
|
||||
> affiliated with, endorsed by or sponsored by Nintendo. Super Mario Galaxy
|
||||
> and all related names are trademarks of Nintendo. This repository contains
|
||||
> **no game data** (no disc image, no textures, models, sounds, music or
|
||||
> movies) and no ready-made builds. To play you need your own, legally obtained
|
||||
> Super Mario Galaxy disc, which you convert yourself. Do not share
|
||||
> converted game files, and do not ask for them here.
|
||||
>
|
||||
> Rights holders who want something removed: please open an issue on this
|
||||
> repository, and it will be taken down promptly.
|
||||
|
||||
There are no ready-made builds: you build the Frame version yourself on a
|
||||
PC (about 10 minutes the first time), copy it to the Frame together with
|
||||
your disc image, and run `install.sh` there. `install.sh` extracts the disc
|
||||
with Dolphin (installed from Flathub if missing), converts the game files
|
||||
and adds the game to Steam.
|
||||
|
||||
### 1. Build it (PC)
|
||||
|
||||
The Frame version is cross-compiled on a PC running Linux, or Windows with
|
||||
WSL2, against Valve's Steam Runtime 4 SDK for arm64.
|
||||
|
||||
1. **Windows only:** open PowerShell and install Ubuntu in WSL2, then open
|
||||
*Ubuntu 24.04* from the Start menu and do the rest there:
|
||||
|
||||
```
|
||||
wsl --install -d Ubuntu-24.04
|
||||
```
|
||||
|
||||
2. Install the tools (CMake 3.24+, clang 16+, lld, Ninja; tested with
|
||||
clang 20, `sudo apt install clang-20` if the default one fails):
|
||||
|
||||
```
|
||||
sudo apt update
|
||||
sudo apt install git clang lld cmake ninja-build python3 curl
|
||||
```
|
||||
|
||||
3. Download Valve's Steam Runtime 4 SDK sysroot for arm64 (about 1 GB):
|
||||
|
||||
```
|
||||
mkdir -p ~/steamrt4-arm64-sdk/sysroot && cd ~/steamrt4-arm64-sdk
|
||||
curl -O https://repo.steampowered.com/steamrt4/images/latest-public-beta/com.valvesoftware.SteamRuntime.Sdk-arm64-steamrt4-sysroot.tar.gz
|
||||
tar -xzf com.valvesoftware.SteamRuntime.Sdk-arm64-steamrt4-sysroot.tar.gz -C sysroot --exclude='./dev/*'
|
||||
```
|
||||
|
||||
4. Get the source and build it. Keep it in the Linux home folder, not on a
|
||||
Windows drive or a USB stick (they lose the executable bit):
|
||||
|
||||
```
|
||||
git clone https://github.com/PodeCaradox/GalaxyQuest-SteamFrame.git ~/GalaxyQuest
|
||||
cd ~/GalaxyQuest
|
||||
ARCH=arm64 STEAMRT4_ARM64_SYSROOT=~/steamrt4-arm64-sdk/sysroot ./build_linux.sh
|
||||
```
|
||||
|
||||
The result is `~/GalaxyQuest/build-linux-arm64/GalaxyQuest-SteamFrame-arm64.tar.gz`:
|
||||
the program with the OpenXR loader and jsoncpp next to it, `install.sh`,
|
||||
the disc converter and the guides. Later builds (after `git pull`) only
|
||||
rebuild what changed.
|
||||
|
||||
On Windows, `explorer.exe build-linux-arm64` in the Ubuntu window opens
|
||||
that folder in Explorer, to copy the file out.
|
||||
|
||||
### 2. Bring it to the Frame and install
|
||||
|
||||
**Option A – USB stick, no network setup:**
|
||||
|
||||
1. Copy `GalaxyQuest-SteamFrame-arm64.tar.gz` and your disc image (here
|
||||
`smg.iso`) to a USB stick.
|
||||
2. On the Frame, switch to desktop mode and plug in the stick.
|
||||
3. In the file manager (Dolphin), copy both files from the stick into your
|
||||
home folder, then right-click the archive → *Extract → Extract archive
|
||||
here*. (Not on the stick itself: the program would not be allowed to run
|
||||
from there.)
|
||||
4. Open Konsole and run:
|
||||
|
||||
```
|
||||
~/GalaxyQuest/install.sh ~/smg.iso
|
||||
```
|
||||
|
||||
**Option B – over the network (SSH):**
|
||||
|
||||
1. Once, on the Frame: turn on *Settings → System → Developer Mode* and set
|
||||
a password for the user `steamos` in the developer settings. That turns
|
||||
SSH on.
|
||||
2. On the PC, in the folder with the archive and the disc image:
|
||||
|
||||
```
|
||||
scp GalaxyQuest-SteamFrame-arm64.tar.gz smg.iso steamos@frame.local:
|
||||
ssh steamos@frame.local "tar -xzf GalaxyQuest-SteamFrame-arm64.tar.gz && ~/GalaxyQuest/install.sh ~/smg.iso && rm ~/smg.iso"
|
||||
```
|
||||
|
||||
Both ask for the password from step 1. If `frame.local` is not found
|
||||
(often the case inside WSL), use the Frame's IP address instead
|
||||
(`ip a` in Konsole on the Frame shows it). From the Ubuntu window the
|
||||
build is at `build-linux-arm64/GalaxyQuest-SteamFrame-arm64.tar.gz` and
|
||||
a disc image in the Windows downloads at
|
||||
`/mnt/c/Users/<you>/Downloads/smg.iso`.
|
||||
|
||||
Add `--no-movies` after the disc image to leave out the prologue and ending
|
||||
movies (2.3 GB less).
|
||||
|
||||
### 3. Start it
|
||||
|
||||
`install.sh` adds the game to Steam when Steam is running (otherwise:
|
||||
Steam → *Games* → *Add a Non-Steam Game to My Library…* → *Browse* →
|
||||
`/home/steamos/GalaxyQuest/galaxyquest`). In the entry's *Properties*,
|
||||
rename it to `GalaxyQuest` and **tick "Include in VR Library"**, then start
|
||||
it from the library in VR mode.
|
||||
|
||||
Controls, settings and troubleshooting: [STEAM-FRAME.md](STEAM-FRAME.md)
|
||||
(English), [ANLEITUNG-STEAM-FRAME.md](ANLEITUNG-STEAM-FRAME.md) (Deutsch).
|
||||
|
||||
What the port changes compared with the Quest version is described in
|
||||
[docs/TECHNICAL.md](docs/TECHNICAL.md) under "Steam Frame (Linux)".
|
||||
|
||||
---
|
||||
|
||||
*Everything below is the original project's README.*
|
||||
> **Steam Frame:** this fork also runs natively on Valve's Steam Frame
|
||||
> (SteamOS, arm64). Installation and controls there:
|
||||
> [ANLEITUNG-STEAM-FRAME.md](ANLEITUNG-STEAM-FRAME.md) (Deutsch).
|
||||
|
||||
**Play Super Mario Galaxy in virtual reality, natively on Meta Quest 2 and 3.**
|
||||
|
||||
@@ -150,6 +27,8 @@ is compiled for the headset's processor. A new platform layer stands in for
|
||||
the Wii's hardware (graphics, sound, controllers, saves) and presents the
|
||||
game in VR through OpenXR.
|
||||
|
||||
|
||||
|
||||
> **You need your own copy of Super Mario Galaxy.** Neither this repository
|
||||
> nor the app contains any game data. You convert your own disc once (its
|
||||
> files, and the few pieces of data its program holds), copy the result to
|
||||
@@ -207,6 +86,8 @@ resolution.
|
||||
**Everything else is the original game.** Levels, physics, enemies, music,
|
||||
story and saves all come from the game's own code and your own game files.
|
||||
|
||||
|
||||
|
||||
## What you need
|
||||
|
||||
- A **Meta Quest 2 or 3** (both tested and working; a Quest 3S should work
|
||||
|
||||
-216
@@ -1,216 +0,0 @@
|
||||
# GalaxyQuest on the Steam Frame
|
||||
|
||||
*Deutsch: [ANLEITUNG-STEAM-FRAME.md](ANLEITUNG-STEAM-FRAME.md)*
|
||||
|
||||
Super Mario Galaxy in VR, running natively on the **Valve Steam Frame**
|
||||
(SteamOS, arm64): the game code of the
|
||||
[Petari project](https://github.com/SMGCommunity/Petari) runs directly on
|
||||
the Frame's processor, and the picture goes to SteamVR through OpenXR. It is
|
||||
a port of [GalaxyQuest](https://github.com/bigmak94/GalaxyQuest) (made for
|
||||
Meta Quest there); everything about the game itself (diorama, giant screen,
|
||||
VR settings) is in the [README](README.md).
|
||||
|
||||
> **You need your own Super Mario Galaxy disc.** Neither this repository nor
|
||||
> the program contains any game data. Everyone converts their own disc once.
|
||||
> Do not share the converted game files.
|
||||
|
||||
## What you need
|
||||
|
||||
- A **Steam Frame** with SteamVR set up, and about 9 GB free.
|
||||
- Your **Super Mario Galaxy** as a disc image (ISO, RVZ, WBFS, GCZ, WIA),
|
||||
for example dumped from your disc with
|
||||
[CleanRip](https://wiibrew.org/wiki/CleanRip). Tested on the Frame: a
|
||||
Russian fan translation of the European disc (RMGR01; the game reports it
|
||||
as RMGP01). The European (RMGP01) and American (RMGE01) discs run in the
|
||||
Quest version.
|
||||
- A **PC** with Linux, or Windows with WSL2, to build the program once.
|
||||
There are no ready-made builds.
|
||||
|
||||
`install.sh` from the built archive then does the rest on the Frame: it
|
||||
extracts the disc (with Dolphin's `dolphin-tool`; if Dolphin is missing, the
|
||||
script installs it from Flathub), converts the game files (a few minutes,
|
||||
3.3 GB) and adds the game to Steam.
|
||||
|
||||
## 1. Build it (PC)
|
||||
|
||||
1. **Windows only:** open PowerShell and install Ubuntu in WSL2, then open
|
||||
*Ubuntu 24.04* from the Start menu and do the rest there:
|
||||
|
||||
```
|
||||
wsl --install -d Ubuntu-24.04
|
||||
```
|
||||
|
||||
2. Install the tools (CMake 3.24+, clang 16+, lld, Ninja; tested with
|
||||
clang 20, `sudo apt install clang-20` if the default one fails):
|
||||
|
||||
```
|
||||
sudo apt update
|
||||
sudo apt install git clang lld cmake ninja-build python3 curl
|
||||
```
|
||||
|
||||
3. Download Valve's Steam Runtime 4 SDK sysroot for arm64 (about 1 GB):
|
||||
|
||||
```
|
||||
mkdir -p ~/steamrt4-arm64-sdk/sysroot && cd ~/steamrt4-arm64-sdk
|
||||
curl -O https://repo.steampowered.com/steamrt4/images/latest-public-beta/com.valvesoftware.SteamRuntime.Sdk-arm64-steamrt4-sysroot.tar.gz
|
||||
tar -xzf com.valvesoftware.SteamRuntime.Sdk-arm64-steamrt4-sysroot.tar.gz -C sysroot --exclude='./dev/*'
|
||||
```
|
||||
|
||||
4. Get the source and build it. Keep it in the Linux home folder, not on a
|
||||
Windows drive or a USB stick (they lose the executable bit):
|
||||
|
||||
```
|
||||
git clone https://github.com/PodeCaradox/GalaxyQuest-SteamFrame.git ~/GalaxyQuest
|
||||
cd ~/GalaxyQuest
|
||||
ARCH=arm64 STEAMRT4_ARM64_SYSROOT=~/steamrt4-arm64-sdk/sysroot ./build_linux.sh
|
||||
```
|
||||
|
||||
The result is `~/GalaxyQuest/build-linux-arm64/GalaxyQuest-SteamFrame-arm64.tar.gz`
|
||||
(about 10 minutes the first time; after `git pull` only what changed is
|
||||
rebuilt). On Windows, `explorer.exe build-linux-arm64` in the Ubuntu
|
||||
window opens that folder in Explorer.
|
||||
|
||||
## 2. Bring it to the Frame and install
|
||||
|
||||
**Option A – USB stick, no network setup:**
|
||||
|
||||
1. Copy `GalaxyQuest-SteamFrame-arm64.tar.gz` and your disc image (here
|
||||
`smg.iso`) to a USB stick.
|
||||
2. On the Frame, switch to desktop mode and plug in the stick.
|
||||
3. In the file manager (Dolphin), copy both files from the stick into your
|
||||
home folder, then right-click the archive → *Extract → Extract archive
|
||||
here*. This makes the folder `GalaxyQuest`. (Not on the stick itself:
|
||||
the program would not be allowed to run from there.)
|
||||
4. Open Konsole and run, with the path to your disc image:
|
||||
|
||||
```
|
||||
~/GalaxyQuest/install.sh ~/smg.iso
|
||||
```
|
||||
|
||||
**Option B – over the network (SSH):**
|
||||
|
||||
1. Once, on the Frame: turn on *Settings → System → Developer Mode* and set
|
||||
a password for the user `steamos` in the developer settings. That turns
|
||||
SSH on. (Without developer mode, Konsole in desktop mode does it too:
|
||||
`passwd`, then `sudo systemctl enable --now sshd`.)
|
||||
2. On the PC (Windows PowerShell, a Linux terminal or the Ubuntu window),
|
||||
in the folder with the archive and the disc image:
|
||||
|
||||
```
|
||||
scp GalaxyQuest-SteamFrame-arm64.tar.gz smg.iso steamos@frame.local:
|
||||
ssh steamos@frame.local "tar -xzf GalaxyQuest-SteamFrame-arm64.tar.gz && ~/GalaxyQuest/install.sh ~/smg.iso && rm ~/smg.iso"
|
||||
```
|
||||
|
||||
Both ask for the password from step 1. If `frame.local` is not found
|
||||
(often the case inside WSL), use the Frame's IP address (`ip a` in
|
||||
Konsole on the Frame). From the Ubuntu window a disc image in the
|
||||
Windows downloads is at `/mnt/c/Users/<you>/Downloads/smg.iso`.
|
||||
|
||||
Add `--no-movies` after the disc image to leave out the prologue and ending
|
||||
movies (2.3 GB less). If you already extracted the disc (a folder with
|
||||
`sys` and `files`), you can give that folder instead of the image.
|
||||
|
||||
## 3. Set it up in Steam
|
||||
|
||||
The script adds the game to Steam if Steam is running (otherwise: Steam →
|
||||
*Games* → *Add a Non-Steam Game to My Library…* → *Browse* →
|
||||
`/home/steamos/GalaxyQuest/galaxyquest`). Then, in the entry's
|
||||
*Properties*:
|
||||
|
||||
- name: `GalaxyQuest`,
|
||||
- **tick "Include in VR Library".**
|
||||
|
||||
Switch back to VR mode and start GalaxyQuest from the library.
|
||||
|
||||
## 4. Without install.sh (by hand)
|
||||
|
||||
On the Frame the program goes to `~/GalaxyQuest/`, the *contents* of the
|
||||
converted folder to `~/.local/share/GalaxyQuest/game/` (with `sys` and
|
||||
`files` directly inside). The conversion also works on a PC with Python
|
||||
3.8+: extract the disc with Dolphin (right-click the game → *Properties* →
|
||||
*Filesystem* → right-click the disc → *Extract Entire Disc…*), then, in the
|
||||
archive's `converter` folder:
|
||||
|
||||
```
|
||||
python tools/cook/cook.py <extracted disc> cooked --with-movies
|
||||
```
|
||||
|
||||
If the game finds no data in the home folder, it shows a list of folders
|
||||
with game data on start (also on SD cards and USB sticks); pick one there
|
||||
and the game remembers it.
|
||||
|
||||
## 5. Refresh rate
|
||||
|
||||
The game runs at 60 frames a second and shows each one for exactly two
|
||||
refreshes when the headset runs at **120 Hz**; on the second it turns the
|
||||
picture to where your head points now. That gives the steadiest picture and
|
||||
the GPU the most time per eye. The game sets 120 Hz itself when it starts:
|
||||
it writes the rate into SteamVR's per-application settings (SteamVR →
|
||||
*Video*), where it can also be changed. Other rates: pause menu → VR
|
||||
settings → *Refresh rate* (72, 90, 120, 144 Hz).
|
||||
|
||||
## Controls (Frame controllers)
|
||||
|
||||
| Frame controller | Wii | In the game |
|
||||
|---|---|---|
|
||||
| Left stick | Nunchuk stick | Move |
|
||||
| A | A | Jump, talk, confirm. Hold: skip a cutscene or dialogue |
|
||||
| Y (or B) | Shake | Spin |
|
||||
| X | Hold Z + A | Long jump while running, backflip standing still |
|
||||
| Tilt the right controller | Tilt the Wii Remote | Steer the star ball and the manta ray |
|
||||
| Right trigger | B | Shoot star bits, cancel |
|
||||
| Point the right controller | Pointer | Collect star bits, grab pull stars, menus |
|
||||
| Left trigger | Z | Crouch; ground pound in the air; held with A same as X |
|
||||
| Left grip | C | Camera behind Mario |
|
||||
| View (⧉, small button on the left) | + | Pause menu with the VR settings |
|
||||
| Right stick or left D-pad, left/right | D-pad | Turn the view around Mario |
|
||||
| Right stick or left D-pad up, right stick click | D-pad up | First-person view |
|
||||
|
||||
The Menu button (≡) on the right does nothing. Spinning also works by
|
||||
swinging a controller briefly or flicking your wrist, but not as reliably
|
||||
as with Y.
|
||||
|
||||
Recentre the view with SteamVR's own "Recenter view" in the system menu;
|
||||
the game then puts the screen and the diorama in front of you.
|
||||
|
||||
## Language
|
||||
|
||||
Pause menu → VR settings → *Game* tab → *Language*, or the line
|
||||
`language = german` in `~/.local/share/GalaxyQuest/petari_vr.ini`
|
||||
(`english`, `french`, `spanish`, `italian`). Takes effect on the next start.
|
||||
|
||||
On fan translations the translation usually sits in the disc's English
|
||||
folder: on RMGR01, "english" is Russian. Such discs sometimes carry damaged
|
||||
files of other languages; the converter then replaces the affected archives
|
||||
with another language's and reports it as
|
||||
`note: … damaged on this disc, … used instead` (that is why the wrist strap
|
||||
notice at start is in Dutch on RMGR01).
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
- **Log:** `~/.local/share/GalaxyQuest/petari_log.txt` (the one from the
|
||||
start before: `petari_log.txt.prev`). Settings:
|
||||
`~/.local/share/GalaxyQuest/petari_vr.ini`, saves:
|
||||
`~/.local/share/GalaxyQuest/nand`.
|
||||
- **Does not start from Steam:** run `~/GalaxyQuest/galaxyquest` in
|
||||
Konsole; a message like `error while loading shared libraries` means one
|
||||
of the three files from the archive is missing.
|
||||
- **A list of game data folders instead of the game:** the converted data
|
||||
is not in `~/.local/share/GalaxyQuest/game` (`sys` and `files` must be
|
||||
directly inside). *Not converted* means: still to be converted with
|
||||
`cook.py` (or `install.sh`).
|
||||
- **Stutters:** check that SteamVR uses 120 Hz for GalaxyQuest (see above);
|
||||
lines with `missed … refreshes` in the log show how often a frame came
|
||||
late. Other apps busy in the background (a chat client streaming video,
|
||||
for example) take CPU time from the game.
|
||||
- **The picture smears when you turn your head:** `timewarp = 1` (the
|
||||
default) must be set in `petari_vr.ini`: the game then turns each of the
|
||||
120 pictures a second to your current head pose, which SteamVR itself does
|
||||
not do.
|
||||
|
||||
## Development
|
||||
|
||||
A development build straight to the Frame: `tools/push_frame.sh steamos@frame.local [cooked folder]`.
|
||||
|
||||
What differs from the Quest version is in
|
||||
[docs/TECHNICAL.md](docs/TECHNICAL.md) under "Steam Frame (Linux)".
|
||||
+1
-1
@@ -34,7 +34,7 @@ if [ "$ARCH" = arm64 ]; then
|
||||
# executable bit kept (ANLEITUNG-STEAM-FRAME.md).
|
||||
rm -rf $BUILD/package
|
||||
mkdir -p $BUILD/package/GalaxyQuest
|
||||
cp $BUILD/galaxyquest $BUILD/libopenxr_loader.so.1 $BUILD/libjsoncpp.so.26 LICENSE THIRD_PARTY_NOTICES.md ANLEITUNG-STEAM-FRAME.md STEAM-FRAME.md \
|
||||
cp $BUILD/galaxyquest $BUILD/libopenxr_loader.so.1 $BUILD/libjsoncpp.so.26 LICENSE THIRD_PARTY_NOTICES.md ANLEITUNG-STEAM-FRAME.md \
|
||||
platform/linux/install.sh $BUILD/package/GalaxyQuest/
|
||||
# The disc converter for install.sh, as the converter zip holds it.
|
||||
python3 tools/package_converter.py $BUILD/converter.zip > /dev/null
|
||||
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 119 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 140 KiB |
+16
-31
@@ -12,32 +12,29 @@ HERE=$(cd "$(dirname "$0")" && pwd)
|
||||
DATA=${GALAXYQUEST_HOME:-${XDG_DATA_HOME:-$HOME/.local/share}/GalaxyQuest}
|
||||
DOLPHIN=org.DolphinEmu.dolphin-emu
|
||||
|
||||
# Messages in German on a German system, else in English.
|
||||
case "${LC_ALL:-${LC_MESSAGES:-${LANG:-}}}" in de*) DE=1 ;; *) DE=0 ;; esac
|
||||
t() { if [ $DE = 1 ]; then printf '%s' "$1"; else printf '%s' "$2"; fi; }
|
||||
say() { printf '\n== %s\n' "$*"; }
|
||||
fail() { printf '\n%s: %s\n' "$(t FEHLER ERROR)" "$*" >&2; exit 1; }
|
||||
fail() { printf '\nFEHLER: %s\n' "$*" >&2; exit 1; }
|
||||
|
||||
SOURCE=""
|
||||
MOVIES=--with-movies
|
||||
for arg in "$@"; do
|
||||
case "$arg" in
|
||||
--no-movies) MOVIES="" ;;
|
||||
-h|--help) sed -n '2,8p' "$0"; exit 0 ;;
|
||||
*) [ -z "$SOURCE" ] || fail "$(t 'nur ein Disc-Abbild angeben' 'give only one disc image')"; SOURCE=$arg ;;
|
||||
-h|--help) sed -n '2,9p' "$0"; exit 0 ;;
|
||||
*) [ -z "$SOURCE" ] || fail "nur ein Disc-Abbild angeben"; SOURCE=$arg ;;
|
||||
esac
|
||||
done
|
||||
[ -n "$SOURCE" ] || fail "$(t 'Pfad zum Disc-Abbild fehlt. Beispiel' 'the path to the disc image is missing. Example'): ./install.sh ~/Downloads/SuperMarioGalaxy.iso"
|
||||
[ -e "$SOURCE" ] || fail "$(t 'nicht gefunden' 'not found'): $SOURCE"
|
||||
[ -n "$SOURCE" ] || fail "Pfad zum Disc-Abbild fehlt. Beispiel: ./install.sh ~/Downloads/SuperMarioGalaxy.iso"
|
||||
[ -e "$SOURCE" ] || fail "nicht gefunden: $SOURCE"
|
||||
SOURCE=$(realpath "$SOURCE")
|
||||
command -v python3 >/dev/null || fail "$(t 'python3 fehlt' 'python3 is missing')"
|
||||
[ -f "$HERE/converter/tools/cook/cook.py" ] || fail "$(t 'converter/ fehlt neben install.sh: das ganze Release-Archiv entpacken' 'converter/ is missing next to install.sh: extract the whole release archive')"
|
||||
command -v python3 >/dev/null || fail "python3 fehlt"
|
||||
[ -f "$HERE/converter/tools/cook/cook.py" ] || fail "converter/ fehlt neben install.sh: das ganze Release-Archiv entpacken"
|
||||
|
||||
# The converted game is 3.3 GB (1 GB without movies); the extracted disc up
|
||||
# to 4.7 GB more while the conversion runs.
|
||||
mkdir -p "$DATA"
|
||||
free_gb=$(( $(df -Pk "$DATA" | awk 'NR==2 {print $4}') / 1024 / 1024 ))
|
||||
[ "$free_gb" -ge 9 ] || fail "$(t "zu wenig Platz in $DATA: $free_gb GB frei, 9 GB nötig" "not enough space in $DATA: $free_gb GB free, 9 GB needed")"
|
||||
[ "$free_gb" -ge 9 ] || fail "zu wenig Platz in $DATA: $free_gb GB frei, 9 GB nötig"
|
||||
WORK=$DATA/.install
|
||||
rm -rf "$WORK"
|
||||
mkdir -p "$WORK"
|
||||
@@ -50,9 +47,9 @@ else
|
||||
if command -v dolphin-tool >/dev/null; then
|
||||
DOLPHIN_TOOL=(dolphin-tool)
|
||||
else
|
||||
command -v flatpak >/dev/null || fail "$(t 'weder dolphin-tool noch flatpak gefunden' 'found neither dolphin-tool nor flatpak')"
|
||||
command -v flatpak >/dev/null || fail "weder dolphin-tool noch flatpak gefunden"
|
||||
if ! flatpak info "$DOLPHIN" >/dev/null 2>&1; then
|
||||
say "$(t 'Dolphin wird aus Flathub installiert (zum Entpacken der Disc)' 'Installing Dolphin from Flathub (to extract the disc)')"
|
||||
say "Dolphin wird aus Flathub installiert (zum Entpacken der Disc)"
|
||||
# Into the user's installation: the system one asks for a password over SSH.
|
||||
flatpak remote-add --user --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo
|
||||
flatpak install --user -y --noninteractive flathub "$DOLPHIN"
|
||||
@@ -60,26 +57,25 @@ else
|
||||
# The Flatpak sandbox sees only what it is given: the image's folder and the work folder.
|
||||
DOLPHIN_TOOL=(flatpak run --filesystem="$(dirname "$SOURCE")":ro --filesystem="$WORK" --command=dolphin-tool "$DOLPHIN")
|
||||
fi
|
||||
say "$(t 'Disc wird entpackt' 'Extracting the disc'): $SOURCE"
|
||||
say "Disc wird entpackt: $SOURCE"
|
||||
"${DOLPHIN_TOOL[@]}" extract -i "$SOURCE" -o "$WORK/disc" --gameonly --quiet
|
||||
DISC=$WORK/disc
|
||||
fi
|
||||
|
||||
say "$(t 'Spieldateien werden umgewandelt (einige Minuten)' 'Converting the game files (a few minutes)')"
|
||||
say "Spieldateien werden umgewandelt (einige Minuten)"
|
||||
python3 "$HERE/converter/tools/cook/cook.py" "$DISC" "$WORK/cooked" $MOVIES
|
||||
[ -f "$WORK/cooked/sys/main.dol" ] || [ -d "$WORK/cooked/files" ] || fail "$(t 'die Umwandlung hat keine Spieldateien erzeugt' 'the conversion made no game files')"
|
||||
[ -f "$WORK/cooked/sys/main.dol" ] || [ -d "$WORK/cooked/files" ] || fail "die Umwandlung hat keine Spieldateien erzeugt"
|
||||
rm -rf "$DATA/game"
|
||||
mv "$WORK/cooked" "$DATA/game"
|
||||
|
||||
chmod 755 "$HERE/galaxyquest"
|
||||
if command -v steamos-add-to-steam >/dev/null && pgrep -x steam >/dev/null; then
|
||||
say "$(t 'GalaxyQuest wird zu Steam hinzugefügt' 'Adding GalaxyQuest to Steam')"
|
||||
say "GalaxyQuest wird zu Steam hinzugefügt"
|
||||
steamos-add-to-steam "$HERE/galaxyquest" || true
|
||||
fi
|
||||
|
||||
say "$(t Fertig Done)"
|
||||
if [ $DE = 1 ]; then
|
||||
cat <<EOF
|
||||
say "Fertig"
|
||||
cat <<EOF
|
||||
Programm: $HERE/galaxyquest
|
||||
Spieldaten: $DATA/game
|
||||
|
||||
@@ -89,14 +85,3 @@ Fehlt der Eintrag: Spiele -> "Ein Nicht-Steam-Spiel zur Bibliothek
|
||||
hinzufügen" -> $HERE/galaxyquest
|
||||
Dann im VR-Modus aus der Bibliothek starten.
|
||||
EOF
|
||||
else
|
||||
cat <<EOF
|
||||
Program: $HERE/galaxyquest
|
||||
Game files: $DATA/game
|
||||
|
||||
In Steam (desktop mode): rename the new entry "galaxyquest" to GalaxyQuest
|
||||
and tick "Include in VR Library" in its Properties. If the entry is missing:
|
||||
Games -> "Add a Non-Steam Game to My Library..." -> $HERE/galaxyquest
|
||||
Then start it from the library in VR mode.
|
||||
EOF
|
||||
fi
|
||||
Reference in new issue
Block a user