Homebrew Homebrew app Ultrahand Overlay - The fully craft-able overlay executor

[ppkantorski]

Will be releasing improvements to Mod Master to make it less of an example, and more of a practical tool for mod management (and a replacement for IPSWitch). Updates will comes along side v1.5.1. Still sorting out the bugs and writing code, so I will let you guys know when it is ready.

 

[ccarr6257]

@ppkantorski
Do these options still work in the new version 1.50?

yes

 

[ppkantorski]

I didn't get a chance to finish the new mod management package, but i did make some considerable improvements in v1.5.1.

Full touch support, download progress indicator / multi threading implementation. Click R to cancel command. And you can hide Ultrahand as a command is in progress. Also some other things (listed on the change log).

 

[johw]

I didn't get a chance to finish the new mod management package, but i did make some considerable improvements in v1.5.1.

Full touch support, download progress indicator / multi threading implementation. Click R to cancel command. And you can hide Ultrahand as a command is in progress. Also some other things (listed on the change log).

thanks for the work

 

[TheStonedModder]

Ultrahand Overlay (HOS 16.0.0+)



Create directories, manage files, and customize configurations effortlessly using simple ini files.

View attachment 400949

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.

Features​

Ultrahand is a Tesla overlay that provides powerful functionality for managing files and directories on an SD card. It 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.
• 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. Customize and tailor your INI files effortlessly through its intuitive interface.
• 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.
• 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 projects 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 unzip 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.

Getting Started​

Nintendo Switch Compatibility​

To run Ultrahand Overlay on the Nintendo Switch, you need to have the necessary homebrew environment set up on your console running HOS 16.0.0+. Once you have the homebrew environment set up, you can transfer the compiled .ovl to your Switch and launch it using your old Tesla Menu hotkeys.

Please note that running homebrew software on your Nintendo Switch may void your warranty and can carry certain risks. Ensure that you understand the implications and follow the appropriate guidelines and precautions when using homebrew software.

Usage​

To use Ultrahand, follow these steps:

1. Download and install the latest nxovloader.
2. Download the latest Ultrahand ovlmenu.ovl and place it within `/switch/.overlays/`.
   • WARNING: This will overwrite Tesla Menu if already installed.
3. 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.
4. Launch Ultrahand similarly to Tesla Menu with your specified hotkey. A new folder will be made (`/switch/.packages/`) with a preset `config.ini` file for your base menu commands.
5. Place your custom config.ini package file in the Ultrahand package directory (`/switch/.packages/YOUR_PACKAGE/`). This file will contains the commands for your custom Ultrahand package.
6. Your commands will now show up on the packages menu within Ultrahand. You can click A to execute any command as well as click X to view/execute the individual command lines written in the ini for execution.

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

Compilation Prerequisites​

To compile and run the software, you need to have the following C/C++ dependencies installed:

• custom libtesla fork
• switch-curl
• switch-zziplib
• switch-mbedtls
• switch-jansson

Contributing​

Contributions are welcome! If you have any ideas, suggestions, or bug reports, please create an issue or submit a pull request.

License​

This project is licensed and distributed under GPLv2 with custom code utilizing CC-BY-4.0.

https://github.com/ppkantorski/Ultrahand-Overlay


I'm sure users will create some really cool things with the configurable .ini in time. I've created a number of example packages on the GitHub you can try out. Be sure to check the commands before running to make sure that they make sense to you.

I see you can download files but can you also compress and upload ?

I’m trying to find an easy and fast way to get save files between my switch and PC so I can have a pseudo cloud save system between my modded switch and emulator

 

[ppkantorski]

I see you can download files but can you also compress and upload ?

I’m trying to find an easy and fast way to get save files between my switch and PC so I can have a pseudo cloud save system between my modded switch and emulator

I never implemented upload, but i could. Was concerned in the past that people might distribute malicious forks that upload user data to servers without their permission (but i suppose that is the concern with all closed-source re-distributions, and one reason why GPLv2 is meant to ensure distributions are open sourced). I'll think on it. It should be easy to add tbh. In the mean time here is v1.5.2 (bug fix update).

 

[tmnr1992]

According to a post I read about Atmosphere, it said that Atmosphere + Tesla menu by itself shouldn't cause a ban, has Ultrahand been tested to see if it's as safe/unsafe as Tesla when going online?

I ask this because from what I've read here it seems Ultrahand can do some pretty crazy stuff, and was thinking about making a command that hides all bannable overlays and then boots into cfw sysnand, and another command to then go from sysnand back to emunand with all overlays enabled, making it much more convenient to swap between the two.

This way I could theoretically have my offline emunand with cheats and all that stuff, and then have a clean sysnand with Atmosphere and Ultrahand which should be relatively safe to play online.

I'm still hesitant to try this as it's probably not be worth the risk, but I was curious to know if this setup is feasible.

 

[ppkantorski]

According to a post I read about Atmosphere, it said that Atmosphere + Tesla menu by itself shouldn't cause a ban, has Ultrahand been tested to see if it's as safe/unsafe as Tesla when going online?

I ask this because from what I've read here it seems Ultrahand can do some pretty crazy stuff, and was thinking about making a command that hides all bannable overlays and then boots into cfw sysnand, and another command to then go from sysnand back to emunand with all overlays enabled, making it much more convenient to swap between the two.

This way I could theoretically have my offline emunand with cheats and all that stuff, and then have a clean sysnand with Atmosphere and Ultrahand which should be relatively safe to play online.

I'm still hesitant to try this as it's probably not be worth the risk, but I was curious to know if this setup is feasible.

Ultrahand shouldn't cause a ban. It is just like running any other Tesla menu overlay. Ultrahand also has the ability to configure ini files, and manipulate files. The "Host Guard" example lets you enable emuMMC and sysMMC host blocking as well (sysMMC if you have a custom firmware sysnand). But if sysnand is clean and you have your device offline with blocking, or online (but with full blocking) in emunand you shouldnt get banned. But don't quote me on the host blocking, that was information taken from somewhere else. What it does is block all the nintendo servers, however one day nintendo could add more servers and catch people off guard. Homebrew *shouldnt* cause a ban, but Nintendo can still ban you if they really want to. Most people have not been banned though taking these extra precautions.

 

[guily6669]

The new beta is crazy FAST!!!!!!!

Everyone will be very happy when you finish it

 

[ppkantorski]

Updated to v1.5.8.

 

[johw]

Updated to v1.5.8.

https://github.com/ppkantorski/Ultrahand-Overlay/tree/main/themes
Faker Dev 04g.ini
Faker Dev 05Br.ini
Are these two themes new?

 

[ppkantorski]

https://github.com/ppkantorski/Ultrahand-Overlay/tree/main/themes
Faker Dev 04g.ini
Faker Dev 05Br.ini
Are these two themes new?

they are a couple themes made by user Faker Dev. i may isolate themes a bit more, or make a dedicated board for them on GitHub.