Skip to content

Package Reference

ppkantorski edited this page Oct 14, 2023 · 12 revisions

The package config.ini file contains multiple sections, each defining a set of commands that can be executed. The sections are enclosed in square brackets [ ], and the commands are listed below each section.

Here's an example of a package.ini file:

;creator={CREATOR_NAME}
;version=1.0.0
;about='This is an example package with some basic command testing examples.'
;color=white

[make directories]
mkdir /switch/.packages/example1/
mkdir /switch/.packages/example2/

[copy files]
copy /switch/.packages/package.ini /switch/.packages/example1/
copy /switch/.packages/package.ini /switch/.packages/example2/

[rename files]
move /switch/.packages/example1/package.ini /switch/.packages/example1/packageX.ini
move /switch/.packages/example2/package.ini /switch/.packages/example2/packageX.ini

[move directories]
move /switch/.packages/example1/ /switch/.packages/example3/
move /switch/.packages/example2/ /switch/.packages/example4/

[delete files]
delete /switch/.packages/example1/package.ini
delete /switch/.packages/example2/package.ini

[delete directories]
delete /switch/.packages/example1/
delete /switch/.packages/example2/
delete /switch/.packages/example3/
delete /switch/.packages/example4/

[modify ini file]
copy /bootloader/hekate_ipl.ini /switch/.packages/
set-ini-val /switch/.packages/hekate_ipl.ini 'Atmosphere' fss0 gonnawritesomethingelse
set-ini-val ​/switch/.packages/hekate_ipl.ini 'Atmosphere' booty true

[Package Info]

You can add your own sections and commands to customize the actions performed by Ultrahand.

Side-note: The paths specified in the commands should be relative to the SD card root directory and should end with /.

For more complex Ultrahand package examples and implementations, please checkout Examples.

Notice: Advancements are faster than my ability to make clear documentation right now. Once things settle down, I'll work more on this wiki a bit. Lot's of new packages can be created with the improvements that have been added to v1.3.6+.

Clone this wiki locally