Skip to content

OnionHEN v0.0.12

Latest
Latest

Choose a tag to compare

View all tags
@aydencharles aydencharles released this 31 Aug 00:03
· 2 commits to main since this release
v0.0.12
d99db5a
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

OnionHEN v0.0.12

OnionHEN is a homebrew enabler and Toolbox for jailbroken PS5 consoles, built on etaHEN. It prepares the system, injects a Toolbox into the home screen, and adds cheats, in-game overlays, payload management, and background services.

Supported firmware: 4.03 – 12.70

Quick start

  1. You need an already-jailbroken PS5 and an external elfldr (the first-hop loader) listening on port 9021.
  2. Send OnionHEN.elf using a payload sender, such as itsPLK's PS5 Payload Manager.
  3. Wait for OnionHEN to start. It may take a couple of seconds, so just wait and don't do anything while it is starting.
  4. Open Settings on your PS5 to enter the Toolbox, or use the shortcut in the top-right corner of the home screen.

What's new

Multiple cheat files work together

For one game, you can now use cheat files of different formats and from different sources at the same time. JSON, SHN, MC4, and ShnExt files for the same title can coexist, and all compatible ones are loaded together. Previously, only one format was used per game.

See #60.

Cheat catalog keeps original file names

After downloading the community cheat collection from the Toolbox, the installed files keep their original names.

See #59.

Monitor bar alignment

The monitor bar metrics can be aligned to the left, center, or right of the screen edge. Choose it in Toolbox → Overlay → Monitor bar alignment, or in config.ini:

[overlay]
align=center

align accepts left, center, or right (default center).

Changelog

All changes since v0.0.11:

  • 7092dd6 feat(cheats): load all compatible sources together
  • a92e8a6 refactor(cheats): drop deprecated hash aliases
  • 6803b4a refactor(cheats): copy HENCC files without renaming
  • 10779c1 fix(cheats): unescape titles and localize toasts
  • b344e2d feat(overlay): add left/center/right metric align
  • d99db5a feat: merge dev — Cheat handling and overlay customization (PR #65)

Full diff: v0.0.11...v0.0.12

Cheats

OnionHEN loads cheat files directly from the console storage at runtime.

Supported formats

  • .json
  • .shn
  • .mc4
  • .ShnExt

Installation

Place cheat files directly in:

/data/OnionHEN/cheats

Subfolders are not supported.

Cheat filenames follow:

<TITLE_ID>_<VERSION>[_<PROCESS>][_<SOURCE_ID>].<EXTENSION>

PROCESS is optional and restricts the file to that process. SOURCE_ID is an optional 8-hex segment that distinguishes files from different sources. All compatible files for the title/version/process are loaded together, regardless of format.

For example:

PPSA02225_02.024.000.json

The cheat file must match the game's title ID and version. Using a cheat from another game version may cause it not to load, not to work, or behave unexpectedly.

Download

From the Toolbox Game Tools page, you can download the cheat collection over HTTPS. OnionHEN installs the json/, shn/, and mc4/ files into /data/OnionHEN/cheats, keeping their original names. The source is HEN-Cheats-Collection. auto uses cnb.cool when the UI/system language is Simplified Chinese, otherwise GitHub.

Overlay

From Toolbox → Overlay you can enable the monitor bar and pick:

  • Screen edge: top or bottom
  • Metric alignment: left, center, or right
  • Which metrics to show: CPU, GPU, RAM, FPS, network info

Payloads

Place standalone payloads in:

/data/OnionHEN/payloads

Only plain .elf files are supported. Auto-start can be turned on in the Toolbox; OnionHEN remembers that choice with a matching .auto_start file next to the ELF.

Fan control

OnionHEN includes fan control with a configurable temperature threshold.

App jailbreak

Allowlisted homebrew applications can request additional privileges from the OnionHEN daemon. Supported applications such as Xplorer can use this mechanism to obtain the privileges they require.

kstuff

OnionHEN v0.0.12 bundles kstuff-lite 1.10.

Kstuff loads at startup by default. Turn that off from Toolbox → Plugins → Kstuff, or skip the bundled kstuff by creating an empty file:

/data/OnionHEN/no_kstuff

or:

/mnt/usb0/no_kstuff

Your own kstuff must already be running when OnionHEN starts.

To use a replacement kstuff payload, place it at:

/data/OnionHEN/kstuff.elf

Not included compared with etaHEN

The following etaHEN features are not currently included:

  • itemzflow plugin system.
  • .prx / .sprx plugin loading.

Known issues

Notifications / shortcuts on some firmware

Notifications or shortcuts may not appear on some firmware versions. This has been reported on firmware 4.03–6.xx.

See #11.

Important

Hotkey conflicts

Do not run OnionHEN together with other hotkey-injecting plugins or tools.

This includes:

  • Stock etaHEN
  • CheatRunner
  • PHU Tools
  • YonCore
  • Kylin Core cheats

If another hotkey-injecting component is loaded before OnionHEN, the console may hang or power off.

File locations

Purpose Location
Cheats /data/OnionHEN/cheats
Payloads /data/OnionHEN/payloads
Disable bundled kstuff /data/OnionHEN/no_kstuff or /mnt/usb0/no_kstuff
Replacement kstuff /data/OnionHEN/kstuff.elf
Crash log /data/OnionHEN/OnionHEN_crash.log

FAQ

My cheats don't load.

Make sure the cheat file:

  • Uses a supported format.
  • Is placed directly in /data/OnionHEN/cheats.
  • Is not inside a subfolder.
  • Uses a <TITLE_ID>_<VERSION> filename, with optional process and source ID.
  • Matches the game version you are running.

You can also download the community collection from the Toolbox.

Notifications or shortcuts don't appear.

This has been reported on firmware 4.03–6.xx and is still being investigated.

See #11.

Can I load .prx / .sprx plugins like GoldHEN?

Not yet.

See #17.

Can I run OnionHEN alongside etaHEN or other hotkey tools?

No. OnionHEN should not be used together with other hotkey-injecting tools such as stock etaHEN, CheatRunner, PHU Tools, YonCore, or Kylin Core cheats.

Support

Like the project? Consider supporting it on Ko-fi:

Support OnionHEN on Ko-fi

For Chinese users, you can also scan the QR codes below to donate:

国内简中用户也可以扫描下方二维码进行捐赠：

支付宝（国内） 微信（国内）
支付宝 微信

Credits

Thanks to the etaHEN team for their work and for making OnionHEN possible.

OnionHEN is built on top of etaHEN.

Contributors

Referenced

  • kstuff-lite — EchoStretch, sleirsgoevy, and contributors; bundled kstuff and Rest Mode Toolbox recovery
  • ftpsrv — drakmor and upstream contributors; in-process PS5 FTP server
  • HEN-Cheats-Collection — TeeKay87; the cheat catalog downloaded by the Toolbox
  • PHU Games Tools — ArkSama; FPS sampling used by the monitor bar
  • ps5-payload-manager — itsplk; Rest Mode listen-socket recovery
Assets 3
Loading