erickdavestech--ps5-dualsense-overlay/CHANGELOG.md

Changelog

All notable changes to this project are documented in this file. The format follows Keep a Changelog and the project uses Semantic Versioning.

[Unreleased]

1.0.1 - 2026-10-04

Added

• Periodic foreground user detection (~every 2 seconds) to automatically re-bind the DualSense controller handle when switching local accounts.
• Automatic non-blocking retry (~30 frames / 0.5s) when acquiring controller handle on resume or before user login.
• Screenshots of the overlay in the README, with attribution to the games shown.
• Security policy with response times, coordinated disclosure and download verification; code owners file.
• Continuous integration: host tests, upstream source gate, plugin wrapper test and the PS5 build with release verification on every push and pull request; Dependabot updates for the pinned actions.

Fixed

• Overlay freeze after Rest Mode (sleep/resume): Fixed issue where sceUserServiceGetForegroundUser returning 0xffffffff (-1) during console standby or before logging into an account caused pad initialization to permanently fail, leaving the overlay visible but unresponsive.
• Controller disconnect / standby recovery: If scePadReadState fails for 15 consecutive frames (e.g. controller turned off, Bluetooth drop, or system suspend), the dead handle is now safely closed via scePadClose and re-acquired automatically.

Changed

• The dependency script and DEPENDENCIES.lock.json pin PS5 payload SDK v0.43.
• Usage documentation simplified to loading the .elf with a payload manager, through its web portal or from a USB drive.
• Documented that the overlay must not run together with Common FPS or SimpleFPS.

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 khalifa007.

Added

• DualSense controller overlay: buttons, sticks with an L3/R3 ring, analog L2/R2 fill and touchpad dot; semi-transparent, bottom-left and sharp at 4K.
• Controller input read from inside SceShellUI with scePadReadState (libScePad resolved with a NID fallback).
• Embedded controller artwork ("PS5 Button Icons and Controls" by Zacksly, CC BY 3.0, modified) and the pipeline that generates it (tools/build_assets.py).
• The overlay arms itself without a game, appears when a game opens and rebuilds on game changes.
• Release verifier (tools/verify_release.py) and an etaHEN plugin identity of its own (DSOV00001, version 1.00).
• Research probes in probe/.

Changed

• Game detection ignores system applications and dialogs (title IDs starting with NPXS, read with sceKernelGetAppInfo), so the renderer is never injected for a system dialog.
• The renderer prefers the Application.Update hook and falls back to the legacy main-thread guard.
• On system software 11.xx–13.xx the hook write uses MDBG with a temporary RWX remap that covers every code page the write touches.
• Released sprites are removed from the scene, and leftover widgets are cleaned up before rebuilding.
• Assets are written to and loaded from /Temp, because SceShellUI cannot read /data.
• Host tests updated for the new firmware backends and defaults.
• The build script runs the release verifier of this project.

Removed

• FPS counter drawing and the FPS sampler: the payload no longer attaches to, scans or reads the game process, and no longer touches /dev/dce.
• Upstream FPS configuration example and CI workflows that do not apply to this project.

Fixed

• System Software Error crashes when loading the overlay: system dialogs are no longer treated as games, the hook write covers every page it touches and released sprites no longer leak in the scene.
• Controller sprites staying pressed while a system menu intercepts the input.

Known limitations

• The PS button cannot be read (intercepted by the system).
• The Mute button is disabled: the controller only reports the momentary press.