github Tom-Bom-badil/home-assistant_ugreen-nas v2025.10.3
Improve API polling and device builder

10 months ago

πŸ‘‰ For end users

Workaround for UGOS bug: Better WebSocket keep-alive

  • UGOS stops feeding the API for some specific sensors after a few minutes if neither the UGREEN Mobile App nor the NAS Web GUI is active. This release brings the proven fix from the former "Token Proxy Container" directly into the integration. Sensors like CPU temperature/usage and RAM now continue to update 24/7 without keeping the GUI/App open.

Improved Home Assistant Devices view

  • The devices view (Settings β†’ Devices & Services β†’ Devices β†’ UGREEN) has been improved. Sub-devices now show more useful information. Also, the NAS’ customized device name (UGOS Web GUI β†’ Customized device name) is used as the main device label from now on to support the coming Multi-NAS feature.

Thanks to everyone who supported with bug reports, discussions and testing - much appreciated! :)
@rexprojects @Sineiko @tju79 @smartmatic @TomberWolf @h1nnak @limofant @dobby5


πŸ‘‰ For fellow developers (internal changes)

WebSocket

  • The old ws_keepalive coordinator has been removed from init.py. It was replaced by a background keep-alive task in api.py that mirrors the behavior it used to have in the Token Proxy Container (connect β†’ subscribe β†’ periodic ping β†’ continuous receive β†’ backoff reconnect β†’ one-shot re-auth on 401/403).

Device information

  • The device builder in init.py now stores/caches selected details (disks, pools) for the device registry, reducing repeated lookups and improving the HA devices view.

General improvements

  • Minor refactors, removal of unused imports, and clearer inline comments/docstrings.

Don't miss a new home-assistant_ugreen-nas release

NewReleases is sending notifications on new releases.