PlayShell

Emulators inside the PS5 home screen.

---

Features

• Play retro games right on the home screen, in a pop-up over your tiles. No app to open.
• 10 consoles in one payload: PlayStation, GBA, SNES, NES, Game Boy / Color, Game Gear, PC Engine, WonderSwan, DOS
• JIT for PlayStation and DOS: full speed on the PS5's CPU
• Fullscreen with the touchpad.

Install

Needs a jailbroken PS5 with a payload loader.

1. Load playshell.elf.
2. Put your games in /data/PlayShell/roms/<console> (the folders are made on the first start).
3. Hold R3 on the home screen, pick a console, pick a game.

Consoles

Console	Folder	Files	BIOS (/data/PlayShell/bios)
PlayStation	ps1	.cue .chd .pbp .iso .m3u	SCPH1001.BIN recommended
Game Boy Advance	gba	.gba	gba_bios.bin
SNES	snes	.sfc .smc	-
NES	nes	.nes	-
Game Boy / Color	gb gbc	.gb .gbc	-
Game Gear	gg	.gg	-
PC Engine	pce	.pce	-
WonderSwan / Color	ws	.ws .wsc	-
DOS	dos	.zip .exe .com .bat .iso	-

Controls

Button	Action
Hold R3	Open / close the PlayShell menu (the game pauses)
✕	Open a console / play a game
○	Back / close
L1 / R1	Jump to the previous / next letter in the game list
Touchpad	Fullscreen on / off

Folders on the PS5

Path	What
/data/PlayShell/roms/	Your games, one folder per console
/data/PlayShell/bios/	BIOS files
/data/PlayShell/saves/	Memory cards and saves
/data/PlayShell/crop/<console>.txt	Optional edge crop per console (left right top bottom)
/data/PlayShell/playshell.log	Log

Credits

PlayShell is built on these emulators:

• Mesen 2: NES, SNES, GBA, Game Gear, PC Engine, WonderSwan (GPL-3.0)
• PCSX-ReARMed: PlayStation (GPL-2.0)
• DOSBox Pure: DOS (GPL-2.0)
• Walnut-CGB (Mr-PauI), based on Peanut-GB, with minigb_apu (from MiniGBS): Game Boy / Color (MIT)
• OnionHEN: payload injector, detour library and ShellUI groundwork
• PS5 Payload SDK: toolchain and PS5 libraries

License

GPL-3.0. See LICENSE.