From 04745b997591cf6a3f42c95746d2f58c03c4ab69 Mon Sep 17 00:00:00 2001 From: erickdavestech <54048831+erickdavestech@users.noreply.github.com> Date: Sat, 3 Oct 2026 20:24:37 -0400 Subject: [PATCH] Simplify usage to uploading the .elf through the payload manager portal Releases now ship the .elf only. Issue forms and contributing guide updated accordingly. Signed-off-by: erickdavestech <54048831+erickdavestech@users.noreply.github.com> --- .github/ISSUE_TEMPLATE/bug_report.yml | 11 +------ .github/ISSUE_TEMPLATE/config.yml | 2 +- CHANGELOG.md | 7 +++++ CONTRIBUTING.md | 2 +- README.md | 44 ++++++--------------------- 5 files changed, 19 insertions(+), 47 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml index 52a85aa..336c271 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.yml +++ b/.github/ISSUE_TEMPLATE/bug_report.yml @@ -14,15 +14,6 @@ body: placeholder: v1.0.0 validations: required: true - - type: dropdown - id: format - attributes: - label: File used - options: - - ELF - - etaHEN plugin - validations: - required: true - type: input id: console attributes: @@ -34,7 +25,7 @@ body: id: loader attributes: label: Homebrew enabler and payload loader - placeholder: kstuff-lite + ELF loader on 9021 + placeholder: kstuff-lite + payload manager web portal validations: required: true - type: input diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml index a20fc48..607a370 100644 --- a/.github/ISSUE_TEMPLATE/config.yml +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -5,4 +5,4 @@ contact_links: about: Report security problems privately, not in a public issue. - name: Download the latest release url: https://github.com/erickdavestech/ps5-dualsense-overlay/releases/latest - about: Ready-to-use ELF and etaHEN plugin with checksums. + about: Ready-to-use ELF with checksums. diff --git a/CHANGELOG.md b/CHANGELOG.md index fd2ba11..2ce7c70 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,6 +4,13 @@ All notable changes to this project are documented in this file. The format foll [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and the project uses [Semantic Versioning](https://semver.org/). +## [Unreleased] + +### Changed + +- Usage documentation simplified to one method: upload the `.elf` through the payload manager's web + portal. Releases ship the `.elf` only. + ## [1.0.0] - 2026-10-03 First public release. Based on Common FPS for PS5 v1.2.1 by porhe911 with the SimpleFPS patch by diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 1547e4a..b1ea8eb 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -9,7 +9,7 @@ By participating you agree to follow the [Code of Conduct](CODE_OF_CONDUCT.md). Open an issue with the **Bug report** template and include: -- the overlay version and whether you used the `.elf` or the `.plugin`; +- the overlay version; - console model and exact system software version; - homebrew enabler and payload loader; - the game you were running; diff --git a/README.md b/README.md index 8470602..c720a22 100644 --- a/README.md +++ b/README.md @@ -14,19 +14,9 @@ sticks, triggers and the touchpad in real time. ## Download -Every release contains: - -| File | Use it when | -|---|---| -| `ps5-dualsense-overlay-.elf` | You load payloads with an ELF loader (for example `elfldr` on port 9021). | -| `ps5-dualsense-overlay-.plugin` | You use etaHEN and want the overlay loaded automatically on every boot. | -| `SHA256SUMS.txt` | Checksums to verify both files. | - -Verify the download before using it: - -```bash -sha256sum -c SHA256SUMS.txt -``` +Get `ps5-dualsense-overlay-.elf` from the +[latest release](https://github.com/erickdavestech/ps5-dualsense-overlay/releases/latest). The +release also includes `SHA256SUMS.txt` to verify the file. ## Features @@ -48,33 +38,17 @@ sha256sum -c SHA256SUMS.txt | PS5 | 11.xx – 13.50 | Allowed by the code, not tested | | PS5 | 10.xx and earlier | Code paths inherited from upstream, not tested with this overlay | -Tested with kstuff-lite and the ELF loader on port 9021. Other homebrew enablers may work but have not -been tested. +Tested with kstuff-lite, loading the `.elf` through the payload manager's web portal. Other homebrew +enablers may work but have not been tested. ## Usage -1. Boot the console and start your homebrew enabler as usual. -2. Load the overlay **once**: - - **ELF** — send it to your ELF loader. From Linux, macOS or WSL: - - ```bash - cat ps5-dualsense-overlay-v1.0.0.elf > /dev/tcp//9021 - ``` - - From Windows PowerShell: - - ```powershell - $b = [IO.File]::ReadAllBytes("ps5-dualsense-overlay-v1.0.0.elf") - $c = New-Object Net.Sockets.TcpClient("", 9021); $s = $c.GetStream() - $s.Write($b, 0, $b.Length); $s.Flush(); $c.Close() - ``` - - - **etaHEN plugin** — copy the `.plugin` file to `/data/etaHEN/plugins/` (or to `etahen/plugins/` - on a USB drive) and restart etaHEN. +1. Jailbreak the console as usual (tested with kstuff-lite). +2. From a PC or phone on the same network, open your payload manager's web portal using the console's + local IP and upload `ps5-dualsense-overlay-.elf`. 3. Open any game. The controller appears in the bottom-left corner. -Load only **one** copy per boot. Loading a second copy on top of a running one makes both fight over -the system UI and can end in a *System Software Error*. To update, reboot and load the new version. +Load it only **once** per boot. To update, reboot and load the new version. ## Troubleshooting