Repository navigation
ps5-theme 1.59
Custom home-screen themes for jailbroken PS5 consoles on firmware 13.60 and below. Runs as an etaHEN plugin or on its own from any ELF loader. Tested on firmware 13.42, both with etaHEN 2.5B (unified build) and from PS5 Payload Manager.
Which file?
ps5-theme.plugin: for etaHEN. Copy it to/data/etaHEN/plugins/and turn on auto-start.ps5-theme.elf: the same program for PS5 Payload Manager or any ELF loader (port 9021). No etaHEN needed.ps5-theme-stop.elf: only for when the manager can't be reached. Start it from Payload Manager or a payload loader, then start ps5-theme again. It stops the plugin and leaves your theme on the screen. Put it in a folder of its own under/data/pldmgr/payloads/.
Updating
- From 1.23 or later: copy the new file over the old one (or put it in
/data/ps5-theme/update/). Within about 10 seconds the running plugin finds it and hands over, keeping your theme on the screen. No restart needed. - From 1.22 or older: copy the new file and restart the console once.
- If you keep a copy in PS5 Payload Manager, replace that one too, so an old version isn't started from there.
New in 1.59 (since 1.57)
- Colours for the Appearance themes. In Appearance themes > Colours, Edit colours sets the colours of the Welcome widgets and the pills above them, the Control Center's backdrop and card, the button hints, the text in Settings and menus, and the accent, for every Appearance theme. Console's colours puts them back. For the widgets' colour, turn off Use System Appearance for Widgets in the Welcome hub's settings. A colour test and a panel test, each with a key, show what the other colours change.
- Help marks. A ? beside each setting, section, file and colour says what it changes. Point at it, or tap it on a phone.
- Progress you can follow. Anything that takes a while says what it is doing, with a percentage, including how much of an upload has reached the console. The bar only moves forward. Parts that wait for a large file from the console (the colours, the interface files) show what they are reading and how far it has got, with Try again if it can't be read.
- Faster colours and corner shapes. They read only the interface file that holds them, instead of all eight (about 82 MB).
- Fixes:
- After a Discard, a theme could keep a temporary upload file, and every apply then said "applied partly". Discard and Duplicate now leave such files out, and an apply ignores them and removes one that was cut off.
- "Applied partly" counted the wrong things ("107 of 27 folders"), and a long result was cut off mid-sentence. It now says what was skipped, with every hint in full.
- Two uploads at the same moment could fail with "empty or unreadable file" or "not a resource file (.rco) of this kind". Each upload now has its own temporary file.
- Changes to the interface file are made one at a time, so a quick second click no longer undoes the first.
- Changing a piece's placement shows its progress at once, and changes made in quick succession no longer race.
- Minor fixes.
Everything in 1.57 is included.
Checked
54 end-to-end tests on the host (full and emulated), and a PS5 with 13.42: the colour tests, the panel test and the colour editor, the help marks and progress, and a theme that applied partly after a Discard now applying in full. Tests on the console lists each test.
See the README and the documentation for the full guide.
Checksums (SHA-256)
c565bcb058319c6827d52657c72580f89a6b62e0a68104a38aef0fe9d09b4f2a ps5-theme.plugin
313466bec183320d3603aab2338eb494ea5d8b206622bb6a4262347aa1396cf8 ps5-theme.elf
0e15bc9a3721d507b4cfbdf57637b4278d6062cf384780f10d5dd6c0ea2a4960 ps5-theme-stop.elf