Ultrahand Overlay Switch: Difference between revisions

Ultrahand Overlay
Ultrahand Overlay
General
Author	ppkantorski
Type	Overlays
Version	2.3.0
License	Mixed
Last Updated	2026/03/13
Links
	Download
	Website
	Source
	Support Author

← Older edit Newer edit →

Revision as of 07:15, 14 March 2026

Ultrahand Overlay is a Tesla Menu replacement built from the ground up off of libtesla that provides powerful C/C++ commands through the usage of its own custom interpretive programming language (similar to Shell/BASH). It is a versatile tool that enables you to create and share custom command-based packages, providing enhanced functionality for managing settings, files and directories on your Nintendo Switch.

With Ultrahand, you have the flexibility to customize and shape your file management system according to your needs, empowering you with greater control over your system configurations.

Features

Ultrahand Overlay currently offers the following features:

Create Directories:
- Effortlessly create directories on your SD card by specifying the directory path. Ultrahand will handle the creation process for you.
Copy Files or Directories:
- Easily copy files or directories from one location to another on your SD card. Just provide the source and destination paths, and Ultrahand will seamlessly handle the copying process.
Delete Files or Directories:
- Simplify file and directory deletion on your SD card. By specifying the path of the file or directory you want to delete, Ultrahand promptly removes it, making the deletion process hassle-free.
Move Files or Directories:
- Seamlessly move files or directories between locations on your SD card. Provide the source path and the destination directory path, and Ultrahand takes care of the moving process, ensuring smooth relocation.
Download Files:
- Download files to your SD card with ease. Efficiently retrieve files from repositories or URLs to your desired location. Whether you need to download/update homebrew or transfer files between locations, this feature simplifies the process, making repository management a breeze.
Unzip Files:
- Extract compressed zip files on your SD card by unzipping archived files, preserving their original structure. Whether you have downloaded zip archives or received compressed files, this command simplifies the process of extracting them, making it effortless to access the contents within.
Modify INI Files:
- Edit INI files on your SD card with ease. Take full control over your configurations by updating existing key-value pairs, adding new entries, or creating new sections within the INI file using Ultrahand.
Hex Edit Files:
- Perform hexadecimal editing of files on your SD card. Edit the binary data directly, allowing for precise control over your data. Ultrahand's Hex Edit Files feature enables you to analyze, modify, and customize files in their raw form.
Convert Mods:
- Convert pchtxt mods into ips or cheats format.
System Commands:
- There are a variety of system commands that users can utilize. These include functions to shutdown, reboot, reboot directly into Hekate entries/modes, manipulate the screen's backlight, and turn off all bluetooth controllers.
Run Commmands On Boot:
- Users can also utilize their own /switch/.packages/boot_package.ini file (with a command section boot) to run a series of commands once upon device boot-up.

Installation

Your Nintendo Switch must have the necessary homebrew environment set up, running HOS (Horizon Operating System) version 16.0.0 or above.

Make sure you have nx-ovlloader installed.
Download the latest Ultrahand ovlmenu.ovl and place it within "/switch/.overlays/".
- Warning: This will overwrite Tesla Menu if already installed.
After installing Ultrahand Overlay, a new folder named "ultrahand" will be created within the root config folder on your SD card (/config/ultrahand/) along with a config.ini file containing various Ultrahand settings.
Launch Ultrahand similarly to Tesla Menu with your specified hotkey. A new folder will be made ("/switch/.packages/") with a preset package.ini file for your base menu commands.
Place your custom "package.ini" package file in your Ultrahand package directory ("/switch/.packages/<PACKAGE_NAME>/"). This file will contains the commands for your custom Ultrahand package.
Your commands will now show up on the packages menu within Ultrahand.

See Ultrahand Packages for a comprehensive list of known packages.

For additional assistance with custom packages, feel free to checkout the Ultrahand Overlay Wiki.

Controls

A - Execute any command

Minus - View/execute the individual command lines written in the ini for execution

Plus (main menu) - Enter the settings menu

X - Click on top of an overlay/package to star them

Y - Click top of an overlay/package to configure additional settings

Screenshots

Compatibility

HOS 16.0.0+

Changelog

Version 2.3.0

Numerous improvements to the notifications implementation.
- Notification options have been moved to the Notifications Menu (in System Settings).
- Multiple notifications can be shown at once (up to the Max Slots value).
  - When using 4MB overlay memory, max slots is capped at 4, otherwise it is capped at 8. (default value 4)
- API Notifications (formerly known as External Notifications) are formatted as follows:

    {
        "text": "This is an example notification.",
        "font_size": 24, #optional
        "split_type": "word" #optional, word by default
        "alignment": "left", #optional, center by default without a title
        "duration": 4000, #optional duration in ms
        "title": "Example App", #optional, allows show_time
        "show_time": "true", #optional, true by default
        "priority": 20, #optional (ideally not modified)
    }

- - Stored in /config/ultrahand/notifications/{APP_ID}-{UNIQUE_ID}.notify (JSON format)
  - API Notifications can be filtered with the existence of /config/ultrahand/flags/notifications/{APP_ID}.flag.
- Notification icons are now supported and must be 50x50 RGBA format with {APP_ID} matching the notification json.
  - /config/ultrahand/assets/notifications/{APP_ID}.rgba
- Package command notify / notification and notify-now / notification-now has been expanded.
  - notify <MESSAGE> [FONT_SIZE] [TEXT_ALIGNMENT] [SPLIT_TYPE] [DURATION_MS] [TITLE] [SHOW_TIME] [APP_NAME]
    - <MESSAGE>: the main notification message text. (only 4 lines can be displayed)
    - [FONT_SIZE]: an integer value in range 8 to 48 (24 by default with a title, 26 without a title).
    - [TEXT_ALIGNMENT]: either left, center, or right.
      - By default, without a title it is center and with one it is left.
    - [SPLIT_TYPE]: either word or char.
    - [DURATION_MS]: the duration for the prompt in milliseconds. (500 min, 4000 by default)
      - A duration value of 0 will keep the prompt displayed indefinitely until dismissal.
    - [TITLE]: a title for the notification.
    - [SHOW_TIME]: a true/false value for showing the timestamp alongside the title. (requires a title)
    - [APP_NAME]: allows the notification command to use an icon (used if present)
      - To use an app name without a title, title must be an empty string ("").
  - notify-now follows the same pattern as notify but always displays in slot 0 with immediate priority.
  - Sidenote: All [] parameters are optional and are interpreted based upon their value and order.
- New notification sound effect /config/ultrahand/sounds/notification.wav.
  - Users may need to re-apply the default theme for this new sound effect to load.
  - The Silence Notifications toggle disables notification sound effects.
- Notifications can be dismissed with KEY_MINUS clicks, as well as via direct touch.
- API toggle hotkey (hold KEY_MINUS for 4s) allows disabling API Notifications on demand easily.
  - The API toggle hotkey can be enabled / disabled in the Notifications Menu.
New theme colors notification_title_color, notification_time_color, and unfocused_color.
- notification_title_color is the color for the notification titles.
- notification_time_color is the color for the notification timestamps.
- unfocused_color is the color KEY_A+" OK" is displayed with at the bottom of the overlay when no items are in focus.
New package command touch, called touch <PATH_TO_FILE>.
- Command creates an empty text file according to the file path if the file does not exist.
New Packages Menu toggle (in Miscellaneous) for hiding the packages menu completely.
Timestamp placeholder {timestamp()} (with no formatting parameter) can now also be called as {timestamp}.
System RAM previews now automatically change with Overlay Memory adjustments in the System Settings menu.
Sound effects can now use 8000 Hz, 11025 Hz, 16000 Hz, 22050 Hz, 32000 Hz, and 44100 Hz 16-bit PCM wav files in addition to 48000 Hz.
Feedback (haptics + sound) is now processed on its own background thread for improved performance and reliability.
Improvements to haptics in handheld mode.
Cleanup of language json's (removal of unused / unnecessary variables).
Bug fix for internet connection checks in download calls.
Various list class corrections / improvements.
Various code optimizations, bug fixes, and improvements.
Full Changelog: f580fd9...v2.3.0

Quick Update:

JSON placeholder parsing bug fix (for allowing numerical / boolean conversions to strings). - 03/12/2026 11:26 PM PST
Script Overlay no longer removes tags from ListItem commands (bug fix). - 03/12/2026 11:26 PM PST
Notification timestamp positioning bug fix (for notifications with no icons). - 03/12/2026 11:42 PM PST
Separator symbol coloring for notification text. - 03/13/2026 12:01 AM PST
Notification touch dismissal in right-side mode bug fix. - 03/13/2026 1:12 AM PST

Version 2.2.9

Overlay freeze bug fix triggered when entering the packages menu with GDB debugging enabled in Atmosphere.
- When enable_htc = u8!0x0 and enable_standalone_gdbstub = u8!0x1 are present in the system_settings.ini, prior versions can freeze / become unresponsive when entering the packages menu (or any package in general) while within an application / game.
- This was because getBuildIdAsString (updated among the general placeholders) was relying on dmnt:cht which conflicts directly with the standalone GDB stub.
libnx has been updated to latest.
Full Changelog: c6a9c08...v2.2.9

Quick update:

Build ID value correction (was pulled from wrong index). - 02/22/2026 12:49 PM PST
Full Changelog: v2.2.9...f580fd9

Version 2.2.8

All language font glyphs are now accessible regardless of the specified language (libultrahand fix).
- Special thanks to @tomvita.
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.
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.
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.
New command !path_exists (similar to path_exists except it returns command failure if the specified path exists).
- Called !path_exists <SPECIFIED_PATH>.
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.
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).
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).
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).
Scrolling category headers now properly resume scroll state during regular goBack calls (libultrahand fix).
Now including patches from Master Volume for unbounded volume sliding from 100% to 150% using the volume command.
Download commands now verify internet access on network connection (to prevent hanging while on a network without internet access).
The "hold A to execute" list item behavior has been reduced from 4s to 3s to trigger.
TrackBar unlocking / locking feedback tweaks.
Script overlay freeze bug fix (placeholder replacement infinite loop bug fix).
Various boundary case fixes to the List class in libultrahand.
Bug fix for package version labels not being displayed clean with Clean Versions enabled.
Improvements to image rendering (libultrhaand).
Various additional bug fixes and code optimizations.

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
Master volume patch inclusion (was accidentally removed from the sdout.zip). - 02/20/2026 9:12 PM PST

Version 2.2.7

Critical bug fix for touch navigation (crash fix).
- Touch navigation redirection for direct touch on list items utilizing swapTo (in libultrahand v2.2.3 -> v2.2.5) could trigger crashes randomly (pointer still referenced after deconstruction).
New settings toggle for startup notifications (Startup Notifications; on by default).
- New restart notification for nx-ovlloader memory settings changes.
- Proper restart vs startup condition isolations.
Notifications toggle has been renamed to External Notifications and will only be applied to JSON based notifications.
The "hold A to execute" behavior now works via touch.
- Hold duration has been reduced to 4 seconds.
Package command pchtxt2cheat now accepts names for the cheats being converted (fix).
- Called pchtxt2cheat <SOURCE_PATH> [CHEAT_NAME].
Table scrolling with KEY_UP / KEY_DOWN clicks have been slightly refined.
Touch feedback refinements.
Socket is now initialized and exited per download.
- This should free up more working memory / reduce memory pressure for packages and Ultrahand in general.
Software updates now automatically reload Ultrahand on exit from the update menu (rather than on exits from the settings menu).
Multiple list corrections, focus resuming, touch related bug fixes, and more.
Full Changelog: v2.2.6...v2.2.7

Quick Update:

Table scrolling bug fix. - 1/11/2026 1:03 AM PST
Full Changelog: v2.2.7...e6e825d

Version 2.2.6

Sequential placeholder replacement bug fixes (for package commands).
Full Changelog: v2.2.5...v2.2.6

Version 2.2.5

Critical bug fix for crashes on the packages / package menu when not connected to a network.
unpackDeviceInfo sequencing correction.
Added curl_global_cleanup to exitServices (to cleanup curl global resources on app exit).
Buffer initialization correction for download / unzip functions.
Full Changelog: f4978f0...v2.2.5

Version 2.2.4

OverlayFrame titles now auto-scroll when too long or covered by the widget (just like subtitles).
Copy, move, and delete wildcard commands now support -filter <PATH_TO_TXT> (path to a text file containing a list of files / folders to be filtered from pattern resolution).
-filter now properly resolves ./ and ../ paths and no longer require hardcoded sdmc:/ in the file / folder paths.
Bug fix for the ScriptOverlay on track-bars (was improperly utilizing the index / value).
Full Changelog: 8bc9e73...v2.2.4

Quick update:

Removal of ;mode=, ;grouping=, and ;system= pattern values from being cached in the package config.ini metadata and loaded (was unnecessary). - 12/15/2025 8:21 AM PST
Slight tweak to json placeholder replacements to, when the key does not exist, assume the key is null. - 12/15/2025 12:56 PM PST
Command footer highlight loading bug fix (when defined in the config.ini but not the package.ini command). - 12/15/2025 1:35 PM PST
Full Changelog: v2.2.4...f4978f0

Version 2.2.3

Improvements to the List class in libultrahand.
- No more pointer caching (less memory usage, faster openings / list to list transitions, more consistent behavior).
- Proper "wall" handling for initial clicks that select the first / last ListItems (no instant wrap around until subsequent clicks).
- Theme variable trackbar_color is now scrollbar_color + new color scrollbar_wall_color (triggered when tapping ends of the list).
  - Updates to ultra.ini and ultra-blue.ini themes (as well as default).
    - Themes will need to be re-applied for changes to be applied.
- Fixes to the "immediate focus" implementation introduced in v2.2.2.
New package command header ;footer= and ;footer_highlight=.
- ;footer= allows users to pre-define a default footer value for a package command (to be used, stored, and set when no footer exists in the config.ini for the package.
- ;footer_highlight= is a true / false parameter that will draw the footer with the highlight color when on.
  - footer_highlight is also a new key to be used in the config.ini for manually configuring the footer highlight for the command.
Hold mode ;mode=hold is no longer a command mode and can now be set for default, option, and slot commands via ;hold=true.
- The default generated package.ini now uses this command header.
  - Users may want to delete their /switch/.packages/package.ini and have Ultrahand re-generate it if they are still using the old package.ini.
- Side-note: If using ;mode=hold, users will need to update their commands to leverage ;hold=true instead.
Fixes to the placeholder parsing implementation.
- Proper handling and resolution sequencing of unresolved placeholders.
- Placeholder methods before the _source definitions are now carried over to the rest of the commands (rather than reset).
Touch improvements to track-bars.
Optimizations to command menu drawings.
Various corrections, bug fixes, and improvements.
Full Changelog: ec26959...v2.2.3

Quick update:

Footer package command header bug fixes (now to allow spaces). - 12/11/2025 3:57 PM PST
- Bug fix from prior changes. - 12/11/2025 5:20 PM PST
Full Changelog: v2.2.3...8bc9e73

Version 2.2.2

Proper fix for default combo initializations (on fresh installs).
- Launch combo is first checked and loaded from /config/tesla/config.ini.
- If the Tesla combo does not exist, and no combo in /config/ultrahand/config.ini exists, users can use the default Tesla combo (L+DDOWN+RS) or the default Ultrahand combo (ZL+ZR+DDOWN) for initializing their default combo.
  - Once initialized, Ultrahand will assume the combo the user used until changed in the Settings menu.
Bug fix for returning from an overlay while touch is still in progress (multiple cursors).
- If foreground is in focus and a button is clicked while touch is in progress, input will now be prevented (with button click feedback).
Bug fix for returning to the overlay menu after using an overlay launch combo and exiting the overlay (KEY_B click).
- Before the jumpToItem implementation would kick in on the next launch of Ultrahand after closing the overlay, causing the cursor to shift unnecessarily to the last open overlay title on the overlay menu.
Bug fix for widget settings not auto-loading on first fresh install launch.
Full Changelog: v2.2.1...v2.2.2

Quick update:

Overlay frame top/bottom synchronization bug fix (for invoking the script overlay). - 12/07/2025 4:01 AM PST
Full Changelog: v2.2.2...ec26959

Version 2.2.1

New command mode ;mode=hold for triggering a "hold A to execute" type response (similar to default).
- The pre-generated package.ini now utilizes ;mode=hold for its shutdown command.
New commands set-ini-val-matching-key, remove-ini-key-matching-key, and path_exists.
- set-ini-val-matching-key will set an ini value to all ini sections that include the matching pattern key.
  - Called set-ini-val-matching-key <FILE_PATH> <PATTERN_KEY> <DESIRED_KEY> <DESIRED_VALUE>.
- remove-ini-key-matching-key will remove all key value pairs from an ini from sections that include a matching pattern key.
  - Called remove-ini-key-matching-key <FILE_PATH> <PATTERN_KEY> <DESIRED_KEY>.
- path_exists will return command success or failure based upon if the path provided exists or not.
  - Called path_exists <PATH>.
  - Can be quite useful when chained within try: blocks.
Placeholder replacement improvements for chaining with a source command.
- In addition to ini_file (like before), users can now use the full catalogue of placeholders and chain them with their _source method definition.
- Various improvements to placeholder replacements.
Slight refinements to list_file_source to include newlines when chained with tables.
- Slight formatting improvements for tables on the ScriptOverlay.
New package Memory Kit (latest revision of the old Memory Config package example; Ultrahand v2.2.1+ only).
- This package includes the mesosphere.bin memory hack (1.85 MB + stripped).
  - Keep in mind that the stripped version will break the web browser, which will cause crashes on certain games and apps that utilize the web browser.
  - The 1.85 MB version however should not have any issues.
- Regular users should not touch the Configure Commands tab as it is strictly available for development and testing of memory configurations for libultrahand.
New base64 decoding placeholder.
- Called {base64_decode(<ENCODED_STRING>)} .
Improvement to haptics (stronger and more consistent feedback).
Bug fix for combos on forced AMS v1.10+ support overlays.
- Combos were not working properly for overlays with forced support.
- Forced AMS v1.10+ support is not recommended, but can still be used with manual patching overlay binaries.
  - It is highly recommended that all overlays get recompiled for proper AMS v1.10+ support.
New unsupported warning notification displayed when trying to launch an unsupported overlay.
All pages now get drawn with the cursor automatically set (no cursor flickering into view).
Bug fix for sluggish table scrolling after triggering a jump / wrap to bottom.
Bug fix for exit sound + haptics kicking in when combo launching an overlay during a notification.
Bug fix for degrees symbol on Chinese fonts.
Slight optimizations to stbtt_FindGlyphIndex_impl.
Various additional tweaks, bug fixes and corrections.

Version 2.2.0

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.
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.
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).
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.
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.
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).
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).
Sound effects now work on 6MB+ overlay heap sizes (disabled on 4MB).
Improvements to TrackBar touch.
Improvements to touch haptics (now to trigger on touch).
Improvements rounded rects and circles (slightly more refined AA).
Changes to socket initialization for improved memory usage (enables downloads on 4MB and improved memory).
Bug fix for haptics becoming disabled after sleep.
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).
Various tweaks, optimizations, bug fixes, and corrections.

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.

Version 2.1.8

AMS 1.10.0+ and HOS 21 support.
- Overlays not recompiled with latest libnx no longer work without manual force enabling (potentially dangerous).
- Unsupported overlays can now be hidden (toggle is within the settings menu).
  - Important: All homebrew on AMS 1.10+ must to be recompiled with latest libnx for properly ensured support.
Anti-aliasing is now applied to rounded rects, uniform rounded rects, bordered rounded rects, and circles.
- Overall smoother, less pixelated / jagged edges.
Slightly improved wallpaper loading speed + menu opening speed.
Memory expansion toggle / notification bug fix.
Initial state bug fix for main settings menu toggles.
Bug fix for ini file saving. (buffer was too large)
- This fixes the open overlay command in Ultrahand packages.
Bug fix for ini file parsing not returning null on failed parsings.
Fixed Chinese font selection to ensure all glyphs display correctly on Traditional Chinese systems.
- Special thanks to @BadFish-HSrui.
nx-ovlloader/nx-ovlloader+ has now been updated (v1.1.2) for AMS 1.10+ support.
- Important: Double check that you are on v1.1.2 BEFORE updating AMS (if you choose to).
libnx has been manually recompiled with -Os as well as several other code generation optimizations.
Various minor bug fixes and corrections.
Full Changelog: v2.1.7...v2.1.8

Quick Update:

Removal of pre-release status. - 11/15/2025 6:04 PM PST
Full Changelog: v2.1.8...e84de59

Version 2.1.7

Bug fix for notification text being drawn transparent when hidden (related to the global alpha limiter).
Bug fix for toggling Memory Expansion preventing users from exiting the Ultrahand settings menu.
Ini method optimizations (faster loading).
Proper menu return to last selected overlay / package when version labels are hidden.
- A unique ID is now used to facilitate precise returns.
Widget backdrop now utilizes the alpha limiter.
Language config map (for the initial and repeated parsing of languages) is no longer static.
- This should free up more memory in the global heap.
Slight improvements for haptics initializations (to prevent failed initializations that sometimes happen on first boot).
Various minor code optimizations.
Full Changelog: v2.1.6...v2.1.7

Version 2.1.6

Proper return to the last selected item after changing settings in the main Ultrahand settings menu.
- Ultrahand settings menu can also now be entered from the hidden overlays / packages page.
Improved shake highlight animation.
Faster wallpaper loading.
Various rendering optimizations.
Global alpha limiter for glyph rendering.
- This will improve appearances when transitioning shown to hidden and vise versa.
- renderer->a is no longer needed for drawString calls in libultrahand.
Bug fix for click animation not triggering on toggle list items.
Various code optimizations (8kb smaller than v2.1.5).

Version 2.1.5

New haptic feedback and sound effects options in Features under Miscellaneous in the settings menu.
- Haptic feedback is off by default.
- Sound effects are on by default, but require sound files to be added to /config/ultrahand/sounds/.
  - Users updating to v2.1.5 must run Update from the Software Update page one more time after updating for the included sound effects to be properly installed.
  - Users can manually disable updates of the sound effect files by adding a file named NO_SOUND_EFFECTS_UPDATES.flag into /config/ultrahand/flags/.
- Sound effects are only enabled on nx-ovlloader+, not regular nx-ovloader.
- Sidenote:
  - Sounds and haptics will also be applied to every overlay compiled with libultrahand v2.1.5+.
  - Sound files must be relatively small to prevent memory related issues and keep latency low.
- Special thanks to @sskyNS for help with identifying the correct audio services implementation.
Transition bug fixes for cached List frames.
- These fixes ensure the overlay list changes are synchronized with the top and bottom parts of the OverlayFrame during menu transitions.
Various refinements and bug fixes to the download file command.
- Buffer sizes have been tweaked, memory related improvements applied, and boundary case crashes resolved.
Memory related improvements for copy and move commands running on the interpreter thread.
The "Selection is empty!" message is now properly centered, and applied to the overlay menu when no overlays have been added.
- This ensures that translations are properly centered text instead of drawing text misaligned.
Memory related improvements to wallpaper loading / reloading.
Cleanup of notification processing queue.
Cleanup of screenshots and recording layer initializations.
Various code refinements, bug fixes, and tweaks.
Full Changelog: v2.1.4...v2.1.5

Quick Update:

Overlay exit sound to respect the disable sound effects preset. - 11/03/2025 9:37 PM PST
Full Changelog: v2.1.5...3670712

Version 2.1.4

New sdout.zip distribution, bundled with all components and dependencies (up-to-date) for easier SD card installations.
- Installs nx-ovlloader+ by default, but users can toggle off Memory Expansion after installing for regular nx-ovlloader.
New build ID placeholder variable {build_id}.
New system region setting command set-region <REGION>.
- <REGION> is either JPN, USA, EUR, AUS, HTK, or CHN.
- Side-note: Reboot is required for changes to apply.
Bug fix for refresh wallpaper.
Various code optimizations and restructurings.
Stability related bug fixes.
Full Changelog: v2.1.3...v2.1.4

Version 2.1.3

Bug fixes for regular toggles (state was not being preserved in config.ini).
Bug fixes for toggles in the root package (/switch/.packages/package.ini).
Restoration of the {index} source function placeholder (was accidentally removed at some point over time).
Full Changelog: 855f0d1...v2.1.3

Version 2.1.2

Rendering bug fix for regular TrackBar objects / uniform rounded rects.
- Uniform rounded rects in some circumstances when drawn off screen could cause crashes.
- Side-note: Did not affect StepTrackBar/ NamedStepTrackBar.
Left / right sensitivity fix for value transitions on regular TrackBar objects have been adjusted for precision.
Various method restructurings.
Full Changelog: 7b8de7f...v2.1.2

Quick update:

TrackBar touch highlight style improvements. - 09/30/2025 3:04 AM PST
Full Changelog: v2.1.2...855f0d1

Version 2.1.1

Toggles now utilize the interpreter thread with state change only applied for successful completion.
New true/false command option ;progress= for toggle commands to show the command in progress throbber.
Memory related improvements to move/mv with file logging and compare.
- This fix enables base loader to properly handle large move commands with proper file logging (as seen in Alchemist's content manager).
Bug fix for {local_ip} placeholder not returning the local IP address.
Various minor code optimizations.
Full Changelog: v2.1.0...v2.1.1

Update:

Overlay sort priority bug fix.
Full Changelog: v2.1.1...7b8de7f

Version 2.1.0

New system notifications implementation.
- There are 3 ways to interface with system notifications.
  - a. Ultrahand Package: notify <MESSAGE> [FONT_SIZE] or notification <MESSAGE> [FONT_SIZE]
  - b. Direct libtesla calls: tsl::notification->show(<MESSAGE>, [FONT_SIZE], [PRIORITY]);
  - c. External json calls: {"text": <MESSAGE>, "font_size": [FONT_SIZE], "priority": [PRIORITY]}
- Font size is an optional parameter, default value 28.
- Priority is an optional, with jsons always assume priority 10 while Ultrahand packages / direct calls assume priority 20.
- Creation time for jsons is auto prioritized for everything within the same priority level.
- For external json calls, jsons can be written to /config/ultrahand/notifications/<PROGRAM_ID>-<UNIQUE_ID>.notify.
  - This function allows any program, including sys modules, to interface with the notification prompts.
- New theme color for notification text: notification_text_color
- Notice: Overlays must be compiled with the latest libultrahand for system notifications within those overlays.
New overlay / package setting option to delete an overlay / package. (Hold A to Delete)
New Miscellaneous options for toggling on / off notifications and show delete.
New notifications for startup, new version detection, and when reboot is required for changes to apply.
New page for empty selection commands.
New placeholder variable for returning the current local ip address, called {local_ip}.
New package header option ;display_title= for displaying an alternative in package display title.
Category headers now auto-scroll right to left for extended text.
Improvements to package memory usage.
- Pages are no longer held up in memory for deeper menu navigation.
Improvements to dot-clean, faster file processing completion.
Improvements package item jumpToItem calls.
- Full command names, including tags, are now properly utilized for specific item name isolations.
Package settings now groups various package options into an Options category.
Command file / folder paths can now properly use .. to specify the directory above a current folder.
- i.e. './../test/' will return the folder named test above the current directory the package ini is currently running from.
Settings and favorites buttons are now displayed on the menu within the Packages and Overlays category headers.
Bug fix for wallpaper alpha when hiding overlays.
- Proper fading with alpha transitions.
Interpreter thread bug fixes for safer rapid launches.
Bug fixes for the command parser; proper order of operation resolution for nested placeholder replacements.
Full Changelog: a3a4519...v2.1.0

Version 2.0.1

Overlay interaction (including button combinations) is now strictly limited to handheld mode controller as well as the player 1 controller.
- In the past, when other controllers click buttons, because the overlay looked for all controller inputs the sum of all buttons being clicked could trigger the menu or launch a combo unintentionally.
- This fix was set in libultrahand, so all overlays compiled with it will now include this fix.
Underscan and "right-side mode" bug fixes and adjustments.
- Users no longer need to exit the overlay for the underscan fix to correct the overlay dimensions (auto-corrections).
- Right-side mode is auto applied now when clicked in the settings menu with no need to reload.
- Fix is also in libultrahand, so it will apply to all newly compiled overlays.
Launch combo mode settings is now rendered within its own dropdown instead of being drawn directly within the root of overlay setting's menu (when specified).
Various minor corrections.
Full Changelog: 8a7904e...a3a4519

Version 2.0.0

New combo package launcher (similar to the overlay launcher).
- Users can set any package to key combos.
- New Quick Launch package setting (for disabling Boot Commands for the package during combo launches).
- More button combinations have also been added to the list.
New command open for opening overlays (with or without launch arguments) from the package menu.
- Called open /path/to/overlay.ovl {LAUNCH_ARGUMENT_1} {LAUNCH_ARGUMENT_2} {...}
- Overlays can now be compiled to handle specific tasks for Ultrahand packages.
Buttons ZL and ZR will now skip the menu exactly one viewport's distance up or down.
- Multiple clicks and hold will trigger rapid page skipping.
- This should allow for quicker and easier menu navigation, as well as table scrolling.
New atmosphere updater functionality.
- To use, copy / move / unzip files into place as you would expect (overwriting stratosphere and package3 in /atmosphere/).
  - Instead of being overwritten, the files will be assigned a .ultra extension.
- After files have been moved into place, any reboot command will automatically trigger the Ultrahand Updater payload.
  - This payload is downloaded once the moment reboot is ran after installing Atmosphere as well as during software updates.
  - Users must reboot from Ultrahand Overlay itself for changes to apply.
libultrahand detection for overlays compiled with libultrahand.
- Highlight colors for overlays with libultrahand functionality.
- Recompilation of all libultrahand overlays is needed with the new Ultrahand signature added (see Makefile).
New command dot-clear, called dot-clear <PATH_TO_BE_CLEARED>.
- This command will remove all metadata files that begin with ._ from any specified directory (as well as all subdirectories).
- This is useful for users who transfer files and mods over to their SD card from macOS.
  - Side-note: These metadata files can cause issues with mods, so clearing them can be quite useful.
New theme color configurations and updates to the default theme as well as ultra.ini and ultra-blue.ini.
- banner_version_text_color: Default color of the version label below the Ultrahand title.
- overlay_text_color: Default color for overlay titles.
- overlay_version_text_color: Default color for overlay versions.
- ult_overlay_text_color: Default color for libultrahand compiled overlay titles.
- ult_overlay_version_text_color: Default color for libultrahand compiled overlay versions
- package_text_color: Default color for package titles.
- package_version_text_color: Default color for package versions.
- ult_package_text_color: Secondary color for package titles.
- ult_package_version_text_color: Secondary color for package versions.
- text_separator_color: Default color for text separator symbols.
- selection_value_text_color: Default color for the selection value.
  - Side-note: Users may want to re-apply the default theme once for some of the changes to apply.
Proper input isolation so menu navigation buttons do not interfere with combos and vise versa.
Thread safe ini, hexing, file operations, and page swapping.
- New libultrahand command swapTo to safely handle swapping between pages (goBack / pop + changeTo).
The Miscellaneous settings menu has been re-organized and now includes Theme Settings.
- Theme settings includes options that allows you to toggle on and off various theme configurations.
On return from within package dropdowns / forwarders, the page is now automatically refreshed.
- All command footers and tables will automatically redrawn.
Package headers can now utilize ;show_widget=true for rendering the widget.
Dropdown menu commands can now utilize ;mode=slot for changing the dropdown symbol to the option symbol.
Software update now installs nx-ovlloader / nx-ovlloader+ v1.1.1 (latest release).
- Bug fixes for rapid overlay swapping, reduced file io calls, better memory mapping, and slight optimizations.
Language changes are now instantly applied to the menu from within the language selection.
Faster menu drawing.
Buffer sizes for nx-ovlloader+ (memory expansion) are now loaded immediately during overlay launch.
- Slight buffer size tweaks for base loader.
Slight improvements to Swipe To Open.
Slight redesigns to various text components within the overlay.
Rendering related fixes and improvements.
Fixes to file list generation from copy and move to include subdirectories.
- This functionality allows Mod Alchemist to properly handle the removal of folders when appropriate for toggling content mods.
Numerous bug fixes, memory optimizations, navigational fixes and alignment corrections.
- Significantly reduced memory pressure throughout numerous methods.
- Countless code optimizations and better memory handling.
- Bug fix for step track-bar values vanishing.
- Touch related fixes (long touch and release).
- Dangerous pattern bug fixes.
- json_file / json_file_source bug fixes.
- Many other fixes not mentioned.
Full Changelog: 2602970...v2.0.0

Quick update:

Transparent screenshot cursor opacity bug fix. ~ 8/6/2025 12:11 PM PST

Version 1.10.0

Expansion of the overlay key combo launcher implementation.
- New launch argument modes implementation.
  - Users can add launch argument modes to overlay entries in /config/ultrahand/overlays.ini.
  - For example, for mini and micro entry points on my Status Monitor fork, users can add mode_args=(-mini, -micro) as well as mode_labels=(Mini, Micro) for labeling them.
  - After adding mode_args (or mode_args and mode_labels) new mode options will appear within the overlay settings menu (Y on an overlay).
- All libultrahand compiled overlays (compiled with v1.10.0+) now allow for quick launches.
  - This means you can jump from one overlay / overlay mode to another without ever returning to ovlmenu.ovl.
- Pressing the combo used to launch the overlay will now also return users back to ovlmenu.ovl.
- Setting combos will now also instantly be applied (no need to exit the menu).
- You can now also be anywhere within Ultrahand and trigger an instant jump to any overlay / overlay mode using key combos.
New Launch Combos global toggle in the Miscellaneous settings menu.
- This will disable all overlay launch combos from working.
- Can be useful if you are playing a game that demands lots of button combinations.
Critical bug fixes for menu navigation.
- The ScriptOverlay was actually still broken in v1.9.10 on certain menus.
- These fixes address a lot of potential mishandling of pointers in main.cpp.
Unzip commands have been improved and are now less prone to errors.
Commands in progress will now properly hit 100% instead of going from 99% to complete.
Cursor center focus has been slightly lowered.
- This prevents slight scrolling from kicking in after hitting the 4th item on the list.
Slight re-organization of the Miscellaneous settings menu.
The overlay / package settings menu now displays the version, with slight formatting improvements.
Changing the sort priority for overlays / packages now triggers an immediate jump to the item being sorted upon return.
Various alignment corrections and bug fixes.
Full Changelog: v1.9.10...2602970

Version 1.9.10 Quick patch (stability update)

Restoration of the ScriptOverlay (minus on a command).
- There was a lingering issue within the List class that was causing mis-handlings of the cached items for certain menus upon return.
  - This issue should be resolved now.
Potential memory leak bug fix for aborted unzip/download commands.
Smoother text scrolling (for list items with long text).
Slightly improved color sampling for the cursor blink effect.
Slight optimizations to the handleRunningInterpreter input handler.
Removal of unused variable declarations in the MainMenu class.
Slight alignment corrections to the table background.
Full Changelog: 8ee2844...v1.9.10
More widget options have been added to the settings menu.
- New toggle for disabling dynamic temperature colors.
- New toggle for forcing center text alignment (on by default).
  - When off, text alignment will be set to the right (like before v1.9.8).
- New toggle for extended backdrop (off by default).
  - This is an alternative style choice to the backdrop that some users may prefer.
- Widget menu has also now been broken up into "Widget Items" and "Widget Settings".
- Widget positioning and alignments have also been corrected.
Important navigational bug fixes (memory leak fixes).
- Page swapping (including rapid page swapping), list deconstruction, and management of list item cache have been significantly cleaned up to prevent crashes.
- These changes should prevent lingering navigational memory related issues from randomly occurring.
New theme color configurations.
- temperature_color: color for temperatures on the widget with dynamic colors disabled.
- battery_charging_color: color for the power indicator on the widget with the battery charging.
- battery_low_color: color for the power indicator on the widget when battery is below 20%.
- Propagation of version_text_color to apply to overlay and package versions on the menu (in addition to the Ultrahand / nx-ovlloader version displayed below the logo).
Improved dynamic logo with higher resolution color sampling (smoother gradient color progression).
New alpha fix for screenshots taken with Opaque Screenshots set to off.
- This sets the alpha for certain elements to 14, others to 15 to make screenshots with transparency look more accurate.
Slight changes to default theme.
- Table background has been reset to a darker shade of gray.
- Side-note: Default theme must be re-applied for changes to occur.
Various alignment corrections and bug fixes.
Notice: Next version is currently planned to be v1.9.10, so don't get your hopes up for v2.0.0 quite yet.
Full Changelog: 3c6125a...v1.9.9

Quick update: (cosmetic)

Slight alignment fix to the widget / widget backdrop (1 pixel shift). ~ 7/6/2025 8:46 AM PST
Script overlay has been temporarily disabled to prevent issues. ~ 7/6/2025 10:25 AM PST
Full Changelog: v1.9.9...8ee2844
Warning: The script overlay is currently not working right (minus on a command). I am working on a fix. For now do not use this function.

Version 1.9.8

Important bug fix for pchtxt2ips conversion not properly naming the ips files.
- This issue came up because of the NO_FSTREAM directive change in v1.9.7 (was not properly handled).
- Side-note: Conversion of pchtxt's in v1.9.7 is bugged so v1.9.8 is recommended (for usage with Mod Alchemist).
Various UI improvements to the widget.
- Widget text are now centered instead of aligned to the right.
- New widget backdrop implementation for highlighting the widget region with a uniform rounded rectangle.
  - This makes the widget easier to see with certain wallpapers, or transparencies.
  - Located in UI Settings > Widget (on by default).
  - New theme color settings widget_backdrop_color and widget_backdrop_alpha.
The default theme has some new color changes.
- For changes to be applied, users must re-apply the default theme in the settings menu.
- There are also a couple minor changes in ultra.ini.
Screenshot opacity implementation has been cleaned up.
- Longer opacity delay as well as cleaner click and release state handling.
Shake highlight implementation bug fixes and top / bottom of list triggering.
- Clicking left on the overlay page or right on the packages page now triggers the shake highlight effect (like before v1.9.7).
- Holding down / up and hitting the last / first item will now triggers a shake highlight in the direction you are traversing from (new).
Bug fix for certain theme color changes not fully being applied after application and returning to main menu.
Rendering methods have been optimized again (very slightly faster than v1.9.7).
Various alignment corrections and bug fixes.
Full Changelog: v1.9.7...v1.9.8

Update:

Revert of new screenshot opacity implementation. - 07/03/2024 4:53 AM PST
- The issue was if a capture event gets missed, the opacity might never reset.
- A simpler, better fix is just to set opacity duration to 1.5s.
Full Changelog: v1.9.8...3c6125a

Version 1.9.7

Improved download and unzip commands.
- Library zzip has been migrated to minizip for improved compatibility (as well as z64 support).
- Tested with near 4 GB downloads (FAT32 limit) as well as files within zips.
  - Also tested with zips containing thousands of files.
Buffer calibrations for download, unzip, copy, and hex functions.
- Calibrations have been set for nx-ovlloader and nx-ovlloader+ based upon available heap memory.
- nx-ovlloader:
  - Download: 128 KB read, 32 KB write
  - Unzip: 128 KB read, 32 KB write
  - Copy: 64 KB read / write
  - Hex: 64 KB read
- nx-ovlloader+:
  - Download: 256 KB read, 128 KB write
  - Unzip: 256 KB read, 128 KB write
  - Copy: 256 KB read / write
  - Hex: 256 KB read
- The result is faster downloads / unzips / copying / hexing and less memory issues.
  - Optimizations in this revision have lead to more heap memory available overall.
The selection overlay (sourced commands) has been optimized.
- Improved memory management for usage with nx-ovlloader (base loader).
  - Base loader will now only draw up to 250 list items to prevent crashes.
    - Side-note: Keep in mind that if you have more than 250 items on the page, you will not be seeing everything.
    - nx-ovlloader+ however has this draw limit uncapped.
Library migration for jansson to cJSON.
- cJSON compiles smaller and should be faster for the use cases within Ultrahand.
Now compiled without fstream (NO_FSTREAM directive), utilizing stdio.h instead.
- This should be faster and help keep compilation size smaller.
Optimizations and fixes to various rendering methods.
- The result is very slightly faster rendering than v1.9.6 with less potential issues.
Across the board optimizations to all libultra methods.
- Improved ini, hex, path, and json functions.
- Bug fixes for NO_FSTREAM directive.
Slight cleanup of lingering visual annoyances within the List class.
- This fixes the menu not returning all the way to the top after scrolling.
- Fix for menu auto jumping to top / bottom when pressing into a table at the very bottom / top instead of scrolling to the end.
- Slightly improved table scrolling.
- Removal of unnecessary internal methods.
- Memory leak bug fix for rapid page swaps (faster than it can draw).
Bottom touch regions have been properly aligned based upon the text.
- This should keep the touch regions clean and uniform regardless of language changes.
New flag option for disabling the auto update of nx-ovlloader/nx-ovlloader+ during the software update command.
- To use this, add a file (can be empty) named NO_LOADER_UPDATES.flag into /config/ultrahand/flags/.
- Side-note: Be cautious of using this, because once the flag has been added, Ultrahand will not be updating nx-ovlloader.
For interpreter in progress with downloads / unzips / large copies, the bottom menu bar will now display Hide and Cancel with proper touch integration.
Cleanup of unique and shared pointers in main.cpp to now purely utilize raw pointers instead.
The glyph cache will now be cleared automatically when you enter Ultrahand packages as well as the selection overlay.
- This prevents the glyph cache from getting too large after entering tons of pages. (potential memory leak)
The Script Overlay now displays the package forwarder commands.
New language variable for abbreviated Overlays, for drawing on the bottom touch region.
- This will be helpful for languages with large translations of this word.
Faster wallpaper loading.
Removal of all .reserve declarations throughout the project.
- From extensive testing, it appears that memory reservations have been contributing to heap overload and memory leaks.
Revert of all __builtin_ memory related methods back to their std counterpart.
- For the use cases within the project, the builtin appears to be less ideal since in many circumstances size is not determined during compilation.
Bug fix for memory expansion toggle.
- nx-ovlloader+ was not auto-applying upon the first click (with no expansion zips initially installed).
Bug fix for favoriting / starring overlays not properly utilizing jump menu navigation.
Various alignment corrections and bug fixes.
Full Changelog: 907f143...v1.9.7

Version 1.9.6

New commands set-json-val/set-json-value and set-json-key (similar to set-ini-val and set-ini-key).
- set-json-val <JSON_PATH> <JSON_KEY> <JSON_VALUE>
  - This will set a value in a json according to a key.
  - If the json / key does not exist, it will be auto-created.
- set-json-key <JSON_PATH> <JSON_KEY> <NEW_JSON_KEY>
  - This changes the name of a key in a json
  - Will do nothing if the json does not exist.
Cleanup of all lingering visual glitches during menu navigation.
- No more cursor flicker as pages transition.
- Proper isolation / cleanup of jumpToItem execution.
- The Language Menu will now also return to the last selected item after a language change (with translations properly applied).
Updating Ultrahand from the Software Update page will now also update the version label stored in the HBAppStore's info.json.
- This will prevent "new update" flags from appearing on the HBAppStore after updating Ultrahand from within itself.
  - Side-note: If you don't see the version label on the update command footer before clicking it, the version label will not be updated.
    - If HBAppStore does not have the latest version, the store will still say that there is an update available.
Various alignment corrections (tables, scrollbar, list height corrections, internal List corrections, etc).
Various scrolling related fixes and improvements.
Various bug fixes and code optimizations.
Full Changelog: v1.9.5...v1.9.6

Quick update:

Lingering memory leak fixed for rapid language changes. - 6/23/2025 6:12 AM PST (UPDATE IS RECOMMENDED)
Last minor bug fix:
- Table drawer wasn't properly updating colors on the main menu. - 6/23/2025 7:55 AM PST
  - You'd only notice if you have a table on the page that you are returning to after changing themes.
Final fix:
- Rounded rects drawing out of bounds bug fix (like touching next page on Japanese for instance). - 6/23/2025 10:24 AM PST
- This was causing a crash because of my renderer optimizations. Should all be good now.
  - Alignments will be corrected in the next version.
  - Full Changelog: v1.9.6...907f143

Version 1.9.5

Forward list caching has been properly implemented.
- This allows jumpToItem to seamlessly transition during forward navigation (like in v1.9.3, but with no memory leaks).
Refresh commands with jumpToItem are now moved to refresh-to.
- Called refresh-to <ITEM_NAME> [ITEM_VALUE] [EXACT_MATCH].
- Exact match is an optional true/false value, set to true by default.
  - When false, it will check if the value / versions are contained within the strings rather than an exact match.
Various fixes to scrolling as well as table scrolling.
Fixes to download commands using a completion timeout (cancelling downloads early).
- This completion timeout was added by mistake and could make downloads of large files fail.
New language Ukrainian has been added.
Additional key combos have been added to the combo list.
Table wrapping alignments have been corrected.
Various bug fixes and corrections.
Full Changelog: 6d027f9...v1.9.5

Version 1.9.4

Several critical memory leaks have been properly addressed.
- Memory leaks can cause crashes when the heap gets overloaded.
  - This was especially noticeable with extremely long menus or long chains of commands (like download and unzip).
- The prior frame caching implementation needed to be reworked / revised.
  - Potential broken / dangling pointers not properly being managed / cleared.
  - Backwards caching works fine, but forward caching of prior frames with jumpToItem needs to be revised in the next release to prevent the menu from briefly flickering into view.
- Directory path caching has been completely removed (an unnecessary "old" implementation).
- Various tweaks to libultra functions for improved reliability.
Implementation of a Font Manager class in tsl::gfx with a universal glyph cache for better memory management across drawString and calculateStringWidth methods.
- All drawString methods and have been reconsolidated.
- Fixes for alternative fonts were also implemented.
Complete rework of the prior scrolling implementation for smoother scrolling navigation.
- Table scrolling for subsequent tables has been fixed (was not working properly in v1.9.3).
- Table scrolling is also a lot smoother than before, with proper velocity interpolation.
(NEW) Dropdown commands (normally empty command blocks) can now be written with ;mini=true for making mini dropdown menus command forwarders.
Various alignment corrections, selection text color corrections, method optimizations and bug fixes.
Full Changelog: a592584...v1.9.4

Quick Update:

Ini placeholder bug fix.
- Certain ini placeholders replacements were not being properly handled within the source replacement functions.
- This likely affected Reboot To for certain entry names in hekate_ipl.ini.
Full Changelog: v1.9.4...6d027f9

Version 1.9.3

Menu navigation has been significantly cleaned up utilizing the new jump to item implementations.
- Returning to the exact overlay entry you launched on the menu (on both the Overlays and Hidden Overlays pages).
- Auto navigation to the checkmark on dropdown selections.
- Page caching for smoother page to page transitions.
- Left to right page swaps now have seamless transitions.
New Show Hidden toggle in Settings > UI Settings > Miscellaneous > Menu Items.
- This will hide your hidden tabs on the Overlays and Packages pages.
- Hidden overlays with Show Hidden set to off will also have their launch combos blacklisted.
- This should be useful for giving your device to a kid to play without having them mess-up something critical.
Numerous across the board code optimizations.
- Slightly faster rendering than v1.9.2.
Tables will now only poll new values when placeholders are present.
Complete cleanup of alignments (including table alignments).
Complete cleanup/rewrite of the List class in libtesla for seamless menu navigation.
Various touch scrolling bug fixes (especially for touch scrolling on tables, then resuming with controller input).
Jump menu navigation can now be used in packages (expansion of refresh command).
- refresh <ITEM_NAME> [ITEM_VALUE] will auto-return the cursor to the item that fits the match.
- ITEM_VALUE is optional and does not have to be defined.
- ITEM_NAME is only optional with a blank string as its value, i.e. .
Numerous bug fixes and corrections.
Full Changelog: v1.9.2...v1.9.3

Update: (Users should run update again for proper polling isolation.)

New ;polling= table header (true/false) for placeholder polling. (false by default)
- This will make it easier for users to manually specify when placeholder polling should be enabled.
- Notice: Projects leveraging placeholder polling will need to set ;polling=true on their table commands.
Full Changelog: v1.9.3...a592584

Version 1.9.2

Restoring of debug logging.
- This caused issues in rare test cases, using the USING_LOGGING_DIRECTIVE set to 0 (off).
- Debug logging needs to be consolidated more (later).
Opacity bug fix.
- This caused wallpapers to hit opacity before the rest of the items, making screenshots look weird. All fixed now.
Jump menu navigation from clicking up at the top of the list bug fix.
- This caused multiple "up" clicks to get stuck on the last item on the list initially for the second up click. Also fixed.
Slight refinement to the up / down jump menu navigation.
Threshold for successive clicks has been set from 150ms to 100ms for smoother navigation.
Full Changelog: v1.9.1...v1.9.2

Version 1.9.1

Significant rendering improvements in libultrahand / libtesla (again).
- Faster string rendering (with safeguards) as well as rendering of other objects.
- Faster glyph lookup (for drawing strings).
- Safe optimizations to critical rendering components (considerable improvements).
- 60fps now works on 918 MHz CPU with wallpapers.
- 60fps also works with 714 MHz CPU without wallpapers.
  - 612 Mhz CPU without wallpapers is now very close to 60fps with it rendering 60fps on certain menus.
Bug fixes for left to right scrolling text (long ListItem text) not returning to its original position before restarting.
Rewrite of the List class in libtesla to properly allow jump menu navigation.
- When at the top of the menu and up is pressed, the cursor will now automatically go to the bottom most item.
- When at the bottom of the menu and down is pressed, the cursor will now automatically go back to the top.
- When L is pressed, the cursor will jump to the top of the menu.
- When R is pressed, the cursor will jump to the bottom of the menu.
  - All jump menu implementations works on menus with ListItems and tables, or even just tables.
- Complete rewrite of the table scrolling implementation for smoother scrolling and less potential issues.
Fixes to table drawing implementations.
- All tables are now ;scrollable=true by default with proper scrolling implemented.
  - This property will eventually be removed, as well as the other scrollable properties.
Download commands now have a 10s timeout.
Software Update now removes the version label if it cannot pull the latest version details from GitHub.
- This will prevent people thinking an older version of the overlay is the latest.
Slight cleanup of debug logging.
Beta for nx-ovlloader+ v1.1.1 is now live (not linked to Update for now for testing).

What's Changed:

Tweak for dist target by @impeeza in *232
Full Changelog: 215e878...v1.9.1

Version 1.9.0

Title ID polling bug fixes in libultrahand (cleanup of the foreground fix implementation).
- Before it was using old / outdated service calls for pulling the title ID.
- This issue appears to have caused crashes on certain switch environments according to users.
Various code optimizations in libultrahand.
- Rendering is slightly faster now than v1.8.9.
- Removal of chrono for libnx alternatives.
nx-ovlloader/nx-ovlloader+ have been re-compiled.
Full Changelog: becd070...v1.9.0

Update:

Slight bug fixes with libcurl initializations (revert of changes).
setNextOverlay bug fix for overlay filename launch arguments. - 06/07/2025 10:30 PM PST
Bug fix for text extending off the screen causing crashes (like in lang file es.json). - 06/08/2025 6:07 AM PST
A more elegant solution will be applied later to speed up the rendering a pinch.
Full Changelog: v1.9.0...215e878

Version 1.8.9

Significantly improved rendering has been applied to libultrahand's custom libtesla fork.
- This now allows for 60fps wallpapers on stock CPU clock speeds.
- CPU 714 MHz under-clock without wallpapers should now render at 60fps as well.
- CPU 612 MHz under-clock is not quite at 60fps yet, but on various pages it can get pretty close.
A new bug fix for input isolation failing (foreground bug) on changing titles has also been applied to libtesla.
- This should prevent overlays compiled with libultrahand from losing their input focus on the menu when a game starts up.
Various optimizations to drawTable (the table drawing method).
Full Changelog: v1.8.8...v1.8.9

Update:

Slight cleanup of libtesla.
Revert of some of the cleanup changes. (bug fix for scrolling text)
Full Changelog: v1.8.9...becd070

Version 1.8.8

New Key Combo implementation for launching any overlay.
- Located in the overlay settings menu (Y on an overlay).
- This lets you set any overlay to any key combination (excluding your Ultrahand Key Combo).
- When setting an already used combo, combos set for overlays with the same combo are removed.
- Very useful for quickly launching any overlay without invoking the Ultrahand Overlay menu.
Default theme table info color has been changed.
- For changes to apply to the default theme, users must re-apply the default theme in the theme selector on the settings menu.
Fixes for slot commands to render the updated footers instead of a checkmark.
Long tap on commands now invoke the ScriptOverlay.
- This makes all options of the menu fully accessible now via touch.
Bug fix for new packages and overlays not initially being listed with names until the menu reloads.
Slight code optimizations.
Full Changelog: v1.8.7...v1.8.8

Version 1.8.7

Bug fixes for file_source toggles.
- There were issues with file_source not being properly resolved with subsequent clicks to file_source toggles.
- Issues should now be resolved.
Sorting related bug fixes for command grouping split5.
New method flag for generating empty text files with the name of files/folders within a directory
- Called flag <input_path_wildcard_pattern> <output_dir>.
- Might not be particularly useful in most cases, but it is essential for proper management of active contents mods within Mod Alchemist.
Tweaks / improvements to dangerous pattern detection.
- Patterns with multiple * next to each other (i.e. ** or ***, etc) are now considered dangerous and will return a failed command for move and delete.
- null* and *null are also considered to be dangerous patterns (failed placeholder replacements).
- Cleanup of failed placeholder replacements to return null instead of empty values when necessary.```
ScriptOverlay (minus on a command) related bug fixes.
Slight corrections to compare as well as split and slice placeholder methods.
Slight code optimizations.
Full Changelog: 06f9666...v1.8.7

Version 1.8.6

Tables now render live values with placeholder replacements.
- Values will poll / update once every second.
New back command implementation for simulating Back / KEY_B button press.
filter commands now accept wildcard patterns for more advanced filtering of source inputs.
New command grouping (;grouping=) option split5. (similar to split3 except it works on the folder containing the file/folder).
- Side-note: All command grouping modes will eventually be renamed to avoid confusion.
Title ID placeholders {title_id} now work within source function definitions.
pxhtxt2ips conversions now create an empty title ID text file within the folder where the IPS mod is generated.
- This feature is necessary for proper management of active mods within Mod Alchemist.
- The title ID is read from the comments within the .pchtxt file (already necessary for pxhtxt2cheat conversions).
- All IPS mods must be regenerated for this file to be generated. Otherwise IPS mods will not register within the Active tabs on Mod Alchemist.
Various menu traversal related bug fixes.
Various bug fixes within libultrahand.
Full Changelog: v1.8.5...v1.8.6

Update:

Slight bug fix with menu traversal.
Full Changelog: v1.8.6...06f9666

Version 1.8.5

Critical bug fixes for decimal to hex conversions.
Updates to all devkitpro related libraries.
Full Changelog: 2f3a5b6...v1.8.5

Version 1.8.4

Various bug fixes to isDangerousCombination (dangerous pattern detection). Certain wildcard patterns were being flagged with the old implementation that should not be.
- This fixes exeFS Groups's Enable All and Disable All commands in Mod Alchemist.
Bug fixes for the ScriptOverlay (minus on a command) where ./ placeholders were not being properly replaced with the package folder for commands.
Various logging related bug fixes. (default log is currently set to sdmc:/switch/.packages/log.txt when logging is enabled)
Tweaks to decimalToHex implementations in libultra to manually specify byte group size (byte_group_size 2 = XX, byte_group_size 4 = XXXX, byte_group_size 6 = XXXXXX, etc). This should resolve problems related to a decimal value of 0. Default byte_group_size is 2, then will be assumed according to the decimal value if greater.
- hex-by-custom-decimal-offset <file_path> <custom_pattern> <offset> <decimal_data> [byte_group_size]
- hex-by-custom-rdecimal-offset <file_path> <custom_pattern> <offset> <rdecimal_data> [byte_group_size]
- hex-by-decimal <file_path> <decimal_data_to_replace> <decimal_data_replacement> [byte_group_size] [optional_occurrence]
- hex-by-rdecimal <file_path> <decimal_data_to_replace> <decimal_data_replacement> [byte_group_size] [optional_occurrence]
- {decimal_to_hex(decimal, byte_group_size)} or {decimal_to_hex(decimal)}
Sidenote: For usage of optional_occurrence, byte_group_size must be specified.
Full Changelog: v1.8.3...v1.8.4

Update:

Pull Request *5 got deleted in libultrahand for some reason, so respect @disabled flag pchtxt functionality has been restored.
Fixes to various hex method calls (some got broken with the update). - 06/26/2025 6:04 PM PST
Full Changelog: v1.8.4...2f3a5b6

Version 1.8.3

New toggle option Dynamic Logo in UI Settings > Miscellaneous for enabling / disabling the dynamic logo effect.
Various fixes to libultrahand.
- Launch combo is read from the tesla.ini if ultrahand.ini does not exist for overlays compiled with libultrahand. (bug fix)
- Fix for converting pchtxt's with embedded comments as well as a couple other tweaks.
- Subtle UI corrections / improvements.
The memory indicator on the System page now shows the true memory (no longer -8MB) and has custom coloring.
- New theme colors healthy_ram_text_color, neutral_ram_text_color, and bad_ram_text_color.
  - Healthy is >= 9MB.
  - Neutral is < 9MB, >= 3MB.
  - Bad is < 3MB.
Various minor tweaks.
- The pre-generated package.ini now has symbols on some of the Reboot To commands and the Shutdown command.
- The ultra.ini theme that is installed when updating has been updated to use white text color.
- The ultra-blue.ini theme that is installed when updating is now the old ultra.ini theme color.
Full Changelog: d448e61...v1.8.3

Version 1.8.2

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.
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

Version 1.8.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)
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

Version 1.8.0

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)
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).
Package forwarder commands will now update footer labels when modified from within the forwarder package.
Option footers will now be automatically loaded from the config.ini upon command success instead of returning a checkmark.

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 ●

Various code / compiler optimizations for smaller compilation size.
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

Version 1.7.9

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.
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.
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)
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.
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.
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.
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.
Fixes for drawing the overlays / packages menu for newly added overlays / packages.
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

Version 1.7.8

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)
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
```
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.
New placeholder function random to generate a random integer.
- Called {random(START_VALUE,END_VALUE)}.
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.
Placeholder replacement order of operations fix.
- Users can use nested placeholders called in any sequence now.
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.
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.
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

Version 1.7.7

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).
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.
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

Version 1.7.6

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.
New progress symbol throbber implementation. (for commands in progress that do not utilize the progress percentage)
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.
Storage capacity in Device Info has been corrected. (was previously showing free space instead of the amount of space being consumed)
Slight UI corrections.
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

Version 1.7.5

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.
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.
Root package folder exit_package.ini will now have command exit only ran when Ultrahand (and any other running overlay) is completely closed.
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

Version 1.7.4

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.
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.
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).
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.
Updating Ultrahand will now auto-reload the newly installed version when returning to the main menu after.
New table command options ;start_gap= and ;end_gap= (same as ;gap=) for manual aligning of tables.
More details have been added to the Commands Documentation.
Various UI tweaks / corrections.
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

Version 1.7.3

Long tap (touch > 0.5s) of an overlay / package on the main menu will now open the overlay / package settings menu upon release.
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.
More corrections and improvements to the wallpaper swapping feature.
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.
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

Version 1.7.2

Continued expansion of Device Info to now include local IP, eMMC storage, CPU/GPU/SOC Speedo + IDDQ and more.
- Fuse related data is auto-dumped to sdmc:/config/ultrahand/fuse.ini if fuse.ini is missing.
- Special thanks to Masagrator.
Slight reorganization of Settings Menu.
More renderer related tweaks and bug fixes. (faster pixel rendering / more FPS)
Package settings menu now includes a toggle for Boot Package and Error Logging.
- Error logging will now only occur for packages when Error Logging is set to an On state. (off by default)
- Logs will be generated within the package folder in log.txt.
- Root package / root boot package logging will only work with command logging.
- Calls of logging command will always bypass Error Logging and log errors and commands to the designated log.txt.
New placeholder variables {cpu_speedo}, {cpu_iddq}, {gpu_speedo}, {gpu_iddq}, {soc_speedo} and {soc_iddq}.
New progress indicator bar for visualizing download, unzip, and copy percentages.
- New theme color settings progress_color and progress_alpha.
Return of shutdown controllers for manually powering off all connected bluetooth controllers.
- This feature still does not work with Mission Control. Just a heads up.
New language variables.
- Alternate languages may still need translations done to the updated .json files.
Updates to libraries devkitA64 and libnx.
Numerous code optimizations for smaller compilation size and slightly faster commands.
Various bug fixes.

Full Changelog: d959363...v1.7.2

Update:

Pre-release period is over. Things appear to be stable. - (09/03/2024 12:27 PM PST)
Number of memory related bug fixes.
Corrections to memory ID (got messed up upon initial release).
Couple logging related bug fixes.
Copy buffer has been increased to 4x and properly linked.
Live wallpaper swapping bug fix. - (09/03/2024 3:21 AM PST)
More live wallpaper swapping bug fixes. - (09/03/2024 4:15 AM PST)
- Tighter/stricter timing for swapping wallpapers to prevent more random crashes. - (09/03/2024 6:28 AM PST)
Placeholder replacement order of operations bug fix. - (09/03/2024 6:00 PM PST)
Full Changelog: v1.7.2...9ff96ba

Version 1.7.1

Expanded System page to include various device related information.
- This table currently includes device firmware, bootloader version, hardware type, memory information, and storage information.
- Special thanks to ComplexNarrative.
New command placeholder variables {ram_vendor}, {ram_model}, {ams_version}, and {hos_version}.
Expansion of refresh command to include wallpaper for the ability to reload wallpaper.rgba,
- Called refresh wallpaper.
Improved scrolling implementation. (proper time-synced speed interpolation)
Complete recalibration of character width map.
- This should result in more proper table alignments when using tables with info sections aligned to the right.
Multiple memory related bug fixes.
- More memory leaks have been fixed, which should result in less heap overloads / crashes.
Language replacements are now performed on every ListItem and CategoryHeader upon initialization.
- This fixed entries like, for example, Reboot To and Shutdown from not being properly translated.
- Language json's may still need some translations for the new words that have been included.
Removal of shutdown controllers for space conservation. (commented out)
- Did not want to remove this function, but because it only works with Nintendo controllers (and not Mission Control) it does seem somewhat redundant since the sync button on Nintendo controllers effectively turns off the controller as well.
- If it is highly desirable, I may include this command again in future revisions. But for size stability, I could not get it to fit properly this time around.
Numerous code optimizations and bug fixes.
Full Changelog: 6961b2e...v1.7.1

Update:

Placeholder bug fix for new variables + bug fix for refresh command. - 08/28/2024 4:40 PM PST
TrackBar highlight width adjustment / fix. - 08/29/2024 5:05 AM PST
Rename hardware model Nx to Icosa and x1 to X1. (correction) - 08/29/2024 5:28 AM PST
Full Changelog: v1.7.1...d959363

Version 1.7.0

New memory expansion option (located inSettings > System).
- This function requires internet the first time it is ran, otherwise you can place nx-ovlloader.zip and nx-ovlloader+.zip in sdmc:/config/ultrahand/expansion/. (see here for the .zips)
- nx-ovlloader.zip (base memory) and nx-ovlloader+.zip (expanded memory) are recompilations of WerWolv's nx-ovlloader 1.0.6/1.0.7.
- Notice: This feature will utilize an extra 2 MB of system memory for overlays and will require a reboot after being toggled for changes to apply.
New wallpapers implementation. (requires memory expansion)
- Wallpapers must be formatted in .rgba and be exactly 448x720 pixels in resolution.
- Place .rgba formatted wallpapers into sdmc:/config/ultrahand/wallpapers/, then they will show up in the Wallpaper Manager in the Settings Menu.
- Sidenote: For full 60 FPS in Ultrahand with wallpapers, overclock CPU >=1581.0 MHz.
Numerous optimizations to the libTesla renderer.
- Multi-thread rendering (requires expanded memory).
- Reduced big-O complexity.
- Sidenote: With stock clocks and no wallpaper, users should expect to now get ~60 FPS in menu.
Various improvements to tables, track-bars and the track-bar highlight/select cursor.
Time-synced controller scrolling implementation, time-synced click saturation effect, and a variety of corrections within libTesla.
Mod .pchtxt's now utilize @stop properly when generating IPS mods. (helpful for developers)
New Polish language implementation and slight bug fixes to the languages menu.
Various bug fixes.
- Fix for missing pre-generated root package. (was missing in v1.6.9)
- Downloads bug fix. (was broken fi missing path sdmc:/config/ultrahand/downloads/ in v1.6.9)
Compilation libraries have been updated (excluding devkitA64 which has been left at r25.1-1).
Full Changelog: v1.6.9...v1.7.0

Update:

Expanded memory toggle bug fix. 08/24/24 9:00 AM PST
Full Changelog: v1.7.0...6961b2e

Version 1.6.9

Dropdown and forwarder commands can now use custom labels/footers by using footer= with a value other than null in the package's config.ini.
Custom name and version labels for overlays and packages can now be set in /config/ultrahand/overlays.ini and /config/ultrahand/packages.ini by using options custom_name= and custom_version=.
- Overlays will only be renamed when displayed on the menu. Direct modification of the overlay is still required for any re-naming of the overlay modules themselves.
- Packages will now assume names in the following priorities.

i. Priority 0: Custom names and versions written in packages.ini.
ii. Priority 1: Package name stated in the header in the package.ini file for the Ultrahand package.
iii. Priority 2: If none of the above, it will assume the name based upon the Ultrahand package folder.

- If left empty, custom name and version parameters will be unused.
New option for table ;header_indent= for drawing a single header indent on left side of the line.
- This is meant to be used on one line "header-like" tables.
New table text color options for info_text_color and section_text_color.
- text : Ultrahand theme text color used for default text.
- header : Ultrahand theme text color used for headers.
- on_value : Ultrahand theme color for On values / values.
- off_value : Ultrahand theme color for Off values / version labels.
Key combo string representations in packages will now return their symbolic representation.
Software update menu will now pull an indicator for the latest Ultrahand Overlay version from the GitHub API.
Themes classic.ini and ultra.ini will now be auto-downloaded when opening the Theme manager if they do not exist.
Downloads are now stored in a temporary state until completion. After completion, they are then moved into place.
- This should help with failed downloads and files being removed/replaced after a failed download to an existing filepath.
The packages menu commands section now utilizes the same core logic as the packages themselves. (code optimization)
Improvements to Reboot To pre-generated command in root package. (/switch/.packages/package.ini)
- If you are missing this feature, you may need to delete /switch/.packages/package.ini.
Various subtle UI positioning corrections and bug fixes.
- Bug fix for cursor jumping/sliding after using hotkeys (with a d-pad down button) in games.
Full Changelog: cc7afad...v1.6.9

Version 1.6.8

Introduction of ini_file_source function and expansion of ini_file function.
- Dropdown selections can now use ini_file_source <PATH_TO_INI> which will return a list of ini section name.
- Introduction of new placeholder index replacements selections{ini_file(<INDEX>)} / {ini_file_source(*)} for returning section names. (regular usage of ini_file placeholder calls will still function the same way, as well as ini_file_source)
Named step-trackbars can now use standard json_source, json_file_source, and ini_file_source source functions and placeholder replacements.
Expansion of filter to non-path type entries in dropdown selections.
- Called filter <NAME_OF_ENTRY>.
Expansion of exit command to exit directly to the overlays menu or packages menu.
- Called exit overlays / exit packages.
Expansion of refresh command.
- refresh theme: reload/refresh the current current loaded theme (/config/ultrahand/theme.ini)
- refresh package: reload/refresh the current working package (redraws menu)
Introduction of compare function to compare two text file lists and output a duplicate files list.
- Called compare <PATH_TO_TXT_1> <PATH_TO_TXT_2> <OUTPUT_TXT_PATH>.
New option -copy_filter / -cp_filter for move / mv commands utilizing -src + -dest.
- Called move -src <SRC_TXT> -dest <DEST_TXT> -copy_filter <FILTER_TXT>.
- This will run a copy instead of move for files in the filter list text file.
Introduction of new placeholder function split for splitting strings.
- Called {split(<STRING>,<PATTERN>,<INDEX>)}.
- For example, if the string is Test - String, the pattern is " - ", and the index is 0, the output would be Test.
Updates to the pre-generated /switch/.packages/package.ini root package file to include Reboot To (for booting directly into /bootloader/hekate_ipl.ini boot entries.
- Notice: Users may need to delete /switch/.packages/package.ini for it to generate a new one.
Various optimizations to the command interpreter, file manipulation logging, bulk execution implementations, and to move / mv operations.
Additional tweaks to the dangerous pattern detection function.
Update to Mod Alchemist now at v0.4.7.
- Bug fixes for toggling content mods with duplicate files (utilizing -copy_filter and compare).
Full Changelog: v1.6.7...v1.6.8

Update:

Filter bug fix. (affected Reboot To) - 07/22/2024 2:53 PM PST
Addition of -filter <FILTER_TXT> command option for move, copy, and delete. - 07/22/2024 8:35 PM PST
- This allows for filtering of bulk executions (-src / -dest).
Full Changelog: v1.6.8...cc7afad

Version 1.6.7

New optional command parameters for copy/cp, move/mv, and delete/del commands for transfer logging and bulk executions.

a. File manipulation logging: -log_src / -log_dest (outputs a text list for source file and destination file locations)
- copy <source_file_path> <destination_file_path> -log_src <src_output_txt_file_path> -log_dest <dest_output_txt_file_path>
- move <source_file_path> <destination_file_path> -log_src <src_output_txt_file_path> -log_dest <dest_output_txt_file_path>
- delete <source_file_path> -log_src <src_output_txt_file_path>
b. Bulk execution: -src / -dest (utilizes text lists to perform transfer operations on all entries)
- copy -src <src_input_txt_file_path> -dest <dest_input_txt_file_path>
- move -src <src_input_txt_file_path> -dest <dest_input_txt_file_path>
- delete -src <src_input_txt_file_path>
Improvements and fixes to file_source toggle functions.
Improved handling of null placeholder replacements.
Corrections to isDangerousCombination (the dangerous pattern combination detection function).
- The following paths are now ultra-protected (unable to delete or move files from):
  - sdmc:/Nintendo/Contents/
  - sdmc:/Nintendo/save/
  - sdmc:/emuMMC/RAW1/Nintendo/Contents/
  - sdmc:/emuMMC/RAW1/Nintendo/save/
- Slight improvements to dangerous pattern detection.
Updates to Mod Alchemist (now v0.4.6, requires Ultrahand v1.6.7+).
- Now utilizes the new command options for managing "Contents" mods.

Full Changelog: v1.6.6...v1.6.7

Version 1.6.6

Major memory leak has been fixed.
- This issue was present for a while now, but until Mod Alchemist was never as concerning. Since Mod Alchemist can draw extremely long menus, memory overflow problems became more apparent.
- Has been resolved and should result in better memory handling across all Ultrahand packages/commands.
Slight tweaks to the displayed version label formatting for overlays and packages.
Failed interpreter spawning bug fix.
- Commands would occasionally get locked in an "in-progress" mode when there were memory related problems when trying to spawn the interpreter thread. When memory related problems occur, the command will return a failed command state instead (red "X").
Full Changelog: 1c08f0f...v1.6.6

Version 1.6.5

Introduction of root-layer boot package implementation for executing commands upon startup.
- Command [boot] located within /switch/.packages/boot_package.ini (if it exists) will be now be auto-ran once on startup.
- This feature can be useful for Switch Android users if they wanted to remove the auto-generated Android folders (for instance).
Introduction of new command pchtxt2cheat (called pchtxt2cheat /path/to/file.pchtxt).
- This function will convert pchtxt files and load them into the correct directory for the game's cheat.
- Important: The game's title ID must be present somewhere within the pchtxt for this function to work.
Various bug fixes to pchtxt2ips's IPS generation.
Expansion of shutdown command to turn off all bluetooth controllers.
- This function is called shutdown controllers.
- Notice: I have heard that this command may fail (return a red X) with MissionControl due to conflicting services, so just a heads up.
Source function file_source can now be chained (called one after another) for combining multiple sources into a single list.
Source function definitions can now also utilize an ini_file placeholder replacement (with the ini_file specified before the definition).
Various bug fixes to file_source toggles.
- Subsequent clicks to file_source toggles are now handled properly with alternating path replacements according to the last line move {file_source} /destination/path/ (must be present for file_source toggles).
Various bug fixes to ini_file placeholder replacements.
- Failed replacements now return null again instead of Not available (the UNAVAILABLE_SELECTION language variable).
- When a value is null on a table info section, it is now auto replaced with UNAVAILABLE_SELECTION.
Language selections in the Settings Menu now state their full names in their translated language with their abbreviations listed as footers.
- This included updates to all /config/ultrahand/lang/ files.
Additional key combo LS+RS has been added to the combos list.
- This includes a correction to the LS button icon.
Commands mirror_copy and mirror_delete can now accept wildcard patterns.
Introduction of new Ultrahand Package Mod Alchemist designed for managing, converting, and installing game mods. (formerly the Mod Master example package)
- Notice: This package requires Ultrahand Overlay v1.6.5+.
Full Changelog: v1.6.4...v1.6.5

Update:

Bug fix for the root-layer boot package implementation. - 07/07/2024 7:09 AM PST
- The issue was the commands appeared to be executing every time the overlay is spawned. Now it is fully isolated to run once on boot.
Wildcard pattern bug fix. - 07/07/2024 9:00 PM PST
- The issue was that in certain cases, folder patterns were still returning files. Should be resolved now.
Slight optimizations to transfer memory. - 07/07/2024 9:34 PM PST
- Freed up a little more memory to prevent some potential memory related bugs.
Json replacement failure fall back value bug fix. - 07/08/2024 1:10 AM PST
- This includes fall back null related bug fixes as well as fixes to table drawing with null values.
Transfer memory correction. - 07/09/2024 05:07 AM PST
- Issues noticed after freeing up a bit too much of the transfer memory, so corrections needed to be made.
IPS generation bug fix. - 07/09/2024 06:16 AM PST
- Offsets were improperly being applied during pchtxt2ips generation. Corrections have been made.
Full Changelog: v1.6.5...1c08f0f

Version 1.6.4

Optimizations to the ;on_every_tick= implementation for track-bars.
- Faster on every tick command execution.
New table option additions ;section_text_color= and ;info_text_color=.
- Both section and info text color are optional parameters that can be set to:
  - default (normally default when unspecified)
  - warning (new built-in theme color warning_text_color)
  - or any specified RGB888 hex color string
Forwarder package versions and title colors are now inherited from the layer 0 package (package.ini) if left unspecified within the forwarder package.
- Users no longer need to specify forwarder package versions and colors on every forwarder package ini.
Bottom buttons and settings menu touch functions now utilize theme colors click_color and click_alpha for drawing highlights on the touch regions.
Various touch interaction bug fixes. (touching "OK" on top of a track-bar, bottom regions for touch adjusted to language text size, etc.)
Slight tweaks to pixel blender for drawn strings during hiding.
Full Changelog: 0eeef44...v1.6.4

Version 1.6.3

List of changes:

IMPORTANT: Tables in v1.6.3 no longer utilize ;header= pattern and no longer draw headers. Tables also no longer require a $ in the command name.
- To define a header, use an empty package command (like how they are defined normally).
Introduction of 3 track-bar command mode implementations.
i. Regular track-bar is called utilizing ;mode=trackbar.
- ;min_value= sets the minimum integer value
- ;max_value= sets the maximum integer value
- ;units= sets the display units
- ;unlocked= is an optional true/false parameter for unlocked track-bars (locked by default)
  - At least one track-bar must first be clicked (A) for all track-bars to be editable (unless unlocked).
- ;on_every_tick= is an optional true/false parameter for executing listed commands on every track-bar tick (off by default)
  - By default, commands are executed the moment the interactions with the slider stop.
ii. Step track-bar is called utilizing ;mode=step_trackbar.
- ;steps= is an optional integer parameter for directly specifying the number of steps utilized with the step track-bar.
iii. Named step track-bar is called utilizing ;mode=named_step_trackbar.
- Requires a list_source definition or a list_file_source definition (for loading the names).
- Does not use ;min_value=, ;max_value=, ;units=, nor ;steps=.
All track-bars commands can be used with placeholders {value} for returning the value and {index} for returning the index. Both value and index are also stored within the package config.ini file according to the track-bar entry.
Introduction of 5 new placeholder commands.
i. {slice(<ANY_STRING>,<START_INDEX>,<END_INDEX>)} slices any string according to a start and end index.
ii. {decimal_to_hex(<DECIMAL>)} converts a decimal string into a hex string.
iii. {ascii_to_hex(<ASCII>)} converts an ascii string into a hex string.
iv. {hex_to_rhex(<HEX>)} inverts the endian of a hex string.
v. {hex_to_decimal(<HEX>)} converts a hex string into a decimal string.

Bug fix: All variable placeholders no longer require a specified order for operations.
Optimized input handling for smoother / faster menu item traversal.
New theme colors and updates to theme ultra.ini.
i. header_text_color is the text color for category headers.
ii. header_separator_color is the separator rectangle color for category headers.
iii. star_color is the color of the favorites star when unselected.
iv. selection_star_color is the color of the favorites star when selected.
v. bottom_button_color is the color of the buttons displayed at the bottom of the window.
vi. bottom_separator_color is the color of the separator drawn near the bottom of the window.
vii. bottom_text_color is the color of the text drawn at the bottom of the window next to the buttons.
viii. trackbar_slider_color is the color of the trackbar slider.
ix. trackbar_slider_malleable_color is the color of the trackbar slider when it is in a modifiable mode (unlocked / press A).
x. trackbar_slider_border_color is the color of the thin border around the slider.
xi. trackbar_full_color is the color of the trackbar for the filled portion.
x. trackbar_empty_color is the color of the trackbar for the empty portion.
xi. default_package_color is the default color for package titles (used if none is specified in the package header).

IMPORTANT: All colors with word seperator are now spelt correctly separator. (grammer typo fix)
Expansion of backlight command.
- In addition to on and off, backlight can now take an integer percentage value for precise backlight modifications.
- backlight <PERCENTAGE>
Bug fix for refresh command.
- refresh should now behave on the level / page it is called upon.
Improved touch scrolling implementation. (cursor no longer is redrawn as touch scrolling is initiated)
Updated libnx from v4.6.0 to v4.7.0.
Page left / right traversal now works with joysticks in addition to the d-pad.
Various bug fixes and command optimizations.

Full Changelog: v1.6.2...v1.6.3

Update:

Alignment correction for track-bar sliders and up / down bounce effect for track-bar cursors. (06/14/24 3:45 AM PST)
Named step-bar tick indicator color and position correction. (06/14/24 3:53 AM PST)
v1.6.3...0eeef44

Version 1.6.2
List of changes:

New methods list_file and list_file_source for reading lines from a text file.
- They are defined list_file <path_to_text_file> / list_file_source <path_to_text_file>.
- Their behavior is similar to a regular list with placeholders {list_file(<index>)} and {list_file_source(<index>)}.
Bug fixes for nested package dropdown selections.
Opaque screenshots will now be turned on by default upon initialization.
- To disable, enter the Miscellaneous menu and click the toggle item.
Bug fixes for Tesla combo persistence.
Addition of a couple more default Tesla combos as well as fixes for reading alternate user specified combos.
Settings menu code revision. (for smaller compilation)
Various libtesla alignment corrections.

Update:

Widget alignment correction. (05/26/2024 2:44 AM PST)
Couple additional key combos (added by request). (05/26/2024 3:32 AM PST)
Slight footer alignment correction. (05/26/2024 5:08 AM PST)

Version 1.6.1

New command mode ;mode=slot for slot commands.
- slot commands are similar to default, but with the ability to set footers (similar to an option command).
Various placeholder replacement bug fixes.
- Preservation of null arg with default to Not available upon final replacement.
- Placeholder replacements now no longer contribute to command success/failure. (determined now solely by commands themselves.)
- {file_name} replacements no longer include file extensions.
Hex edits will now be unprocessed for null arguments and still return successful. (bug fix)
New placeholder {timestamp(<strftime>)} for logging time as a variable.
- strftime are datetime formats like "%Y-%m-%d".
Nested layers bug fix (for nested layers beyond layer 1).
Package forwarder bug fixes.
Slight tweaks to libtesla.

Version 1.6.0

More improvements to UI and libtesla.
- Rending related bug fixes and optimizations.
- Pixel blender bug fix (for transparency layer blending).
- Improvements to string/character length computations.
- Slightly improved cursor and menu layout.
New themes values selection_bg_alpha and table_bg_alpha for blended transparency.
- Updates to default + ultra themes.
New effect option Opaque Screenshots (located in Settings > UI Settings > Miscellaneous) for removing overlay transparency from screenshots for Ultrahand.
Slight improvements to the unzip command method. (boundary case bug fixes)

Version 1.5.9

More improvements and optimizations to the tables implementation.
- New option ;background= which is a true/false value for drawing the table background.
- New configurable theme color table_bg_color for configuring table background colors.
More refinements and optimizations to libTesla.
- Slightly faster rendering + cleanup of various implementations.
Update to default and ultra themes.
Bug fix for Ultrahand starting opened after shutting down within an overlay. (only present in v1.5.8)
Bug fix for nested package pages.

Version 1.5.8

Numerous across the board optimizations and bug fixes. (Significant memory/speed improvements from v1.5.7.)
- Improved code structure and memory consumption.
- Optimized menu item sorting. (for drawing the overlays / packages menu)
- Improved themes loading implementation.
- New hiding overlay implementation. (animations + widget throttling correction)
- set-ini-value now will create folders if necessary when initializing new ini's.
- Bug fixes for move and delete commands.
- CURL global initialization. (fix for random crashes using download function)
- Bug fixes for default key combo initialization. (for fresh setups)
New table implementation for drawing information.
- Table commands must start with $ in the command name and include ;mode=table.
- Additional options for configuring tables:
  - ;header= is a true/false option for drawing the section header with the table.
  - ;alignment= is a string value left, right, or center for controlling the value column alignment. (default value is right).
  - ;offset= is an integer value for configuring the values column offset with a left / center alignment. (default value is 160)
  - ;spacing= is an integer value for configuring the newline spacings for drawing the table. (default value is 0)
  - ;gap= is an integer value for configuring the post-table gap. (default value is 3)
- Placeholders are fully functional for drawing tables with parsed values. (json, hex, list, etc.)
- New theme color options table_section_text_color and table_info_text_color.
New unzip + copy progress indicator.
Progress animation. (see Settings > UI Settings > Miscellaneous > Effects > Progress Animation)
Various subtle UI improvements and corrections.

Version 1.5.7

List of changes:
- New function remove-ini-key for removing key/value pairs from a specified INI section.
  - remove-ini-key <path_to_ini> <desired_section> <desired_key>
- Unzip / copy progress indicator for background commands in progress. (similar to the download progress indicator)
  - WARNING: cp / copy now behaves more like the Shell / Bash version of cp, where it copies contents from the specified directory directly to the specified directory. it no longer forces a copy of the folder, requiring a potential rename.
- Buffer s and heap memory are now configurable from /config/ultrahand/config.ini. (see new package Memory Config)
  - This was added for additional configurations during testing.
  - When properly set, functions may gain a speed improvement. But configure with caution.
- Across the board optimizations and code revisions for faster functions with reduced memory.
  - Numerous revisions and improvements to libultra.
- Various minor bug fixes.
Update:
- Copy folder related bug fix. (05/10/2024 6:51 AM PST)
- hex-by-custom-rdecimal-offset bug fix. (05/10/2024 4:59 PM PST)
- More slight optimizations + bug fixes with hexing. (05/10/2024 11:14 PM PST)

Version 1.5.6

List of changes:
- Package path shortcuts implementation, called ./ for package path within command ini's.
  - i.e. /switch/.packages/<NAME_OF_PACKAGE>/ can now be called as ./
  - When fully utilized, this allows users to rename Ultrahand packages without any path conflicting.
- Basic toggles called without sourcing can now take a default state.
  - ;mode=toggle?on for defaulting to on when never clicked
  - ;mode=toggle?off for defaulting to off when never clicked (current default functionality for ;mode=toggle)
- backlight command now requires a on / off state. (bug fix)
  - Here is a simple way to use can the backlight function as a toggle.
  - [Backlight]
  - ;mode=toggle?on
  - on:
  - backlight on
  - off:
  - backlight off
- Numerous optimizations for a variety of the *_funcs.hpp methods. (faster menu drawing and commands)
- New scroll bar implementation has been corrected.
- Returning from a hidden overlay now takes you back to the hidden overlay menu.
- Reduced memory imprint of ovlmenu.ovl.
- Creation of libultra (restructuring of project into a custom library).
  - This allows users to potentially build their own Ultrahand Overlays when utilized with my libtesla fork.
  - To use, users simply need to copy the libs folder into their project, then import and use libtesla as they would normally.
Update:
- Hidden package / overlay settings bug fix + setIniFile bug fix. (05/07/2024 5:49 AM PST)
  - If you did use v1.5.6 before this update, you might want to run this command once (just to be safe).
  - [Clear INIs]
  - delete /config/ultrahand/packages.ini
  - delete /config/ultrahand/overlays.ini
  - delete /config/ultrahand/theme.ini
  - delete /config/ultrahand/config.ini
  - delete /config/.packages/config.ini
  - delete /switch/.packages/*/config.ini
- Path shortcut fix for json_file_source + fix for commands grouped together with a package forwarder. (05/07/2024 4:04 PM PST)
- Wildcard pattern bug fix + move files/folders bug fix. (05/07/2024 8:55 PM PST)
  - This may have affected this line from executing properly delete /switch/.packages/*/config.ini. You may still want to run this command once if you used v1.5.6 earlier than the first update.
- More last minute wildcard pattern bug fixes. (05/07/2024 11:19 PM PST)

Version 1.5.5

List of changes:
- Implementation of new package forwarders for extended Ultrahand packages.
  - To use forwarders, use command mode ;mode=forwarder with * in the command name.
  - Forwarder package is defined with package_source <PATH_TO_FORWARDED_INI>.
  - Additional commands listed along side package_source are executed upon click.
- UI related bug fixes and tweaks.
  - Scroll bar implementation has been modified.
  - Page alignment has been slightly adjusted.
  - Adjustments to spacing of info sections.
- Touch implementation has been cleaned up a bit more.
  - Fix for unmapped toggle commands (and others).
- Various minor menu traversing related bug fixes.
Update:
- Nested package implementation bug fix. (05/05/2024)

Version 1.5.4

List of changes:
- Better memory management and utilization of smart pointers. (potential memory leaks resolved hopefully)
- Interpreter thread now is initialized when command is ran.
- Root package commands now accept dropdown commands (similar to the current package command implementation).
- Removal of last_menu setting from /config/ultrahand/config.ini. (no longer needed)
- Setting key combo from the Settings Menu now also updates /config/tesla/config.ini. (for persistence reasons with libTesla overlays)
- Menu traversing related bug fixes.
- Various bug fixes.

Version 1.5.3

List of changes:
- Removal of <sys/stat.h>/<cstdio> and implementation of <fstream> in every function.
- More improvements to make every function to make them thread safe (json, hex, ini, etc.)
- Slight restructuring of various sections of code.
- Reduction of compilation size.
- Various bug fixes and improvements.

Version 1.5.2

List of changes:
- Numerous menu related memory leak bug fixes.
- Revision to the background thread implementation.
- Various improvements to download, json, ini, and path functions.
- Bug fixes for refresh function as well as exec boot.

Version 1.5.1

List of changes:
- Full touch support is now included.
  - You can now touch the logo/widget section to enter the settings menu.
- Multi-threading implementation for the interpreter.
  - Package commands (except boot_package for now) now operate on a background thread, allowing users to hide the overlay during long tasks. This includes background downloads.
- Introduction of new theme coloring variables. (mostly for commands in progress)
- New ;system= command headers, called ;system=erista or ;system=mariko.
  - These headers will only draw commands onto the menu depending upon what system they are being displayed on.
- New file path grouping types (will be better documented later with the revision of Mod Master, now planned for v1.5.2).
- Pressing L jumps back to the first item on the menu.
- Various bug fixes in download_funcs as well as libTesla.
Update:
- Download progress implementation.
- Pressing R cancels / kills a command in progress.
- Many bug fixes.
- New command exit for exiting Ultrahand directly.
- Interpreter optimizations and stability bug fixes. (final update 04/25/2024)

Version 1.5.0

Introduction of new pchtxt2ips method, called pchtxt2ips <PCHTXT_FILE_PATH> <OUTPUT_FOLDER>.
- This allows the easy conversion of .pchtxt files into .ips binaries.
Download commands now show a downloading indicator (footer) to help users understand when a file is downloading.
Failed replacements now return null instead of -1. Failed json replacements now return Not available (UNAVAILABLE_SELECTION variable).
Bug fix for starring / favoriting hidden overlays and packages.
libnx has been updated.

Version 1.4.9

List of changes:
- Numerous refinements to the UI and libTesla.
  - (cleanup alignments, rounded corner cursor, corrections to footer draw locations, listItem size, etc.)
- Expansion of the configurable themes.
  - New variables for customizing background color, various text colors, logo color, and dynamic logo color.
  - New themes light.ini and light-v2.ini (light mode themes) as well as updates for the rest.
- Introduction of DEFAULT_CHAR_WIDTH variable within the language json for more precise mapping of character width in alternate languages.
Update:
- Slight default logo color tweak.

Version 1.4.8

List of changes:
- Improved toggles implementation.
  - Toggles no longer require a source and use the pre-generated config.ini for storing state information.
  - Sidenote: Dropdown selection toggles still may require revisions to their implementation some time down the line.
- Failed variable replacements now return a value.
  - Currently set to -1 for failed replacements, but may be revised to something more unique in the next update.
- Various bug fixes as well as code optimizations.
  - This included a footer bug fix (was present in v1.4.6 but missing from v1.4.7).
  - More memory related optimizations across a variety of functions.
- Updates to OC Toolkit (now at v0.3.6).
  - Sys-clk Settings are now configurable from the Tools menu.
Update:
- Another bug fix for option command selection footers. - 11/25/23 10:06 PM PST
- libTesla bug fixes (widget drawing related fixes). - 11/26/23 7:00 AM PST

Version 1.4.7

Numerous code optimizations and revisions across the board for all methods.
- These ranged from bug fixes to stricter/cleaner memory management within functions.
- Especially helpful for downloading command failure related bugs.
New commands:
- backlight toggles on/off the screen
- hex-by-custom-decimal-offset, hex-by-custom-rdecimal-offset (similar to hex-by-custom-offset but accepts decimal representations of hex for replacement.
- mariko:, erista: define code blocks that will execute based upon if the device is mariko or erista.
Update:
- Bug fix for mariko: and erista: calls.
- More memory related optimizations. - 11/19/23 6:21 AM PST
- Default Tesla combo bug fix. - 11/20/23 2:40 PM PST
- Overlay sorting bug fix for overlays with _ within overlayNames. - 11/20/23 8:08 PM PST
- Last minute memory related optimizations. - 11/21/23 3:40 AM PST
- Rewrite of Studious Pancake's functions for IsErista and IsMariko. (bug fix) - 11/21/23 5:02 PM PST
- Bug fix for Not available commands in alternate languages. - 11/22/23 6:47 AM PST
- More libTesla optimizations. (faster menu). - 11/22/23 6:47 AM PST
- New clear command clear hex_sum_cache for clearing the hexSumCache. - 11/22/23 7:22 AM PST

Version 1.4.6

Addition of a toggle-able User Guide (drawn by default on the Packages Menu).
Reboot directly to Hekate menu now implemented within the reboot command.
- Called reboot hekate or reboot HEKATE (similar to reboot ums).
Initialization / auto-generation of /config/tesla/config.ini for legacy compatibility.
- This is primarily for preserving hide/show hot keys within overlays.
- You are not required to ever touch nor modify /config/tesla/config.ini.
- Modifications within Ultrahand will automatically carry over.
Default Tesla launch combo (L+DDOWN+RS) now works upon first run in addition to Ultrahand's default launch combo (ZL+ZR+DDOWN).
- The combo that is clicked first will be the combo that Ultrahand assumes.
- Combo can then be updated from the Settings Menu.
Version Labels is now a subcategory within Miscellaneous in addition to Menu Items.
- Users can show/hide the User Guide from within Miscellaneous.
Various bug fixes and implementation modifications.
- Update:
Slight indentation cleanups.

Version 1.4.5

New function try: for executing blocks/lines of code with error catching.
- Commands in the chain are still executed normally without try:.
- Subsequent try: statements blocks will be executed in order until success is reached throughout an entire block.
- (See updated examples Easy Installer and OC Toolkit.)
New highlight color added to themes for "clicking".
- This color will only be applied when the selection background is set to not be drawn.
- When selection background is disabled, clicking backgrounds will also be disabled.
If any of the lines within the command that involve sourcing, hexing, downloading, or unzipping fail, it will return a red cross symbol instead of a checkmark.
Various bug fixes.

Version 1.4.4

Theme manager is now built into the Settings Menu (PLUS / +).
- Themes will have their own custom name and be placed within /config/ultrahand/themes/<THEME>.ini.
Themes have been expanded to include variables selection_text_color, selection_bg_color, disable_selection_bg and disable_colorful_logo.
- disable_selection_bg is set to true by default. This significantly improves the speed of rendering the UI, resulting in a smoother experience moving around (especially noticeable in the Script Overlay).
Addition of several extra Key Combo button combinations on the Settings Menu. (ZL+ZR+PLUS, L+R+PLUS, PLUS+MINUS)
Numerous libTesla bug fixes and optimizations.
- These ranged from improper cropping of certain menu items to correcting draw locations.
- Additional improvements to text scrolling.
- Half float data-type implementations.
Update: 11/6/23 2:13 AM PST
Bug fixes for download functions, json_source functions, and Package Info drawing.
Updates, fixes and expansions to OC Toolkit (now v0.2.9).

Version 1.4.3

Key combo initialization bug fix (primarily for people not coming from Tesla Menu).
- This bug made an initialized /config/ultrahand/config.ini file not write hotkeys to the ini without Tesla config files.
- Default key combo is now ZL+ZR+DDOWN if no key combo is found and will be auto generated with the config.ini.
ListItem scrolling is now time synchronized in libTesla.
- When you under clock your device and see a long command name, this is especially noticeable.
- Previous behavior would scroll the text from left to right very slowly when clock speeds go down, then faster when they speed up.
- With time synchronized animation, behavior is standardized, creating an overall smoother experience on the menu. (better resource management)
Various (minor) fixes and improvements.
Update: 11/02/2023 10:49 PM PST
- Credits are now an addition in Ultrahand packages, called ;credits= (similar to ;about=).
  - Slight cleanup of scrolling implementation.
- smoothing effect has been added to scrolling (for cleaner animation)
- Toggles for "On" and "Off" for Ultrahand Packages now use the active language.

Version 1.4.2

Built with latest libnx for official HOS 17.0.0 support.
- Temperatures are now working on HOS 17.0.0.
Addition of UI Settings menu. (within Settings Menu PLUS/+).
- Widget for clock, temperature, and battery is now easily toggleable.
- Version Labels has been moved into it's own subgroup.
Software Update is now its own subgroup with overlay info for Ultrahand as well as language update options.
- Ultrahand Overlay information is now displayed in the Software Update section.
JSON placeholder replacement functions have been rewritten/improved.
Various bug fixes and improvements.

Version 1.4.1

Ini parsing and formatting related bug fixes.
- This fixes issues like the first key in your keyCombo not working in libTesla.
- Also improves formatting structure when adding in entries into ini files.
Expanded themes and UI improvements.
- Themes (/config/ultrahand/theme.ini) now have options trackbar_color, highlight_color_1, highlight_color_2.
- The /config/ultrahand/config.ini also lets you control visibility of clock, temperatures, and battery.
- libTesla dynamic color effects are now synced to time instead of being driven by clock-speed. You will notice that even when under-clocking the color effects are always full speed.
RebootToPayload functions via Studious Pancake (AMS 1.6.0+).
- The reboot command has now been expanded with payload / Hekate functionality. This was done in preparation for HOS 17.0.0.
  - reboot ini <ENTRY_NAME> or reboot ini <ENTRY_INDEX>
  - reboot boot <ENTRY_NAME> or reboot boot <ENTRY_INDEX>
  - reboot /path/to/payload.bin
  - reboot UMS
  - reboot
- sidenote: Reboot by id is coming soon. All of these functions have been coded to work on both Mariko and Erista.
Software updates for Ultrahand can now be performed from the Settings menu (PLUS / +).
Launch arguments for overlays are now passable from /config/ultrahand/overlays.ini.
- You can press Y on an overlay to enter the Overlay settings menu, then enable/disable launch arguments.
- Launch arguments must be set by hand within /config/ultrahand/overlays.ini otherwise are initialized empty.
Temperature now include both SOC and PCB temperature, but 17.0.0 implementation for temperature is currently still pending on libnx. (soon).
- Backend for implementation has been written and is currently commented out.
Various updates to languages files (still a WIP).

Version 1.4.0

Improvements to UI (battery, configurable clock, sensor, drawspace, etc.)
International languages implementation.
- Language files go in /config/ultrahand/lang/*.json
- NOTE: Help is still needed to get some of these translations down. Language files are subjected to updates, but feel free to modify them yourself for your language.
Expanded settings menu.
- key combo is now configurable from the Settings menu (PLUS)
Start of themes implementation (text_color, clock_color, battery_color).
- Themes are stored in /config/ultrahand/theme.ini.
Improved overlay sorting. (done by Overlay name instead of Overlay file name).
Multiple bug fixes.
Faster command interpreter. (update 10/20/23 9:23 PM PST)
- After inspection, this actually resulted a in ~0.4MB file size reduction.
Sidenote: HOS 17.0.0 messed up temperature readings with libnx. This should be easily fixed once libnx is updated for 17.0.0.

Version 1.3.9

Star-ing overlays is now done by pressing X instead of PLUS.
Pressing PLUS on main menu now invokes the Ultrahand Settings menu (a page to control some settings in the config.ini).
Pressing Y on top of an overlay / package pulls up the Menu settings for that particular item.
New hidden overlays/packages page for storing hidden overlays/packages (will be drawn at the bottom when populated).
New option clean_version_labels in /config/ultrahand/config.ini (can be set on Ultrahand Settings menu).
- Clean versions restricts all displayed version labels into a X.X.X format.
Various bug fixes.

Version 1.3.8

Introduction of Pages: Now, you can define pages using empty commands [@PAGE1] and [@PAGE2], where PAGE1 and PAGE2 are labels for the page. Note that only two of these empty @-commands can be referenced in a package. You can navigate between PAGE1 and PAGE2 using the left and right buttons on the DPAD.
New Command remove-ini-section: I've added a new command called remove-ini-section <ini_file_path> <section_name>. This command allows you to quickly remove a section from an INI file.
Package Info Section: You can now include a Package Info section within your package.ini file by using [Package Info] as an empty command. If there's no reference to [Package Info], the package info section will not be displayed.
Package title colors now accept custom RGB888 hex representations (i.e. #FFFFFF for white).
NOTE: RGB888 hex color format will be downscaled to RGB444 for libTesla compatibility.
- Bug Fixes: Addressed various bug fixes, including a memory leak issue on the main menu.
New updates to OC Toolkit.

Version 1.3.7

Hex offset caching has been implemented for faster hexing read/write calls.
Various additional improvements to hex functions.
New true/false property hide for packages.ini and overlays.ini to toggle visiblity.
New command logging to enable/disable command logging (now off by default).
New command clear for deleting Ultrahand relavent files (so far only clear log works).
New ;color= header definition in package.ini for choosing colors for your package title.
- Colors: red, green(default), blue, yellow, orange, purple, pink, white, ultra(wip)

Version 1.3.6

Added the ability to define functions in boot_package.ini other than boot.
Enabled referencing and execution of global functions defined in boot_package.ini from your script using exec <COMMAND>.
Introduced a new refresh command to redraw the current menu page.
Various bug fixes as well as improvements to OC Toolkit.
Menu related bug fix (memory leak). Opening and closing selection overlay with dictionaries was not unloading the dictionary. Issue has been resolved.
If a command has the footer "Not available" it will no longer function.

Version 1.3.5

Introduction of boot_package.ini (commands that will run when your package is opened). This file is placed in the same folder as your package.ini file.
Introduction of new hex_file advanced function for reading/parsing hex data from files.
Introduction of command tags, i.e. [COMMAND?Tag]. Tags are not printed, but are helpful for making similar named commands unique (which is essential).
New example package OC Toolkit for advanced modifications of kip files. (WIP)
Update:
Ive added a new function ini_file to read data from ini files.
- ini_file <ini_file_path> is how it is defined.
- {ini_file(section, key)} is how it will be called.

Version 1.3.4

List of changes:
- Empty commands now define grouping sections.
- Empty commands with a * at the start of them define group commands. Commands defined after will show up in a dropdown menu.
- To end the identification of a group command, a group section must be defined.
- New command set-footer.
- Various bug fixes.
Basic example:

[Section 1]
[*Test]
;mode=option
list_source '(test1, test2, test3)'
set-footer {list_source(*)}

[*Timings]
;mode=option
list_source '(1, 2, 3, 4, 5, 6)'
set-footer {list_source(*)}

[*Commands Group]
[*Test2]
json_source '[{"key_1":"entry 1", "key_2":"entry 2", "key_3":"entry 3"}, {"key_1":"entry a", "key_2":"entry b", "key_3":"entry c"}]' key_1

[Section 1]
[*Test3]
;mode=option
list_source '(test4, test5, test6)'
set-footer {list_source(*)}

update:
- Bug fix for selected footer after entering command groups. - 10/3/2023 4:48 PM

Version 1.3.3

List of changes:
- Fixed dropdown toggles. (Setup double click prevention to ensure commands are properly parsed.)
- New option command mode for selections. (useful for developing configurators scripts.)
- New auto-generated config.ini for each package.ini within the package folder. Settings will be parsed from package.ini if provided as a comment.
  - mode: this can be set to default, option, or toggle.
  - grouping: this can be set to default or split (split splits commands into groups based upon subfolders)
  - footer: null by default. When used with option mode, it can be dynamically read on the menu.
- DONE is now replaced by a checkmark.
Basic Option Example:
- Package: /switch/.packages/Test/package.ini

Version 1.3.2

Bug fixes with interpreter allocating too much memory.
- This affected unzip and download in certain test cases, but is no longer an issue.
- Easy Installer and other download packages should now work properly again.
UPDATE: (stable)
- Root menu commands (/switch/.packages/package.ini) now behave the same way as package menu commands.
- Config menu has now been fixed. (09/26/23 11:21 PM)
- Multiple menu related bug fixes. (09/27/23 2:25 AM)

Version 1.3.1

json_data (the non source version) is now json_file.
json is now a new non-source version of json_source for storing data within the package.ini.
list_source has been fixed. Items defined in list can be called by {list_source(<INDEX>)}.
list is now a new non-source version of list_source. Items defined in list can be called by {list(<INDEX>)}.
Re-built interpreter and SelectionMenu/SubMenu.
Introduction of selection modes ;mode=.
Drop of _on and _off functions.
- Sections can be defined using ;mode=toggle and on: followed by the on commands and off: followed by the off commands.

Version 1.3.0

config.ini is now package.ini for Ultrahand packages.
source is now file_source
source_on is now file_source_on
source_off is now file_source_off
json_source is now json_file_source
New function json_source for defining JSONs directly within the package.ini file.
- Example: json_source '[{"key1":"value1"}, {"key1":"value2"}]' key1
Menu item sorting are now implemented differently.
- New files /config/ultrahand/overlays.ini and /config/ultrahand/packages.ini for manually specifying priority and storing information.
- Priority value is a number from 0 to 9999

Version 1.2.1

hide_overlay_versions and hide_package_versions are now true or false options within /config/ultrahand/config.ini.
hex-by-custom-offset is now a new command for using custom string pattern offsets for more advanced hex-editing scenarios.
New wildcard source command type list_source implementation for specifying list variables within package inis.
Several bug fixes.

Version 1.2.0

Commands now state "DONE" after pressed.
Bug fix for "set-ini-value". Issue was that for a new entry, it would inject the new entry into every section.
Simple fix, but since its bound to affect someone's project eventually, I'm updating the release.

Version 1.1.9

Bug Fixes: Static menu variable and rootFrame handling.
These bug fixes potentially resolve the menu handling issue that occasionally can occur for some testers.
Overall it should be more stable with static implementations of the particular variables I modified.

Version 1.1.8

Introduction of footers for commands.
Testing potential bug fix for handling menu input.
This issue is not very common, but occasionally the menu can get locked into a weird orientation, preventing you from moving to packages or overlays at times. Its hard to figure out the exact trigger, but I've attempted to address the issue here. Pre-release will be dropped after more testing. If you see this bug on this version, do let me know in issues.

Version 1.1.7

Download and unzip files implementation has been added.
Command to download:
- download <FILE_URL> <DESTINATION_FILE_OR_FOLDER>
Command to unzip:
- unzip <SOURCE_FILE> <DESTINATION_FOLDER>
CURL has made it a bit beefier as you can tell, but the potential benefits are pretty great for having these commands handy. Lots of new packages can be made for updating and installing software.
update: slight bug fix for handling more URLs (07/07/2023)
update: bug fix for unzip and createDirectories (07/08/2023)

Version 1.1.6

Move commands now create directory if the directory does not exist.
Bug fix for exiting main menu that can sometimes occur when exiting (locked users in the menu until an item is selected).
Multiple filters are now implemented. filter, filter_on, filter_off calls will store your filter path into a list.

Version 1.1.5

Bug fix for those who specify their default menu mode instead of resorting to last_menu.
Several cosmetic improvements.
Easier transition from Tesla Menu by copying combo from sdmc:/config/tesla/config.ini if it exists and the combo is not within sdmc:/config/ultrahand/config.ini.

* update: more cosmetic improvements after initial release (only difference)

Version 1.1.4

Ultrahand is now a replacement for ovlmenu.ovl.
Ultrahand packages are now relocated to sdmc:/switch/.packages/.
Ultrahand specific settings are now stored in sdmc:/config/ultrahand/config.ini.
Left on the menu takes you to your overlays.
Right on the menu takes you to your packages and commands.
More improvements to come.

Version 1.1.3

Introduction of more selection command features.
Multi-wildcard statements.
New functions 'mirror_copy' and 'mirror_delete' for implementing mirror functions on directory contents.
All copy functions now create destination directories.

Version 1.1.2

Selection (wild card commands) toggles are now implemented.
Simple one line filter added. (see updated examples).

Version 1.1.1

Introduction of wildcard commands (new command-type).

Version 1.10.0

Pre-release: Testing new hex editing functions.
New commands "hex-by-offset", "hex-by-swap", "hex-by-decimal", "hex-by-rdecimal"
Still needs more testing to confirm full functionality, but since it appears to be compiling properly ill leave it here for now for testing.

Version 1.0.9

Implemented safeguards so you don't delete or move your entire SD card or essential files. Still have more features to implement for this version, it should be better than using 1.0.8 but since I made changes that need review I am still calling it pre-release for now.
Update: More advanced pattern searching. Multiple wildcards. 2:42 AM PST 06/08/2023
Update: Updated safeguards for more advanced patterns. 3:16 AM PST 06/08/2023

Version 1.0.8

Added new feature "new-ini-entry" and restored original example config.ini generated if no config is present.

Version 1.0.7

Improvements to menu. Version handling for user packages.

Version 1.6

More improvements, "edit-ini" commands have now been labeled "set-ini". You can also press X on an individual command and see and execute individual lines within.
- Update: Faster copying. - 05/31/23 4:19PM PST
- Update: Even faster copying. - 05/31/23 4:35PM PST
- Update: Slight size reduction. - 06/01/23 6:34PM PST

Version 1.0.5

Too many bug fixes with statement logic.
Ability to execute individual commands from a package have been added (press X on package).
More slight tweaks and capabilities packed into the functions.
- Update: Fixed editINI adding new lines by mistake. - 05/29/23 05:16 PM PST
- Update: Fixed copy directory not copying subdirectories. - 05/29/23 05:59 PM PST
- Update: Edit ini key or value now. - 05/29/23 09:40 PM PST

Version 1.0.4

Slight tweaks to libtesla. This is pre-release, but it is still commits ahead of 1.0.3 and stable.
- Update: Got new features as well as pattern searching implemented. New documentation coming soon. 05/29/23 9:11 AM PST

Version 1.0.3

Improvements to code structure, menu layout, new commands (reset, shutdown), etc.
- Update: Copy function now can rename to file as well as copy to directory. This makes it simulate "cp" a bit better. - 05/27/23 7:37 AM PST
- Update: Fixed edit-ini bugs. - 05/27/23 2:21 PM PST
- Update: Fixed even more edit-ini bugs. Should be working. - 05/27/23 3:27 PM PST
- Update: Fixed one last edit-ini bug for handling command. Testing safer reboot method. - 05/27/23 9:40 PM PST

Version 1.0.2

Folders have now been added.
Future plans: cleaner UI, separation for "Packages" and "Commands" sections with titles.
- Update: Fixed a bug that occurred with linking folders. - 05/28/23 05:59 PM

Version 1.0.1

New feature 'parse-ini'.
Update: Delete directory bug fix. - 05/28/23 8:11 AM PST

Version 1.0

First Release.
- Update: Improved structure and examples for testing. - 05/25/23 5:52 PM PST

External links

@@ Line 4: / Line 4: @@
 |description=The fully craft-able overlay executor. Create directories, manage files, and customize configurations effortlessly using simple ini files.
 |author=ppkantorski
-|lastupdated=2026/02/20
+|lastupdated=2026/03/13
 |type=Overlays
-|version=2.2.8
+|version=2.3.0
 |license=Mixed
 |download=https://github.com/ppkantorski/Ultrahand-Overlay/releases
@@ Line 81: / Line 81: @@
 ==Changelog==
+'''Version 2.3.0'''
+* Numerous improvements to the notifications implementation.
+** Notification options have been moved to the Notifications Menu (in System Settings).
+** Multiple notifications can be shown at once (up to the <code>Max Slots</code> value).
+*** When using 4MB overlay memory, max slots is capped at 4, otherwise it is capped at 8. (default value 4)
+** API Notifications (formerly known as <code>External Notifications</code>) are formatted as follows:
+<pre>    {
+        "text": "This is an example notification.",
+        "font_size": 24, #optional
+        "split_type": "word" #optional, word by default
+        "alignment": "left", #optional, center by default without a title
+        "duration": 4000, #optional duration in ms
+        "title": "Example App", #optional, allows show_time
+        "show_time": "true", #optional, true by default
+        "priority": 20, #optional (ideally not modified)
+    }</pre>
+*** Stored in <code>/config/ultrahand/notifications/{APP_ID}-{UNIQUE_ID}.notify</code> (JSON format)
+*** API Notifications can be filtered with the existence of <code>/config/ultrahand/flags/notifications/{APP_ID}.flag</code>.
+** Notification icons are now supported and must be 50x50 RGBA format with <code>{APP_ID}</code> matching the notification json.
+*** <code>/config/ultrahand/assets/notifications/{APP_ID}.rgba</code>
+** Package command <code>notify</code> / <code>notification</code> and <code>notify-now</code> / <code>notification-now</code> has been expanded.
+*** <code>notify &lt;MESSAGE&gt; [FONT_SIZE] [TEXT_ALIGNMENT] [SPLIT_TYPE] [DURATION_MS] [TITLE] [SHOW_TIME] [APP_NAME]</code>
+**** <code>&lt;MESSAGE&gt;</code>: the main notification message text. (only 4 lines can be displayed)
+**** <code>[FONT_SIZE]</code>: an integer value in range 8 to 48 (24 by default with a title, 26 without a title).
+**** <code>[TEXT_ALIGNMENT]</code>: either <code>left</code>, <code>center</code>, or <code>right</code>.
+***** By default, without a title it is <code>center</code> and with one it is <code>left</code>.
+**** <code>[SPLIT_TYPE]</code>: either <code>word</code> or <code>char</code>.
+**** <code>[DURATION_MS]</code>: the duration for the prompt in milliseconds. (500 min, 4000 by default)
+***** A duration value of 0 will keep the prompt displayed indefinitely until dismissal.
+**** <code>[TITLE]</code>: a title for the notification.
+**** <code>[SHOW_TIME]</code>: a <code>true</code>/<code>false</code> value for showing the timestamp alongside the title. (requires a title)
+**** <code>[APP_NAME]</code>: allows the notification command to use an icon (used if present)
+***** To use an app name without a title, title must be an empty string (<code>&quot;&quot;</code>).
+*** <code>notify-now</code> follows the same pattern as <code>notify</code> but always displays in slot 0 with immediate priority.
+*** '''Sidenote:''' All <code>[]</code> parameters are optional and are interpreted based upon their value and order.
+** New notification sound effect <code>/config/ultrahand/sounds/notification.wav</code>.
+*** Users may need to re-apply the default theme for this new sound effect to load.
+*** The <code>Silence Notifications</code> toggle disables notification sound effects.
+** Notifications can be dismissed with <code>KEY_MINUS</code> clicks, as well as via direct touch.
+** API toggle hotkey (hold <code>KEY_MINUS</code> for 4s) allows disabling API Notifications on demand easily.
+*** The API toggle hotkey can be enabled / disabled in the Notifications Menu.
+* New theme colors <code>notification_title_color</code>, <code>notification_time_color</code>, and <code>unfocused_color</code>.
+** <code>notification_title_color</code> is the color for the notification titles.
+** <code>notification_time_color</code> is the color for the notification timestamps.
+** <code>unfocused_color</code> is the color <code>KEY_A</code>+&quot; OK&quot; is displayed with at the bottom of the overlay when no items are in focus.
+* New package command <code>touch</code>, called <code>touch &lt;PATH_TO_FILE&gt;</code>.
+** Command creates an empty text file according to the file path if the file does not exist.
+* New <code>Packages Menu</code> toggle (in Miscellaneous) for hiding the packages menu completely.
+* Timestamp placeholder <code>{timestamp()}</code> (with no formatting parameter) can now also be called as <code>{timestamp}</code>.
+* <code>System RAM</code> previews now automatically change with <code>Overlay Memory</code> adjustments in the System Settings menu.
+* Sound effects can now use <code>8000 Hz</code>, <code>11025 Hz</code>, <code>16000 Hz</code>, <code>22050 Hz</code>, <code>32000 Hz</code>, and <code>44100 Hz</code> 16-bit PCM wav files in addition to <code>48000 Hz</code>.
+* Feedback (haptics + sound) is now processed on its own background thread for improved performance and reliability.
+* Improvements to haptics in handheld mode.
+* Cleanup of language json's (removal of unused / unnecessary variables).
+* Bug fix for internet connection checks in download calls.
+* Various list class corrections / improvements.
+* Various code optimizations, bug fixes, and improvements.
+* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/f580fd9...v2.3.0 Full Changelog: f580fd9...v2.3.0]
+Quick Update:
+* JSON placeholder parsing bug fix (for allowing numerical / boolean conversions to strings). - 03/12/2026 11:26 PM PST
+* Script Overlay no longer removes tags from ListItem commands (bug fix). - 03/12/2026 11:26 PM PST
+* Notification timestamp positioning bug fix (for notifications with no icons). - 03/12/2026 11:42 PM PST
+* Separator symbol coloring for notification text. - 03/13/2026 12:01 AM PST
+* Notification touch dismissal in right-side mode bug fix. - 03/13/2026 1:12 AM PST
+'''Version 2.2.9'''
+* Overlay freeze bug fix triggered when entering the packages menu with '''GDB debugging''' enabled in Atmosphere.
+** When <code>enable_htc = u8!0x0</code> and <code>enable_standalone_gdbstub = u8!0x1</code> are present in the <code>system_settings.ini</code>, prior versions can freeze / become unresponsive when entering the packages menu (or any package in general) while within an application / game.
+** This was because <code>getBuildIdAsString</code> (updated among the general placeholders) was relying on <code>dmnt:cht</code> which conflicts directly with the standalone GDB stub.
+* <code>libnx</code> has been updated to latest.
+*  [https://github.com/ppkantorski/Ultrahand-Overlay/compare/c6a9c08...v2.2.9 Full Changelog: c6a9c08...v2.2.9]
+Quick update:
+* Build ID value correction (was pulled from wrong index). - 02/22/2026 12:49 PM PST<br />
+* [https://github.com/ppkantorski/Ultrahand-Overlay/compare/v2.2.9...f580fd9 Full Changelog: v2.2.9...f580fd9]
 '''Version 2.2.8'''
-# All language font glyphs are now accessible regardless of the specified language (<code>libultrahand</code> fix).
+* All language font glyphs are now accessible regardless of the specified language (<code>libultrahand</code> fix).
-#* Special thanks to [https://github.com/tomvita @tomvita].
+** Special thanks to [https://github.com/tomvita @tomvita].
-# Packages can now utilize language translation json's (similar to <code>libultrahand</code> overlay language translations).
+* Packages can now utilize language translation json's (similar to <code>libultrahand</code> overlay language translations).
-#* Language json's go within the <code>lang</code> folder within the package's main folder and are utilized based upon the current selected overlay language.
+** Language json's go within the <code>lang</code> folder within the package's main folder and are utilized based upon the current selected overlay language.
-#* Translations are based upon <code>drawString</code> calls with keys being the original text and values being the translations.
+** Translations are based upon <code>drawString</code> calls with keys being the original text and values being the translations.
-# New package command option headers.
+* New package command option headers.
-#* <code>;state=</code> works with values <code>handheld</code> or <code>docked</code> and will only draw the list item if in handheld or docked accordingly.
+** <code>;state=</code> works with values <code>handheld</code> or <code>docked</code> and will only draw the list item if in handheld or docked accordingly.
-#* <code>;hos_version=</code> works with version values or with comparison signs <code>&gt;=</code>, <code>&lt;=</code>, <code>&gt;</code>, <code>&lt;</code> + the specified version directly after.
+** <code>;hos_version=</code> works with version values or with comparison signs <code>&gt;=</code>, <code>&lt;=</code>, <code>&gt;</code>, <code>&lt;</code> + the specified version directly after.
-#* <code>;ams_version=</code> works with version values or with comparison signs <code>&gt;=</code>, <code>&lt;=</code>, <code>&gt;</code>, <code>&lt;</code> + the specified version directly after.
+** <code>;ams_version=</code> works with version values or with comparison signs <code>&gt;=</code>, <code>&lt;=</code>, <code>&gt;</code>, <code>&lt;</code> + the specified version directly after.
-#** Both <code>;hos_version=</code> and <code>;ams_version=</code> will only draw the command when the conditions are met.
+*** Both <code>;hos_version=</code> and <code>;ams_version=</code> 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.
+** '''Side-note:''' All of these new command headers can be used in combination or isolation.
-# New package placeholder variables.
+* New package placeholder variables.
-#* <code>{package_version}</code> returns the current package version from which the command exists in (specified in the header).
+** <code>{package_version}</code> returns the current package version from which the command exists in (specified in the header).
-#* <code>{backlight}</code> returns the current handheld backlight level.
+** <code>{backlight}</code> returns the current handheld backlight level.
-#* <code>{volume}</code> returns the current master volume level.
+** <code>{volume}</code> returns the current master volume level.
-# New command <code>!path_exists</code> (similar to <code>path_exists</code> except it returns command failure if the specified path exists).
+* New command <code>!path_exists</code> (similar to <code>path_exists</code> except it returns command failure if the specified path exists).
-#* Called <code>!path_exists &lt;SPECIFIED_PATH&gt;</code>.
+** Called <code>!path_exists &lt;SPECIFIED_PATH&gt;</code>.
-# Changes to root package boot package behavior (<code>/switch/.packages/boot_package.ini</code>).
+* Changes to root package boot package behavior (<code>/switch/.packages/boot_package.ini</code>).
-#* The <code>on-boot</code> entry now triggers specified commands once on system startup (similar to how <code>boot</code> used to function).
+** The <code>on-boot</code> entry now triggers specified commands once on system startup (similar to how <code>boot</code> used to function).
-#* The <code>boot</code> entry now triggers once when the <code>Packages Menu</code> is entered, as well as once on the <code>Packages Menu</code> after overlay hiding has triggered.
+** The <code>boot</code> entry now triggers once when the <code>Packages Menu</code> is entered, as well as once on the <code>Packages Menu</code> after overlay hiding has triggered.
-# New <code>Sounds</code> manager for selecting overlay system sound effects (bundled in .zip's).
+* New <code>Sounds</code> manager for selecting overlay system sound effects (bundled in .zip's).
-#* Sound zip packs go in <code>/config/ultrahand/.sounds/</code> (files must be around the same size as the default sounds pack).
+** Sound zip packs go in <code>/config/ultrahand/.sounds/</code> (files must be around the same size as the default sounds pack).
-#* The <code>Sound Effects</code> toggle has been removed from the <code>Features</code> page.
+** The <code>Sound Effects</code> toggle has been removed from the <code>Features</code> page.
-#* The <code>NO_SOUND_EFFECTS_UPDATES</code> update flag has now been removed (no longer necessary).
+** The <code>NO_SOUND_EFFECTS_UPDATES</code> update flag has now been removed (no longer necessary).
-# Update to <code>Overlay Info</code>, with info properly translated in each supported language.
+* Update to <code>Overlay Info</code>, with info properly translated in each supported language.
-#* New project developer animation on the &quot;Software Update&quot; page.
+** New project developer animation on the &quot;Software Update&quot; page.
-#* Languages update command in the <code>Software Update</code> menu has been removed (now unnecessary).
+** Languages update command in the <code>Software Update</code> menu has been removed (now unnecessary).
-# 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.
+* 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).
+** 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).
-# Scrolling category headers now properly resume scroll state during regular <code>goBack</code> calls (<code>libultrahand</code> fix).
+* Scrolling category headers now properly resume scroll state during regular <code>goBack</code> calls (<code>libultrahand</code> fix).
-# Now including patches from [https://github.com/averne/MasterVolume Master Volume] for unbounded volume sliding from 100% to 150% using the <code>volume</code> command.
+* Now including patches from [https://github.com/averne/MasterVolume Master Volume] for unbounded volume sliding from 100% to 150% using the <code>volume</code> command.
-# Download commands now verify internet access on network connection (to prevent hanging while on a network without internet access).
+* Download commands now verify internet access on network connection (to prevent hanging while on a network without internet access).
-# The &quot;hold A to execute&quot; list item behavior has been reduced from 4s to 3s to trigger.
+* The &quot;hold A to execute&quot; list item behavior has been reduced from 4s to 3s to trigger.
-# TrackBar unlocking / locking feedback tweaks.
+* TrackBar unlocking / locking feedback tweaks.
-# Script overlay ''freeze'' bug fix (placeholder replacement infinite loop bug fix).
+* Script overlay ''freeze'' bug fix (placeholder replacement infinite loop bug fix).
-# Various boundary case fixes to the <code>List</code> class in <code>libultrahand</code>.
+* Various boundary case fixes to the <code>List</code> class in <code>libultrahand</code>.
-# Bug fix for package version labels not being displayed ''clean'' with <code>Clean Versions</code> enabled.
+* Bug fix for package version labels not being displayed ''clean'' with <code>Clean Versions</code> enabled.
-# Improvements to image rendering (<code>libultrhaand</code>).
+* Improvements to image rendering (<code>libultrhaand</code>).
-# Various additional bug fixes and code optimizations.
+* Various additional bug fixes and code optimizations.
 Quick update:
 * Sounds preservation on update bug fix. - 02/20/2026 2:14 AM PST