Skip to content

ps5-theme 1.55

Choose a tag to compare

@Blaze414 Blaze414 released this 13 Oct 12:58
· 25 commits to main since this release

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.55 (since 1.53)

Fonts

  • Replace the console's text fonts with a TrueType or OpenType font of your own: the home screen's and Settings' text, in the Latin alphabet and in Arabic, Thai, Vietnamese, Japanese and Korean. In the editor, switch on Fonts.
  • Use one font for all Latin interface text changes the Latin text in one step. The fonts marked Home screen are the ones the home screen draws with: on a 13.42 console it uses only the Light and Bold weights, so changing the regular and medium ones shows nothing there (web pages use them).
  • The change shows after you put the console in rest mode and wake it: the manager and a console notification say so.
  • Only the home screen gets the font. A font goes into the home screen's own view of the fonts folder and comes out of it the moment the home screen closes for rest mode. Games read the same folder, so the real folder is never changed.
  • Every font is checked before it is accepted. It must be a whole TrueType or OpenType font, with the tables every font needs, glyph counts and metrics that agree, and the Latin letters, digits and punctuation text needs. Font collections (.ttc), web fonts (WOFF), damaged or cut-short files, and symbol fonts are refused with a plain reason. If the home screen keeps restarting with a font, the plugin takes the theme down by itself.

Corner shapes (1.54)

  • In Interface icons, change how round the interface's buttons, switches, slider handles, menus, tooltips, tags and other parts are, one by one (0 makes a part square-cornered). The editor accepts only the console's own list of names with plain numbers, and nothing else in the file may change.
  • Not changed: the home screen's tiles keep their shape, and the overall multiplier in the list showed no visible change. The tiles' corners are set in the home screen's own program, not in a file a theme can swap.

Developer tool

  • ps5-fontscan.elf (build it from tools/fonts) lists the font files each process has open or mapped, read-only. It is how the plugin's author found which fonts the home screen draws with.

Checked

47 end-to-end tests on the host (full and emulated), the font check fuzzed (7.3 million inputs, no findings), and a PS5 with 13.42: a replaced font showing on the home screen after rest mode, and the scan of the fonts each process uses. The README's Tests on the console lists each test, and Fonts tells how it works.

See the README for the full guide.

Checksums (SHA-256)

d927594828a05f7982edd8995a09cbfe74cbe1528336dd2f4acf2c903008932b  ps5-theme.plugin
4b9d0a78aafc5f8315970d9bc19e08b85837cffd32368facde2d3155866d162e  ps5-theme.elf
0e15bc9a3721d507b4cfbdf57637b4278d6062cf384780f10d5dd6c0ea2a4960  ps5-theme-stop.elf