Back
Ultrahand Overlay
by ppkantorski
|
Version | 2.0.1 |
Zip size | 749 KiB |
License | GPLv2 |
Updated | 17/08/2025 |
Downloads | 44,388 |
MD5 | 4fb1a28aeb524e5c10f3598c1564833a |
App Details
WARNING: This will overwrite Tesla Menu if already installed. Includes ppkantorski's nx-ovlloader fork.
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 files and directories on your SD card.
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.
Screenshots
Changelog
v2.0.1
List of changes:
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.
2. 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.
3. 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).
4. Various minor corrections.
v2.0.0
List of changes:
1. 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.
2. 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.
3. 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.
4. 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.
5. 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).
6. New command dot-clear, called dot-clear .
- 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.
7. 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.
8. Proper input isolation so menu navigation buttons do not interfere with combos and vise versa.
9. Thread safe ini, hexing, file operations, and page swapping.
- New libultrahand command swapTo to safely handle swapping between pages (goBack / pop + changeTo).
10. 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.
11. On return from within package dropdowns / forwarders, the page is now automatically refreshed.
- All command footers and tables will automatically redrawn.
12. Package headers can now utilize ;show_widget=true for rendering the widget.
13. Dropdown menu commands can now utilize ;mode=slot for changing the dropdown symbol to the option symbol.
14. 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.
15. Language changes are now instantly applied to the menu from within the language selection.
16. Faster menu drawing.
17. Buffer sizes for nx-ovlloader+ (memory expansion) are now loaded immediately during overlay launch.
- Slight buffer size tweaks for base loader.
18. Slight improvements to Swipe To Open.
19. Slight redesigns to various text components within the overlay.
20. Rendering related fixes and improvements.
21. 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.
22. 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.