Ultrahand Overlay 2.5.2

List of Changes

1. New ;text_color= and ;footer_color= command headers for command list items.
   • ;text_color=<HEX> and ;footer_color=<HEX> (rgb888, e.g. #RRGGBB or RRGGBB) set a custom title/value color for that specific item.
   • Applies to standard list items, toggles, and dropdown-selection items; takes priority over theme defaults but never overrides transient run-state colors (spinner/checkmark/crossmark/in-progress).
2. New ;bg_color= and ;border= table command headers.
   • ;bg_color=<HEX> sets a custom table background color. Only the RGB channels are used (alpha is still read from the theme).
   • ;border=true/;border=false toggles the table's border on or off independent of Dynamic Tables.
3. New matching_hex_val_custom <FILE_PATH> <ASCII_PATTERN> <OFFSET> <HEX_VALUE> conditional command (and inverse !matching_hex_val_custom).
   • Resolves <OFFSET> relative to the file offset of <ASCII_PATTERN> (e.g. "CUST"), using the same magic-scan + offset cache that hex-by-custom-offset writes use.
   • Usable standalone or with ;visibility_condition=/;toggle_state_condition=, same as the other matching_* checks.
4. New In-Package Titles toggle in Widget Settings (in_package_titles, on by default).
   • Separate from the existing Package Titles toggle. When off, every in-package (sub-menu) title is forced to the theme's default package title color, overriding any color a package requested via its own header (e.g. ;color=).
5. Input handling changes to prevent accidental hides while a command is running.
   • X now hides the overlay while a command is running (moved off B), so reflexively pressing B to "go back" no longer hides the overlay mid-command.
   • B is swallowed during a running command instead of hiding or popping the menu.
   • D-pad and A now visibly bounce the highlighted item while a command is running, instead of incorrectly triggering a click animation.
6. Settings menu navigation bug fixes.
7. Fixed overlay/package list titles and versions not switching to the theme's Selection Text/Value color when highlighted.
   • These now use the new base-color path internally, so highlighting behaves correctly again while still supporting the new ;text_color=/;footer_color= per-item overrides.
8. Slight changes to the default theme colors and settings.
   • Dynamic Logo now defaults to off instead of on.
   • Side-note: For color changes to be applied, users must re-apply their default theme, or install Ultrahand fresh.
9. Refreshed default theme colors (click, dynamic logo, main logo, and table background), and added a new bundled classic.ini theme.
   • classic.ini preserves the exact pre-2.5.2 default color palette for anyone who prefers the previous look.
10. Improved download reliability for usage with a wider range of url domains.
11. Foreground related bug fixes in libultrahand.
12. Fixed a mismatched declared size on the default key-combos array.

Full Changelog: v2.5.1...v2.5.2

Quick Update

• Foreground request related bug fixes. - 07/10/2026 02:54 AM PST
• Slight tweaks to default theme. - 07/10/2026 4:20 AM PST
• New table wrapping mode auto + bug fixes for notification translations / alignments. - 07/10/2026 7:35 AM PST
  • auto utilizes character wrapping for Asian languages and word wrapping for non-Asian languages.
• New Ultrahand config.ini key swipe_offset (integer value; optional) for calibrating the swipe to open behavior's X-start. - 07/10/2026 7:35 AM PST
• Hard line break fix for table wrapText (proper handling of newlines). - 07/10/2026 08:04 AM PST
• Add translation handling in CategoryHeader constructors. -07/10/2026 8:33 AM PST

Full Changelog: v2.5.2...61407f7