Toggle menu
Toggle preferences menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.
The main server is currently down. We are running on a backup server, so editing and search functionality are temporarily disabled. Please check back in a few hours.

Hekate Toolbox Switch: Difference between revisions

From GameBrew
No edit summary
No edit summary
Line 1: Line 1:
{{Infobox Switch Homebrews
{{Infobox Switch Homebrews
|title=Hekate Toolbox
|title=Hekate Toolbox
|image=hekatetoolboxswitch.png
|image=hekatetoolboxnx.png
|description=A toolbox for Hekate
|description=A toolbox for Hekate. Formerly Kosmos Toolbox.
|author=WerWolv
|author=WerWolv
|lastupdated=2023/04/17
|lastupdated=2023/04/17
Line 8: Line 8:
|version=4.0.3
|version=4.0.3
|license=GPL-3.0
|license=GPL-3.0
|download=https://dlhb.gamebrew.org/switchhomebrews/hekatetoolboxswitch.7z
|download=https://dlhb.gamebrew.org/switchhomebrews/hekatetoolboxnx.7z
|website=https://github.com/WerWolv/Hekate-Toolbox/
|website=https://github.com/WerWolv/Hekate-Toolbox/
|source=https://github.com/WerWolv/Hekate-Toolbox
|source=https://github.com/WerWolv/Hekate-Toolbox
|donation=
|donation=
}}
}}
{{#seo:
Hekate Toolbox (formerly Kosmos Toolbox) is an application that allows you to change settings of the loader (requires a modified version of loader).  
|title=Switch Homebrew Apps (Utilities) - GameBrew
 
|title_mode=append
It was originally developed for the use with tomGER's SDFiles (later AtlasNX's [[Kosmos Switch|Kosmos]]), but fully works with Hekate-based CFW configurations.
|image=hekatetoolboxswitch.png
|image_alt=Hekate Toolbox
}}
The Hekate Toolbox is a set of tools that enables the user to modify loader settings (however, a modified version of the loader is required). Initially designed for use with tomGER's SDFiles, it is now compatible with Hekate-based CFW configurations, including [[Kosmos Switch|AtlasNX's Kosmos]].


==Features==
==Features==
Line 27: Line 23:
* Capability for sysmodule hotloading and unloading.
* Capability for sysmodule hotloading and unloading.
* Capability to reboot to Hekate profiles and the Hekate menu.
* Capability to reboot to Hekate profiles and the Hekate menu.
==Installation==
Place the .nro to the /switch/ folder on the SD card.
==User guide==
===Change override keys===
Set hbmenu launch button combination. Support up to 8 custom title overrides.
* Any Title - For all game, apps, etc.
* Change default - Change the default key, support for 4 applets: Album, Nintendo eShop, User Profile and Controller.
* Custom title - Choose a specific app or game.
===Hekate autoboot profile===
Allows you to skip the Hekate menu when loading Hekate payload, options include:
* Hekate menu.
* Atmosphere(SysNAND).
* Atmosphere(EmuNAND).
* Stock (SysNAND).
* [[Lakka_Switch|Lakka]],
===Background services===
Activate/deactivate system modules.
Third-party sysmodules can create a toolbox.json file in their folder (/atmosphere/contents/...) to make them be loadable by the toolbox.
toolbox.json format:
<pre>
{
"name"  : "sys-something",
"tid"  : "0100000000000999",
"requires_reboot": false
}
</pre>
==Screenshots==
https://dlhb.gamebrew.org/switchhomebrews/hekatetoolboxnx2.png
https://dlhb.gamebrew.org/switchhomebrews/hekatetoolboxnx3.png
https://dlhb.gamebrew.org/switchhomebrews/hekatetoolboxnx4.png
https://dlhb.gamebrew.org/switchhomebrews/hekatetoolboxnx5.png
https://dlhb.gamebrew.org/switchhomebrews/hekatetoolboxnx6.png
https://dlhb.gamebrew.org/switchhomebrews/hekatetoolboxnx7.png


==Media==
==Media==
'''HEKATE TOOLBOX - REBOOT HEKATE V2/OLED - ÉTEINDRE - CHANGER L'ACCÈS DU HBMENU (ALBUM) - SYS-MODULES - ([https://www.youtube.com/watch?v=pO_A7_SG3Ow deejay87])'''<br>
'''HEKATE TOOLBOX - REBOOT HEKATE V2/OLED - ÉTEINDRE - CHANGER L'ACCÈS DU HBMENU (ALBUM) - SYS-MODULES ([https://www.youtube.com/watch?v=pO_A7_SG3Ow deejay87])'''<br>
<youtube>pO_A7_SG3Ow</youtube>
<youtube>pO_A7_SG3Ow</youtube>


==Screenshots==
==Compatibility==
https://dlhb.gamebrew.org/switchhomebrews/hekatetoolboxswitch-01.png
Tested on:
https://dlhb.gamebrew.org/switchhomebrews/hekatetoolboxswitch-02.png
 
https://dlhb.gamebrew.org/switchhomebrews/hekatetoolboxswitch-03.png
FW 16 <br>
https://dlhb.gamebrew.org/switchhomebrews/hekatetoolboxswitch-04.png
FW 15.0.0 / AMS 1.4.0 <br>


==Changelog==
==Changelog==
'''v4.0.3'''
'''v4.0.3 2023/04/17'''
* Recompiled using newest libraries in order to support newer firmwares
* Recompiled using newest libraries in order to support newer firmwares.
* Tested working on FW 16 - Ty to @hax4dazy for compiling and testing this release!
* Tested working on FW 16 - Ty to @hax4dazy for compiling and testing this release.
'''v4.0.2'''
'''v4.0.2 2023/10/15'''
*Introduced restricted mode in the "Reboot to Hekate" menu:
*Introduced restricted mode in the "Reboot to Hekate" menu:
**It will be turned on when the app can't completely prepare for a hekate reboot, but has enough to do a basic reboot or shutdown.
**It will be turned on when the app can't completely prepare for a hekate reboot, but has enough to do a basic reboot or shutdown.
**This will be mostly useful for Mariko users.
**This will be mostly useful for Mariko users.
**Suggested by Monked on Discord
**Suggested by Monked on Discord.
*Removed hid-mitm support (it's deprecated and broken and no longer necessary)
*Removed [https://github.com/jakibaki/hid-mitm hid-mitm] support (it's deprecated and broken and no longer necessary).
*Binary size cut almost in half
*Binary size cut almost in half.
There were also lots of changes that have been ready for years but never actually made it into a release until now:
There were also lots of changes that have been ready for years but never actually made it into a release until now:
*Regular reboot to hekate has been made safer thanks to Atmosphere's ams:bpc service
*Regular reboot to hekate has been made safer thanks to Atmosphere's ams:bpc service.
*Regular reboot to hekate now also has a "Boot to UMS (SD Card)" option, which immediately boots you into hekate with USB transfer enabled
*Regular reboot to hekate now also has a "Boot to UMS (SD Card)" option, which immediately boots you into hekate with USB transfer enabled.
**Suggested by FennecTECH
**Suggested by [https://github.com/fennectech FennecTECH].
*Lots of tiny refactors everywhere
*Lots of tiny refactors everywhere.
*Tested working on FW 15.0.0 / AMS 1.4.0
*Tested working on FW 15.0.0 / AMS 1.4.0.
'''v4.0.1'''
'''v4.0.1 2021/01/06'''
* Rebranded "Kosmos Toolbox" to "Hekate Toolbox", including the logo.
* Rebranded "Kosmos Toolbox" to "Hekate Toolbox", including the logo.
** This is a purely visual change.
** This is a purely visual change.
** We actually debranded it nearly a year ago, see: [https://github.com/WerWolv/Hekate-Toolbox/commit/fae9f2112b2696cbb20dce76b93b41ebcee3366d fae9f21].
** We actually debranded it nearly a year ago, see: [https://github.com/WerWolv/Hekate-Toolbox/commit/fae9f2112b2696cbb20dce76b93b41ebcee3366d fae9f21].
* Compiled with the latest LibNX and other used libraries to hopefully fix some bugs
* Compiled with the latest LibNX and other used libraries to hopefully fix some bugs.
'''v4.0.0'''
'''v4.0.0 2020/01/07'''
* Override key settings now support up to 8 custom title overrides.
* Override key settings now support up to 8 custom title overrides.
** This feature only works in Atmosphere 0.10.2 and higher!
** This feature only works in Atmosphere 0.10.2 and higher.
* Added an option to select a title when configuring overrides.
* Added an option to select a title when configuring overrides.
** Album override has now been renamed to "Default" and its title can be changed also.
** Album override has now been renamed to "Default" and its title can be changed also.
Line 73: Line 111:
* Most menus/submenus now remember the last button selection.
* Most menus/submenus now remember the last button selection.
* Hekate reboot menu now automatically selects the autoboot profile.
* Hekate reboot menu now automatically selects the autoboot profile.
* Having a valid config.json is no longer necessary to list sysmodules. (the toolbox.json files are an option)  
* Having a valid <code>config.json</code> is no longer necessary to list sysmodules. (the <code>toolbox.json</code> files are an option)  
* Background services, Reboot to Hekate and Reboot now! buttons have been recolored to reduce eye strain.  
* Background services, Reboot to Hekate and Reboot now! buttons have been recolored to reduce eye strain.  
* Lots of minor UI changes.
* Lots of minor UI changes.
'''v3.0.0'''
'''v3.0.0 2019/12/30'''
* Fixes so the Toolbox works with latest libnx and Atmosphere again
* Fixes so the Toolbox works with latest libnx and Atmosphere again.
* The flags folder will now be created before trying to create a boot2.flag file
* The flags folder will now be created before trying to create a boot2.flag file.
* Third-party sysmodules can now create a toolbox.json file in their folder to make them be loadable by the toolbox
* Third-party sysmodules can now create a toolbox.json file in their folder to make them be loadable by the toolbox.
* To use this feature, create a toolbox.json file in your sysmodule's /atmosphere/contents/ folder with the following format:
** To use this feature, create a toolbox.json file in your sysmodule's /atmosphere/contents/ folder with the following format:
<pre>
<pre>
{
{
Line 87: Line 125:
"requires_reboot": false
"requires_reboot": false
}</pre>
}</pre>
* The atmosphere config files will now be created and filled if none was found
* The atmosphere config files will now be created and filled if none was found.
* Allow inputs from any controller, for consistency with hbmenu v3.2.0
* Allow inputs from any controller, for consistency with hbmenu v3.2.0
* All you can see here was the work of @cathery so a huge thanks to them <3
* All you can see here was the work of @cathery so a huge thanks to them.
'''v2.1.0'''
'''v2.1.0 2019/08/18'''
*This includes pagination for the sysmodules configuration page. This allows you to have up to 18 configurable sysmodules at once, necessary for fully loaded SDSetup bundles. Thanks to @KranKRival.
*This includes pagination for the sysmodules configuration page. This allows you to have up to 18 configurable sysmodules at once, necessary for fully loaded SDSetup bundles. Thanks to @KranKRival.
'''v2.0.0'''
'''v2.0.0 2019/08/10'''
*This is the version actually in Kosmos. Creating a release to end my pain and suffering with the Kosmos package script.
*This is the version actually in Kosmos. Creating a release to end my pain and suffering with the Kosmos package script.
'''v1.1.0'''
'''v1.1.0 2019/01/26'''
* Crash fix when starting the toolbox without having any files in the /bootloader/ini directory.
* Crash fix when starting the toolbox without having any files in the <code>/bootloader/ini</code> directory.
* Fix weird behaviour when not having an exclamation mark in front of the button in the config file.
* Fix weird behaviour when not having an exclamation mark in front of the button in the config file.
'''v1.0.0'''
* First Release.


== External links ==
== External links ==
* Github - https://github.com/WerWolv/Hekate-Toolbox
* GitHub - https://github.com/WerWolv/Hekate-Toolbox

Revision as of 02:09, 5 May 2023

Hekate Toolbox
General
AuthorWerWolv
TypeUtilities
Version4.0.3
LicenseGPL-3.0
Last Updated2023/04/17
Links
Download
Website
Source

Hekate Toolbox (formerly Kosmos Toolbox) is an application that allows you to change settings of the loader (requires a modified version of loader).

It was originally developed for the use with tomGER's SDFiles (later AtlasNX's Kosmos), but fully works with Hekate-based CFW configurations.

Features

  • Ability to read and alter the hbmenu launch button combination.
  • Capability to modify the hbmenu configuration, ensuring the settings persist after reboots.
  • Capability to read and modify the default launcher between album and hbmenu.
  • Capability for sysmodule hotloading and unloading.
  • Capability to reboot to Hekate profiles and the Hekate menu.

Installation

Place the .nro to the /switch/ folder on the SD card.

User guide

Change override keys

Set hbmenu launch button combination. Support up to 8 custom title overrides.

  • Any Title - For all game, apps, etc.
  • Change default - Change the default key, support for 4 applets: Album, Nintendo eShop, User Profile and Controller.
  • Custom title - Choose a specific app or game.

Hekate autoboot profile

Allows you to skip the Hekate menu when loading Hekate payload, options include:

  • Hekate menu.
  • Atmosphere(SysNAND).
  • Atmosphere(EmuNAND).
  • Stock (SysNAND).
  • Lakka,

Background services

Activate/deactivate system modules.

Third-party sysmodules can create a toolbox.json file in their folder (/atmosphere/contents/...) to make them be loadable by the toolbox.

toolbox.json format:

{
	"name"  : "sys-something",
	"tid"   : "0100000000000999",
	"requires_reboot": false
}

Screenshots

hekatetoolboxnx2.png hekatetoolboxnx3.png

hekatetoolboxnx4.png hekatetoolboxnx5.png

hekatetoolboxnx6.png hekatetoolboxnx7.png

Media

HEKATE TOOLBOX - REBOOT HEKATE V2/OLED - ÉTEINDRE - CHANGER L'ACCÈS DU HBMENU (ALBUM) - SYS-MODULES (deejay87)

Compatibility

Tested on:

FW 16
FW 15.0.0 / AMS 1.4.0

Changelog

v4.0.3 2023/04/17

  • Recompiled using newest libraries in order to support newer firmwares.
  • Tested working on FW 16 - Ty to @hax4dazy for compiling and testing this release.

v4.0.2 2023/10/15

  • Introduced restricted mode in the "Reboot to Hekate" menu:
    • It will be turned on when the app can't completely prepare for a hekate reboot, but has enough to do a basic reboot or shutdown.
    • This will be mostly useful for Mariko users.
    • Suggested by Monked on Discord.
  • Removed hid-mitm support (it's deprecated and broken and no longer necessary).
  • Binary size cut almost in half.

There were also lots of changes that have been ready for years but never actually made it into a release until now:

  • Regular reboot to hekate has been made safer thanks to Atmosphere's ams:bpc service.
  • Regular reboot to hekate now also has a "Boot to UMS (SD Card)" option, which immediately boots you into hekate with USB transfer enabled.
  • Lots of tiny refactors everywhere.
  • Tested working on FW 15.0.0 / AMS 1.4.0.

v4.0.1 2021/01/06

  • Rebranded "Kosmos Toolbox" to "Hekate Toolbox", including the logo.
    • This is a purely visual change.
    • We actually debranded it nearly a year ago, see: fae9f21.
  • Compiled with the latest LibNX and other used libraries to hopefully fix some bugs.

v4.0.0 2020/01/07

  • Override key settings now support up to 8 custom title overrides.
    • This feature only works in Atmosphere 0.10.2 and higher.
  • Added an option to select a title when configuring overrides.
    • Album override has now been renamed to "Default" and its title can be changed also.
    • Besides listing all game titles, it comes with support for 4 applets: Album, Nintendo eShop, User Profile and Controller.
  • All buttons now autoscroll when the selection goes out of bounds.
    • This means the sysmodules page no longer needs pages. They were removed.
  • Fixed touchscreen UI not working properly when using the list selector and the message box.
  • Fixed Override key button not blocking input properly when reading for button presses.
  • Added an option to immediately exit the program by pressing PLUS.
  • Most menus/submenus now remember the last button selection.
  • Hekate reboot menu now automatically selects the autoboot profile.
  • Having a valid config.json is no longer necessary to list sysmodules. (the toolbox.json files are an option)
  • Background services, Reboot to Hekate and Reboot now! buttons have been recolored to reduce eye strain.
  • Lots of minor UI changes.

v3.0.0 2019/12/30

  • Fixes so the Toolbox works with latest libnx and Atmosphere again.
  • The flags folder will now be created before trying to create a boot2.flag file.
  • Third-party sysmodules can now create a toolbox.json file in their folder to make them be loadable by the toolbox.
    • To use this feature, create a toolbox.json file in your sysmodule's /atmosphere/contents/ folder with the following format:
{
	"name"  : "sys-something",
	"tid"   : "0100000000000999",
	"requires_reboot": false
}
  • The atmosphere config files will now be created and filled if none was found.
  • Allow inputs from any controller, for consistency with hbmenu v3.2.0
  • All you can see here was the work of @cathery so a huge thanks to them.

v2.1.0 2019/08/18

  • This includes pagination for the sysmodules configuration page. This allows you to have up to 18 configurable sysmodules at once, necessary for fully loaded SDSetup bundles. Thanks to @KranKRival.

v2.0.0 2019/08/10

  • This is the version actually in Kosmos. Creating a release to end my pain and suffering with the Kosmos package script.

v1.1.0 2019/01/26

  • Crash fix when starting the toolbox without having any files in the /bootloader/ini directory.
  • Fix weird behaviour when not having an exclamation mark in front of the button in the config file.

External links

Advertising: