Ultrahand Overlay 1.8.2

List of changes:

1. New Page Swap toggle for swapping the overlays and packages page locations.
   • Located in Settings > UI Settings > Miscellaneous > Effects > Page Swap.
   • This feature will draw the packages menu on the left and the overlays menu on the right when enabled.
2. Fixes to libultrahand for preventing screenshots from occurring during capture event initializations.
   • This is particularly useful for isolating actual capture button events from initializations within projects like bitmap-printer / PNGShot.
     • If using bitmap-printer, it is currently recommended to use a version built with pull request #25 or else there will be dragons (unwanted screenshots in the Bitmaps directory generated every time a libultrahand compiled overlays is opened).
     • If using PNGShot, it is currently recommended to use a version built with pull request #5, however builds from latest source code on the repo should now work as well without producing unwanted screenshots.
   • Notice:
     • All projects built with libultrahand will need to be recompiled with latest libultrahand for this fix to apply.

Full Changelog: v1.8.1...v1.8.2

Update:

• Fixes for returning to overlay menu after exiting overlay with Page Swap. - 11/05/2024 3:06 AM PST
• Touch selection fixes for left / right page with Page Swap. - 11/05/2024 3:33 AM PST
• Dangerous pattern tweak for wildcard patterns within the Album folder. - 11/05/2024 6:42 PM PST

Full Changelog: v1.8.2...d448e61

Ultrahand Overlay 1.8.1

List of changes: (stability update)

1. New package header ;show_version= is an optional true/false option for forcing the menu to show the package version instead of the current section title under the package title. (false by default)
2. Various bug fixes.
   • Fix to Software Update command and Memory Expansion to download nx-ovlloader/nx_ovlloader+ v1.0.8 instead of v1.0.9 if AMS version is < 1.8.0.
   • Fix for forwarder footers being updated when they should not be.
   • Fix for table with null value replacements not correctly aligning Not available / UNAVAILABLE_SELECTION text properly.
   • Fix for combo labels not being converted to their icon counterparts upon initialization.

Full Changelog: v1.8.0...v1.8.1

Ultrahand Overlay 1.8.0

List of changes:

1. Introduction of new true / false command options ;mini= and ;selection_mini= for usage of "mini" ListItems.
   • ;mini=true will enable mini mode for the ListItem. (false by default)
   • ;selection_mini=true will enable mini mode for the dropdown selection ListItems. (for * commands; false by default)
2. Introduction of new command volume to control the system master volume level, called volume <PERCENTAGE> where <PERCENTAGE> is an integer value from 0 to 150.

   • Users can create a volume level slider similarly to a brightness level slider.

     [Volume Level]
     ;mode=trackbar
     ;min_value=0
     ;max_value=150
     ;units=%
     ;on_every_tick=true
     volume {value}

   • Side-note: Max volume scale has been capped at 150%. Will only scale the current active system volume level (not modify it).

3. Package forwarder commands will now update footer labels when modified from within the forwarder package.
4. Option footers will now be automatically loaded from the config.ini upon command success instead of returning a checkmark.
5. Expansion of timestamp placeholder argument to include %f for fractional seconds.
   • Basic timer example:

     [Timer]
     ;mode=option
     ini_file ./config.ini
     try:
     set-ini-val ./config.ini Timer stop {timestamp(%s.%f)}
     set-footer {math({ini_file(Timer,stop)}-{ini_file(Timer,start)})}s
     remove-ini-key ./config.ini Timer start
     try:
     set-ini-val ./config.ini Timer start {timestamp(%s.%f)}
     set-footer ●

6. Various code / compiler optimizations for smaller compilation size.
7. Various bug fixes and subtle UI corrections.
   • Max value bug fix for regular track-bars.
   • Fixes to math placeholder operation parsing.
   • set-footer for null values will now return a failed command.

Full Changelog: 367a0bb...v1.8.0

Ultrahand Overlay 1.7.9

1. Complete rework of the Script Overlay (- / minus on a command).
   • Users can now preview command blocks and execute would be executed commands on the Script Overlay.
   • All command objects are now compatible.
2. Package header routing has now been implemented.
   • This will make it easier for users to tell where they are within the menu when navigating through packages.
3. Ultrahand's overlay development libraries have now been moved to libultrahand.
   • Numerous improvements have been made within libultrahand to make recompiling overlays easier.
   • Users can also use these libraries for their own overlay development, or to rebuild other Tesla overlays with Ultrahand features.
     • A number of overlays have been rebuilt as examples. (see Build Examples)
4. Introduction of new theme colors.
   • default_overlay_color for specifying the default title color for overlays compiled with libultrahand.
   • default_script_color for specifying the default title color for the Script Overlay.
5. Various fixes to track-bars.
   • Users can now also click A to apply track-bar settings.
   • Users can hold R on top of an unlocked track bar to enable changing pages left / right (using D-Pad).
   • Fixes to rapid left / right clicks.
   • Fixes to text alignments.
   • Color swap for cursor over locked / unlocked trackbars.
   • Various touch related bug fixes.
6. New table drawing options and various improvements to table rendering.
   • ;wrapping_mode= can be set to none, char, or word for tables. (default is none)
   • ;wrapping_indent= can be set to true or false for drawing an indent on the wrapped lines.
     • Notice: Wrapping modes will only be applied to the section text on the table.
7. Software update command now updates nx-ovlloader / nx-ovlloader+ as well as the included themes.
   • nx-ovlloader+ has been updated for HOS 19.0.0 support.
     • Notice: This update is required for proper reading of device FUSE data.
8. Fixes for drawing the overlays / packages menu for newly added overlays / packages.
9. Various UI corrections / improvements and code optimizations.
   • Wallpapers now consume half the system memory they used to.
   • Text width computations are now fixed. This should allow Ultrahand to display other fonts and languages more properly.

Full Changelog: aabb4e7...v1.7.9

Update:

• Bug fix for nx-ovlloader+ / nx-ovlloader latest release URL. (was set to v1.0.8 instead of latest) - 10/19/2024 4:57 AM PST
  • If you already updated to v1.7.9 with the "Software Update" menu, you may want to click update 2x. (first update will pull the fixed ovlmenu, second update will pull the correct loader)
• Cleanup of package header route labels. - 10/19/2024 6:25 AM PST

Full Changelog: v1.7.9...367a0bb

Ultrahand Overlay 1.7.8

List of changes:

1. Fix for display underscanning in libtesla.
   • Overlays will need to be rebuilt with this fix for them to also have no issues with display underscan. (see Edizon as an example)
2. New command expansion for backlight called backlight auto (which takes parameter on / off) for controlling the auto screen brightness feature.
   • backlight auto on will turn on the auto brightness feature.
   • backlight auto off will turn off the auto brightness feature.
   • Example toggle:

   [Auto Brightness]
   ;mode=toggle
   on:
   backlight auto on
   off:
   backlight auto off
   

3. New placeholder function math to resolve mathematical expressions.
   • Called {math(MATH_EXPRESSION)} where MATH_EXPRESSION is a mathematical expression like 1+1, (5+4)/9, etc.
   • Can also be called {math(MATH_EXPRESSION, true)} where true forces the output to always be an integer.
   • Users can use +, -, /, *, % as well as brackets ( and ) within their mathematical expressions.
4. New placeholder function random to generate a random integer.
   • Called {random(START_VALUE,END_VALUE)}.
5. New placeholder function length to compute the length of a provided string.
   • Called {length(STRING)}.
   • Any white spaces on the left and right of the string will be trimmed.
6. Placeholder replacement order of operations fix.
   • Users can use nested placeholders called in any sequence now.
7. Removal of old progress animation UI setting.
   • Mostly unused, and a bit out dated in terms of design preferences. I think it is better for now to remove this feature.
8. Bug fix for touch with trackbars.
   • Issue was that sliding to the left of the slidable area caused the value to become the max value for the slider.
   • This should no longer be an issue.
9. Various subtle UI tweaks.

Full Changelog: 73b10bd...v1.7.8

Update:

• Placeholder replacement bug fix. - 09/30/2024 3:06 AM PST

Full Changelog: v1.7.8...aabb4e7

Ultrahand Overlay 1.7.7

List of changes:

1. New table scrolling implementation.
   • ;scrollable= is a true/false table parameter for initializing a table with a scrollable property (false by default).
   • ;top_pivot= is a true/false table parameter for making the top of the table have a selectable property (false by default).
   • ;bottom_pivot= is a true/false table parameter for making the bottom of the table have a selectable property (false by default).
   • A variety of modifications were made to properly handle table scrolling (for touch / click both above and below scrollable tables).
2. Tables can now use list_file_source for reading raw text files directly into a table and displaying the text line by line.
   • Called list_file_source <PATH_TO_TEXT_FILE>
   • Text is drawn in the section portion and can utilize ;section_text_color= for alternative coloring.
3. Various UI related tweaks and fixes.

Full Changelog: d016b6f...v1.7.7

Update:

• Slight table scrolling bug fix. (was miscounting the last step) - 09/15/2024 3:30 AM PST

Full Changelog: v1.7.7...73b10bd

Ultrahand Overlay 1.7.6

List of changes:

1. New symbol placeholder variables.
   • {A}, {B}, {X}, {Y}, {L}, {R}, {ZL}, {ZR}: Button symbols for A, B, X, Y, L, R, ZL, and ZR.
   • {DUP}, {DDOWN}, {DLEFT}, {DRIGHT}: Directional pad (D-Pad) buttons symbols.
   • {LS}, {RS}: Symbols for the left stick (LS) and right stick (RS) click buttons.
   • {PLUS}, {MINUS}: Symbols for the Plus and Minus buttons.
   • {UP_ARROW}, {DOWN_ARROW}, {LEFT_ARROW}, {RIGHT_ARROW}: Arrow symbols pointing up, down, left, and right.
   • {RIGHT_UP_ARROW}, {RIGHT_DOWN_ARROW}, {LEFT_UP_ARROW}, {LEFT_DOWN_ARROW}: Diagonal arrow symbols indicating direction combinations.
   • {POWER}: Power button symbol.
   • {HOME}: Home button symbol.
   • {CAPTURE}: Capture button symbol.
   • {REFRESH_SYMBOL}: Refresh symbol.
   • {WARNING_SYMBOL}: Warning symbol.
   • {INFO_SYMBOL}: Information symbol.
2. New progress symbol throbber implementation. (for commands in progress that do not utilize the progress percentage)
3. Toggle-related bug fixes. (bug was introduced in v1.7.5)
   • This should resolve issues a number of issues with toggles not retaining their state after being clicked.
4. Storage capacity in Device Info has been corrected. (was previously showing free space instead of the amount of space being consumed)
5. Slight UI corrections.
6. Various code optimizations.

Full Changelog: 3801fca...v1.7.6

Update:

• String formatted combo symbols replacements for tables. - 09/10/2024 09:08 PM PST
• Slight tweak to throbber implementation (slightly more optimized). - 09/10/2024 09:46 PM PST
• Arrow symbols fix. (some were mis-mapped) - 09/11/2024 09:00 AM PST

Full Changelog: v1.7.6...d016b6f

Ultrahand Overlay 1.7.5

List of changes:

1. Introduction of new Swipe to Open feature (an alternative to Key Combo for opening Ultrahand).
   • This feature is now on by default, but can be toggled off in Settings > UI Settings > Miscellaneous > Effects > Swipe to Open.
   • To trigger a swipe launch, swipe your finger from off the screen inwards ~1.5cm from the side where the menu is being drawn (left by default or right) in < 150ms.
   • Note: It should be relatively hard to trigger by accident even if you play touch sensitive games, but still easy enough to launch any time you try.
2. Introduction of new placeholder variable {title_id} for returning the title ID of the currently running game / application.
   • Will return null if a game / application is not open.
   • This placeholder should allow some more complex packages to be made.
3. Root package folder exit_package.ini will now have command exit only ran when Ultrahand (and any other running overlay) is completely closed.
4. More bug fixes and code optimizations.
   • Clean-up of progress percentage implementation.
   • Reduction of string copying for various string functions. (faster commands, less memory)

Full Changelog: 0ef1c3a...v1.7.5

Update:

• Slight tweak to Swipe to Open. - 09/09/2024 03:19 AM PST
• lang.zip translations update. - 09/09/2024 05:24 AM PST
• Bug fix for update languages (menu was triggering unnecessary reload). - 09/09/2024 05:36 AM PST

Full Changelog: v1.7.5...3801fca

Ultrahand Overlay 1.7.4

List of changes:

1. Introduction of exit_package.ini (similar to boot_package.ini but with command name exit instead of boot).
   • Exit Commands are now a toggle-able option for package settings. (on by default)
     • The Boot Package toggle has been renamed to Boot Commands.
   • exit_package.ini can go in /switch/.packages/ or be used in /switch/.packages/<YOUR_PACKAGE_NAME>/.
   • When present in package root path, exit commands will be ran every time you close Ultrahand.
   • When present in an Ultrahand package, exit commands will be ran every time you close the package.
2. Temperature widget calls are now read directly from i2c instead of ts/tc services.
   • This should help prevent any conflicts that may have arrises from usage with ts/tc in prior versions.
3. Refinement of tap and hold functions.
   • Holding on a package/overlay for > 0.3s, <= 1.0s then releasing will trigger the Settings key.
   • Holding on a package/overlay for > 1.0s then releasing will trigger the Star key (favorites key).
4. Introduction of Right-side Mode. (located in Settings > UI Settings > Miscellaneous > Effects)
   • This feature will draw the Ultrahand menu on the right side of the screen instead of the left.
5. Updating Ultrahand will now auto-reload the newly installed version when returning to the main menu after.
6. New table command options ;start_gap= and ;end_gap= (same as ;gap=) for manual aligning of tables.
7. More details have been added to the Commands Documentation.
8. Various UI tweaks / corrections.
9. Various bug fixes and code optimizations / cleanups.

Full Changelog: 28e239f...v1.7.4

Update:

• Software update menu bug fix. - 09/07/2024 6:23 AM PST
• Right-side Mode touch fixes. - 09/07/2024 7:48 AM PST

Full Changelog: v1.7.4...0ef1c3a

Ultrahand Overlay 1.7.3

(stability update)

List of changes:

1. Long tap (touch > 0.5s) of an overlay / package on the main menu will now open the overlay / package settings menu upon release.
2. Fuse data is now reloaded / re-dumped upon boot.
   • New true / false option disable_reload is now stored in fuse.ini for manual disabling of the fuse data reload function.
3. More corrections and improvements to the wallpaper swapping feature.
4. Interpreter relevant bug fixes (especially with handing large boot_package.ini files).
   • These fixes should make opening OC Toolkit faster as well as fix the Backup and Restore functions when used with wallpapers.
5. Few additional minor bug fixes.

Important: Fuse data has new key names, so you may need to reboot once or delete sdmc:/config/ultrahand/fuse.ini after updating from v1.7.2.

Full Changelog: 9ff96ba...v1.7.3

Update:

• Slight table text alignment correction. - 09/05/2024 6:10 AM PST
• Various services cleanup. - 09/05/2024 9:35 PM PST
  • Temperature calls now only initialize the temperature service when the temperature widgets are enabled.
  • Reboot To bug fix introduced from prior modification. - 09/05/2024 10:40 PM PST
  • Another bug fix (for toggling on widgets). - 09/06/2024 3:30 AM PST

Full Changelog: v1.7.3...28e239f