Homebrew Ultrahand Overlay - The fully craft-able overlay executor

[admin]

Ultrahand Overlay (HOS 16.0.0+)



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

​

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 under the CC-BY-NC-SA 4.0 License.

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.