ppkantorski/Ultrahand-Overlay v2.2.0

Ultrahand Overlay 2.2.0

on GitHub

List of changes:

1. New overlay heap size configurations with automatic reloads (in the System Settings menu).
   • Default heap size for HOS 21+ is now set to 4MB (displayed as nx-ovlloader-).
     • Although rare, some overlays may not work properly on 4MB (without a fix implemented).
       • To fix some of these overlays, they should be using socketInitialize instead of socketInitializeDefault (if utilized).
       • Overlays should also not be utilizing a full 1280x720p framebuffer when on 4MB.
   • Default heap size for HOS 20 is now set to 6MB (displayed as nx-ovlloader).
   • Default heap size for HOS 19 and lower is now set to 8MB (displayed as nx-ovlloader+).
   • Users can also add a 4th higher option by adding to /config/ultrahand/config.ini a new section memory with key custom_overlay_memory_MB and an integer value (2MB intervals greater than 8MB only).
     • After adding that entry, a 4th memory option will appear (displayed as nx-ovlloader×).
   • If Ultrahand deems there is not enough memory (at least 5.3 MB free after potential changes), then changes will not be applied.
2. Users can now completely exit the overlay system from the System Settings menu.
   • This will recover all memory consumed by nx-ovlloader / Ultrahand Overlay.
   • Users can then use Ultrahand-Reload.nro from homebrew launcher (now bundled with nx-ovlloader) to restart / reset nx-ovlloader without rebooting.
3. Commands move, copy, delete, and dot-clean memory optimizations.
   • Larger deletes, moves, and copies than v2.1.8 are now possible (even on a 4MB heap).
   • dot-clean now also removes all .DS_Store files for the specified directory (and subdirectories).
4. Now bundled with nx-ovlloader v2.0.0 (which includes the new helper module nx-ovlreloader).
   • nx-ovlloader+ compilation has been discontinued (no longer necessary).
   • The nx-ovloader+ zip on v2.0.0 is the same as nx-ovlloader.
     • It is provided for now during a grace period to ensure users can easily update from the system settings menu.
     • In the future after nx-ovlloader v2.0.0, if not on Ultrahand Overlay v2.2.0+, update methods might be broken.
   • Side-note: Users no longer need the /config/ultrahand/expansion/ folder and can safely delete it after updating.
5. Software updates now have the option to download a temporary update.ini command file (if provided on release) for micro managing the installation / update process.
   • Software updates instructions have also been slightly reworked for easier management.
6. Command exec now can be called with any package ini file (in addition to boot_package.ini like before).
   • Users can call this with exec <ENTRY_NAME> [ULTRAHAND_INI_FILE_PATH].
     • ULTRAHAND_INI_FILE_PATH in this case is an optional parameter, the path to the package ini file containing the command entry.
     • When not provided, it will assume commands from boot_package.ini (just like before).
7. Slight improvements to notifications (new tsl::notification->showNow implementation).
   • This allows instant display of the notification without waiting for the last notification to transition.
   • Packages can also use showNow via notify-now or notification-now (called the same way as notify / notification).
8. Sound effects now work on 6MB+ overlay heap sizes (disabled on 4MB).
9. Improvements to TrackBar touch.
10. Improvements to touch haptics (now to trigger on touch).
11. Improvements rounded rects and circles (slightly more refined AA).
12. Changes to socket initialization for improved memory usage (enables downloads on 4MB and improved memory).
13. Bug fix for haptics becoming disabled after sleep.
14. Bug fix for ;display_title= in packages interfering with proper returns to the last selected list item on the menu (as seen with returning from Alchemist).
15. Various tweaks, optimizations, bug fixes, and corrections.

Full Changelog: e84de59...v2.2.0

Update:

• Bug fix for software updates from v2.2.0 forwards. - 11/28/2025 8:36 PM PST
  • New command download-no-retry for download commands with zero retry attempts.
  • More accurate failed download detections.

Full Changelog: v2.2.0...3711fd0