Phosphor OS – Anleitung
Phosphor OS macht aus einem Raspberry Pi eine Retro-Konsole, die direkt in ihr eigenes Menü startet. Es läuft auf CRT-Fernsehern und -Monitoren (mit den RGBerry-Platinen, über SCART oder VGA) und auf Flachbildschirmen über HDMI, auch hochkant für Arcade-Automaten.
Es ist kostenlos. Die RGBerry-Platinen werden separat verkauft. Für Phosphor OS über HDMI brauchst du sie aber nicht.
1. Was du brauchst
| Raspberry Pi | Pi 4 / Pi 400 (empfohlen), Pi 5 / Pi 500, Pi 3 oder Zero 2 W |
| microSD | 8 GB oder mehr (besser 32 GB oder mehr, wenn du viele Spiele haben willst). A1 / Class 10 |
| Netzteil | Das offizielle Netzteil für dein Modell: Pi 4/400 → USB-C 5 V 3 A · Pi 5/500 → USB-C 27 W · Pi 3/Zero 2 W → micro-USB 2,5 A |
| Bildschirm | Über HDMI (Fernseher oder Monitor) oder über SCART/VGA mit einer RGBerry-Platine |
| Controller | Jeder USB- oder Bluetooth-Controller. Eine USB-Tastatur geht auch |
Leistung als grobe Orientierung:
| System | Zero 2 W / Pi 3 | Pi 4 / 400 | Pi 5 / 500 |
|---|---|---|---|
| NES, Master System, Game Boy, PC Engine | ✓ | ✓ | ✓ |
| SNES, Mega Drive, Game Gear | ✓ (fast alles) | ✓ | ✓ |
| PlayStation | knapp | ✓ | ✓ |
| Arcade (MAME 2003-Plus) | je nach Spiel | ✓ fast alles | ✓ |
| CRT-Filter über HDMI | — | leicht / CRT-Pi | alle |
2. Die Karte beschreiben
- Lade
phosphor-os-rpi.img.xzherunter. Du musst die Datei nicht entpacken. - Öffne den Raspberry Pi Imager (oder balenaEtcher).
- Wähle Betriebssystem wählen → Eigenes Image verwenden und dann die
.img.xz-Datei. - Wähle die microSD aus und schreib das Image. Alles, was auf der Karte ist, wird gelöscht.
Nutze im Raspberry Pi Imager nicht die „Anpassungen“ (Benutzer, Wi-Fi ...): Phosphor OS liest sie nicht. Wie du das Wi-Fi einrichtest, steht in Abschnitt 5.
3. Erster Start
Steck die Karte ein, schließ Bildschirm und Controller an und schalte ein. Du siehst die Phosphor-OS-Animation. Beim ersten Start legt das System im freien Platz der Karte eine Partition SHARE an (das dauert ein paar Sekunden). Danach erscheint das Menü mit dem Hinweis „Noch keine Spiele“.
Videoausgang
- Ohne RGBerry-Platine: Das Bild kommt über HDMI in der Auflösung des Bildschirms.
- Mit RGBerry-Platine: Sie wird automatisch erkannt und nutzt je nach Schalterstellung SCART oder VGA. HDMI bleibt dann aus.
| Schalter 1 | Schalter 2 | Ausgang |
|---|---|---|
| OFF | — | SCART (15-kHz-Fernseher, Originalauflösung jedes Spiels) |
| ON | OFF | VGA 31 kHz (PC-Monitor, 640×480) |
| ON | ON | VGA 15 kHz (Arcade- oder Multisync-Monitor) |
Wenn etwas nicht richtig aussieht, schau in Abschnitt 9.
4. Spiele hinzufügen
Phosphor OS enthält keine Spiele. Nutze nur Kopien von Spielen, die du besitzt.
Vom Computer aus (am einfachsten)
- Schalte die Konsole aus (Einstellungen → Ausschalten) und nimm die microSD heraus.
- Steck sie in den PC. Es erscheinen zwei Laufwerke: PHOSPHOR (Boot-Laufwerk, lass es
in Ruhe, außer für
wifi.txt) und SHARE. - Kopiere jedes Spiel nach
SHARE/roms/<system>:
| Ordner | System | Formate |
|---|---|---|
nes |
NES / Famicom | .nes .fds .unf .zip .7z |
snes |
Super Nintendo | .sfc .smc .fig .swc .bs .st .zip .7z |
megadrive |
Mega Drive / Genesis | .md .gen .smd .bin .zip .7z |
mastersystem |
Master System | .sms .zip .7z |
gamegear |
Game Gear | .gg .zip .7z |
segacd |
Mega-CD | .cue .chd .iso .m3u |
pcengine |
PC Engine / TurboGrafx | .pce .cue .chd .sgx .zip .7z |
psx |
PlayStation | .cue .chd .pbp .m3u .exe |
gb |
Game Boy | .gb .zip .7z |
gbc |
Game Boy Color | .gbc .zip .7z |
arcade |
Arcade (MAME 2003-Plus) | .zip .7z |
- Steck die Karte wieder ein und schalte ein. Im Menü erscheinen nur Systeme, für die es Spiele gibt.
Arcade: Die zip-Dateien müssen aus dem MAME 2003-Plus-Set stammen. Dateien aus
anderen MAME-Versionen laufen oft nicht. Arcade-BIOS-Dateien (neogeo.zip usw.) kommen in
denselben Ordner arcade. Sie erscheinen nicht in der Liste, weil sie keine Spiele sind.
PlayStation und CD: Nimm .chd (eine Datei pro Disc, braucht weniger Platz) oder
.cue + .bin. Für Spiele mit mehreren Discs legst du eine .m3u-Datei mit einer Disc
pro Zeile an.
Über das Netzwerk
Wenn Wi-Fi oder Kabel verbunden sind, nimmt die Konsole SCP auf Port 22 an (Benutzer
root, Passwort phosphor). In WinSCP wählst du das Protokoll SCP und kopierst nach
/userdata/roms/<system>. Im Terminal:
scp -O "Super Metroid.sfc" root@<IP>:/userdata/roms/snes/
Die IP findest du unter Einstellungen → Informationen. Wenn du über das Netzwerk kopierst, geh zurück zum Startmenü und öffne das System neu, oder starte neu. Dann siehst du die neuen Spiele.
BIOS
Manche Systeme brauchen das Original-BIOS. Es ist nicht enthalten. Es gehört nach
SHARE/bios:
| System | Datei | Pflicht? |
|---|---|---|
| PlayStation | scph5501.bin (USA) · scph5502.bin (EUR) · scph5500.bin (JAP) |
Empfohlen (ohne läuft es mit einem freien, weniger kompatiblen BIOS) |
| Mega-CD | bios_CD_E.bin · bios_CD_U.bin · bios_CD_J.bin |
Ja |
| PC Engine CD | syscard3.pce |
Ja, für CD-Spiele |
| Famicom Disk System | disksys.rom |
Ja, für .fds |
| Game Boy / Color | gb_bios.bin · gbc_bios.bin |
Nein (nur für die Startanimation) |
Bilder in der Liste
Wenn du ein PNG-Bild mit demselben Namen wie das Spiel in roms/<system>/media/ legst,
erscheint es im Feld der Spieleliste (über HDMI). Zum Beispiel:
roms/snes/media/Super Metroid.png.
5. Wi-Fi und Bluetooth
Wi-Fi
- Im Menü: Einstellungen → Wi-Fi. Such nach Netzwerken, wähl deins aus und gib das Passwort mit der Bildschirmtastatur ein. Wenn eine USB-Tastatur angeschlossen ist, kannst du auch direkt damit tippen.
- Am PC, vor dem Start: Öffne auf dem Laufwerk PHOSPHOR die Datei
wifi.txt, entferne die#und trag dein Netzwerk ein:
SSID="MeinNetz"
PASSWORD="MeinPasswort"
COUNTRY=DE
Die Netzwerke werden in SHARE gespeichert. Sie gehen also bei einem Update von Phosphor OS nicht verloren.
Bluetooth-Controller
Einstellungen → Bluetooth → Controller suchen. Versetz den Controller vor der Suche in den Kopplungsmodus:
| Controller | Kopplungsmodus |
|---|---|
| 8BitDo | Start + Modustaste (X, B ...) gedrückt halten, dann die Kopplungstaste |
| DualShock 4 | Share + PS halten, bis das Licht schnell blinkt |
| DualSense | Create + PS halten |
| Switch Pro | Kleine Taste oben, neben USB-C |
Wähl den Controller in der Liste aus. Er wird automatisch gekoppelt. Beim nächsten Mal reicht es, ihn einzuschalten. Um einen Controller zu entfernen, drück zweimal A auf ihm.
6. Das Menü bedienen
| Taste | Im Menü |
|---|---|
| Steuerkreuz | Bewegen |
| A | Öffnen / spielen |
| B | Zurück |
| Y | Als Favorit markieren |
| L / R | Filter: Alle, Favoriten, Zuletzt |
| START | Einstellungen |
Mit Tastatur: Pfeiltasten, Enter (A), Esc oder Rücktaste (B), Y (Favorit), Q/W (L/R) und Tab (Einstellungen). Wenn du weder Controller noch Tastatur hast, geht notfalls auch die Maus: Das Mausrad bewegt, Linksklick öffnet, Rechtsklick geht zurück und ein Klick aufs Mausrad öffnet die Einstellungen.
Während des Spiels
- SELECT + START: Schnellmenü von RetroArch (Spielstand speichern und laden, Optionen ...). Dort bringt dich Inhalt schließen zurück ins Phosphor-Menü.
- Mit Tastatur beendet Esc das Spiel.
7. Einstellungen
| Einstellung | Was sie macht |
|---|---|
| Ausgang | Auto nutzt die Schalter der Platine. Einen anderen Ausgang zu erzwingen erfordert einen Neustart |
| Monitor | Nur CRT: 15-kHz-Fernseher, 15-kHz-Arcade-Monitor oder 31-kHz-VGA |
| H-/V-Position | Nur CRT: verschiebt das Bild, wenn es an einer Seite übersteht |
| CRT-Filter | Nur HDMI: Scanlines oder Röhrensimulation (CRT-Pi ist am originalgetreuesten) |
| Testbild | Gitter und Balken zum Zentrieren und Einstellen des Monitors. Bei CRT zentrierst du live mit dem Steuerkreuz |
| Drehung | 0°, 90° oder 270°, für hochkant gestellte Monitore |
| Theme | Ändert das Aussehen des Menüs (siehe unten) |
| Startanimation | Schaltet das animierte Logo beim Einschalten ein oder aus |
| Menütöne | Die „Blips“ beim Bewegen |
| Controller | Zeigt die verbundenen Controller und lässt dich einen konfigurieren, der nicht richtig reagiert |
| Wi-Fi / Bluetooth | Siehe Abschnitt 5 |
| Informationen | Modell, Platine, Ausgang, IP und freier Speicherplatz |
Einen Controller einrichten, der nicht richtig funktioniert
Wenn bei einem billigen USB-Controller die Tasten vertauscht sind, wähl ihn unter Einstellungen → Controller aus und drück A. Der Assistent fragt jede Taste nach ihrer Position ab. Fehlt deinem Controller eine Taste (X/Y, L/R, SELECT), warte 6 Sekunden. Dann wird sie automatisch übersprungen. Die Einstellung gilt für das Menü und für die Spiele.
Themes
Themes kommen nach SHARE/themes/<name> und werden unter Einstellungen → Theme
ausgewählt. Ein Theme kann nur die Farben oder das ganze Design ändern. Siehe
docs/TEMAS.md im Projekt.
8. Erweiterte Einstellungen (SHARE/phosphor.conf)
Dieselbe Datei, die das Menü ändert, kannst du auch am PC bearbeiten:
PHOS_FORCE_OUTPUT=hdmi # scart | vga | hdmi (leer = automatisch)
PHOS_FORCE_MONITOR= # generic_15 | arcade_15 | vga
PHOS_CENTER_H=0
PHOS_CENTER_V=0
PHOS_ROTATION=0 # 0 | 90 | 270
PHOS_CRT_FILTER=none # none | scanlines | light | crtpi | lottes
PHOS_THEME=phosphor
PHOS_SPLASH=1
PHOS_UI_SOUNDS=1
PHOS_FRONTEND=phosphor # retroarch = stattdessen das RetroArch-Menü verwenden
PHOS_DEBUG=0 # 1 = ausführliches RetroArch-Protokoll
Die RetroArch-Konfiguration liegt in SHARE/system/configs/retroarch/retroarch.cfg, die
Spielstände in SHARE/saves und SHARE/states.
9. Problemlösung
Mit aufgesteckter RGBerry-Platine kommt über HDMI kein Bild. Das ist normal: Mit
Platine ist HDMI aus. Nimm die Platine ab oder trag PHOS_FORCE_OUTPUT=hdmi in
phosphor.conf ein.
Das Bild auf dem CRT ist verschoben oder abgeschnitten. Öffne Einstellungen → Testbild und zentrier es mit dem Steuerkreuz. Wenn der Monitor Regler für die Geometrie hat, stell sie mit dem Testbild ein.
Ein System erscheint nicht im Menü. Prüf, ob die Spiele im richtigen Ordner liegen (Abschnitt 4) und eine Endung aus der Liste haben.
Ein Arcade-Spiel startet nicht. Fast immer ist es eine zip-Datei aus einer anderen
MAME-Version. Nimm das MAME 2003-Plus-Set. Wenn das Spiel ein BIOS braucht (zum Beispiel
Neo Geo), leg auch die BIOS-zip-Datei in roms/arcade.
Der Controller reagiert im Menü, aber nicht in den Spielen. Richte ihn unter Einstellungen → Controller ein.
Nach der Animation bleibt der Bildschirm schwarz. Warte ein paar Sekunden: Wenn das
Menü dreimal hintereinander abstürzt, startet stattdessen das RetroArch-Menü. Wenn du
nachsehen willst, was passiert ist, melde dich per SSH an (ssh root@<IP>, Passwort
phosphor) und schau dir /userdata/system/logs/phosphor-ui.log und retroarch.log an.
10. Lizenzen
Phosphor OS ist freie und kostenlose Software. Einige enthaltene Emulatoren (Snes9x, Genesis Plus GX und MAME 2003-Plus) haben Lizenzen, die keine kommerzielle Nutzung erlauben: Verkauf keine SD-Karten mit vorinstalliertem Phosphor OS und pack es nicht in ein kostenpflichtiges Produkt.