ppkantorski/Ultrahand-Overlay v2.2.8

Ultrahand Overlay 2.2.8

on GitHub

List of changes:

1. All language font glyphs are now accessible regardless of the specified language (libultrahand fix).
   • Special thanks to @tomvita.
2. Packages can now utilize language translation json's (similar to libultrahand overlay language translations).
   • Language json's go within the lang folder within the package's main folder and are utilized based upon the current selected overlay language.
   • Translations are based upon drawString calls with keys being the original text and values being the translations.
3. New package command option headers.
   • ;state= works with values handheld or docked and will only draw the list item if in handheld or docked accordingly.
   • ;hos_version= works with version values or with comparison signs >=, <=, >, < + the specified version directly after.
   • ;ams_version= works with version values or with comparison signs >=, <=, >, < + the specified version directly after.
     • Both ;hos_version= and ;ams_version= will only draw the command when the conditions are met.
   • Side-note: All of these new command headers can be used in combination or isolation.
4. New package placeholder variables.
   • {package_version} returns the current package version from which the command exists in (specified in the header).
   • {backlight} returns the current handheld backlight level.
   • {volume} returns the current master volume level.
5. New command !path_exists (similar to path_exists except it returns command failure if the specified path exists).
   • Called !path_exists <SPECIFIED_PATH>.
6. Changes to root package boot package behavior (/switch/.packages/boot_package.ini).
   • The on-boot entry now triggers specified commands once on system startup (similar to how boot used to function).
   • The boot entry now triggers once when the Packages Menu is entered, as well as once on the Packages Menu after overlay hiding has triggered.
7. New Sounds manager for selecting overlay system sound effects (bundled in .zip's).
   • Sound zip packs go in /config/ultrahand/.sounds/ (files must be around the same size as the default sounds pack).
   • The Sound Effects toggle has been removed from the Features page.
   • The NO_SOUND_EFFECTS_UPDATES update flag has now been removed (no longer necessary).
8. Update to Overlay Info, with info properly translated in each supported language.
   • New project developer animation on the "Software Update" page.
   • Languages update command in the Software Update menu has been removed (now unnecessary).
9. Text wrapping for tables has been significantly revised to properly handle asian characters on split as well as implement hyphens for other languages when split by character.
   • Indent symbols for continued lines utilizing indents now properly indent their start position based upon the indentation of the previous line (for easier viewing of code).
10. Scrolling category headers now properly resume scroll state during regular goBack calls (libultrahand fix).
11. Now including patches from Master Volume for unbounded volume sliding from 100% to 150% using the volume command.
12. Download commands now verify internet access on network connection (to prevent hanging while on a network without internet access).
13. The "hold A to execute" list item behavior has been reduced from 4s to 3s to trigger.
14. TrackBar unlocking / locking feedback tweaks.
15. Script overlay freeze bug fix (placeholder replacement infinite loop bug fix).
16. Various boundary case fixes to the List class in libultrahand.
17. Bug fix for package version labels not being displayed clean with Clean Versions enabled.
18. Various additional bug fixes and code optimizations.

New Contributors

• @tomvita made their first contribution in #296

Full Changelog: v2.2.7...v2.2.8

Quick update:

• Sounds preservation on update bug fix. - 02/20/2026 2:14 AM PST
• sdout.zip empty folder inclusion bug fix - 02/20/2026 2:52 AM PST

Full Changelog: v2.2.8...7bc9834