Skip to content

ps5-theme 1.53

Choose a tag to compare

View all tags
@Blaze414 Blaze414 released this 13 Oct 04:21
· 27 commits to main since this release
v1.53
c5d72a8

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 (new): 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.53 (since 1.30)

Game and app icons

  • Change the icon, background and logo of any installed game or app: PS5 and PS4 games, homebrew, and games whose tile shows PlayStation Network artwork. Each picture is written into every file that holds it, in exactly the console's format (PNG, BC7 and DXT1 textures, and the WebP and JPEG files the console keeps under .png names).
  • The Game Library and the backgrounds show the new pictures as soon as the theme is applied. The home screen's icons change once you put the console in rest mode and wake it. The manager and a console notification remind you.
  • Games and apps keep starting. The pictures go only into the home screen's own view, and the plugin takes them out the moment the home screen closes for rest mode, even in the middle of an apply. An overlay left there was what stopped every game and app from starting (error CE-105733-9) in earlier test builds.
  • The buttons say what each picture is (Change icon, Change background, Change logo) and where it appears.

Interface icons and home screen tiles

  • Interface icons: replace the pictures the console draws from its interface file (search, settings, the Control Center and more), each written in exactly the console's format. Number vector icons and Number all show which picture is where.
  • Home screen tiles: change the icons of the console's own tiles (PlayStation Store, Game Library, Media tab and others) and the background shown while one is selected, with a numbered test.

Home music

  • After applying a theme with music, the manager and a console notification say how to hear it: highlight a game or app that plays its own music, let it play, then go back to the home screen.

More reliable

  • The manager comes back by itself after rest mode. Rest mode could leave the plugin's web server deaf for good; it now opens its socket again.
  • Starting the plugin again always works, even when the running copy doesn't answer: the new copy finds it and asks it to hand over.
  • ps5-theme-stop.elf stops the plugin without a restart, keeping the theme.
  • An overlay still in use is never forced off; the new theme or the system's own files go on top until it's free. Forcing it off had broken the home screen's views and made it restart about once a minute.
  • The crash guard also catches a slow restart loop (5 restarts in 10 minutes) and no longer mistakes old sandboxes for restarts.
  • Overlays are taken out by what the console's mount table shows, so one missing from the plugin's records can't be left behind.

Checked

46 end-to-end tests on the host, the parsers fuzzed again, and a set of console tests run on a PS5 with 13.42: rest-mode cycles with games and apps started each time, rest mode in the middle of an apply, theme switches, Restore stock, a console restart, updates over a running copy, and the stop tool. The README's Tests on the console lists each one, and Changing game and app icons safely tells what it took.

See the README for the full guide.

Checksums (SHA-256)

8fc91dc019bfeb2dc3335a17f8c02b537cd3e364f5c8b3cb38e3a15fde5df503  ps5-theme.plugin
df820dba01c765225a7d31bb782f9469c84ad7885de422a9b6d276947fe72c16  ps5-theme.elf
e78f88d0a2c357b2c8b42e2dc705380f215bdd1c18ae61310baad48db426f9c7  ps5-theme-stop.elf
Assets 5
Loading