4,578
edits
Changes
Jump to navigation
Jump to search
Line 5:
Line 5: − + Line 25:
Line 25: − + + + Line 31:
Line 33: − + Line 65:
Line 67: − + Line 78:
Line 80: − + Line 100:
Line 102: − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + Line 237:
Line 239: − + + + Line 246:
Line 250: + Line 251:
Line 256: +
→Controls
= Controls =
= Controls =
Use the D-Pad/joystick to select the app/directory, up/down can be used for faster scrolling. Press A to launch the app. Navigating directories is supported, press A to enter a directory and press B to leave the current directory. Press Y to activate netloader and press B to deactivate netloader.
Use the D-Pad/joystick to select the app/directory, up/down/ZL/ZR can be used for faster scrolling. Press A to launch the app. Navigating directories is supported, press A to enter a directory and press B to leave the current directory. Press Y to activate netloader and press B to deactivate netloader.
Press the - button to enter Theme Menu. Press X to (un)star the current menu entry.
Press the - button to enter Theme Menu. Press X to (un)star the current menu entry.
Themes can be optionally loaded from SD "/config/nx-hbmenu/themes/". The theme (or the default) can be selected using the Theme Menu via the - button. This uses [https://hyperrealm.github.io/libconfig/libconfig_manual.html libconfig]. Default settings will be used for any settings not specified in the theme (including themeInfo).
Themes can be optionally loaded from SD "/config/nx-hbmenu/themes/". The theme (or the default) can be selected using the Theme Menu via the - button. This uses [https://hyperrealm.github.io/libconfig/libconfig_manual.html libconfig]. Default settings will be used for any settings not specified in the theme (including themeInfo).
The file extension is .cfg. Git-only: .romfs is also supported. This is RomFs. With the [[Setting_up_Development_Environment|toolchain]] setup you can run the following to build a .romfs: <code>build_romfs {input directory} {out name}.romfs</code>. The .romfs (and therefore the input directory) contains: '/theme.cfg', optionally '/icon.jpg' for the menu-entry in Theme Menu, and any assets.
The file extension is .cfg. .romfs is also supported, this is RomFs. With the [[Setting_up_Development_Environment|toolchain]] setup you can run the following to build a .romfs: <code>build_romfs {input directory} {out name}.romfs</code>. The .romfs (and therefore the input directory) contains: '/theme.cfg', optionally '/icon.jpg' for the menu-entry in Theme Menu, and any assets.
Directories or .zip can also be used for themes, which have the same content described above for RomFs. .zip must directly contain the theme data, no directories.
See [[Homebrew Themes]] for a list of themes.
See [[Homebrew Themes]] for a list of themes.
The string used for displaying the buttons/stars can be set with buttonAText, buttonBText, buttonXText, buttonYText, buttonMText, labelStarOnText, and labelStarOffText, but normally these can be left at the defaults. Change the value of the enableWaveBlending field to 1 to enable wave blending.
The string used for displaying the buttons/stars can be set with buttonAText, buttonBText, buttonXText, buttonYText, buttonMText, labelStarOnText, and labelStarOffText, but normally these can be left at the defaults. Change the value of the enableWaveBlending field to 1 to enable wave blending.
There's also borderColor, borderTextColor, and progressBarColor fields which can be set like the other color fields.
There's also borderColor, borderTextColor, and progressBarColor fields which can be set like the other color fields. logoColor can be used to set the RGB color of the logo, the alpha component is loaded from the logo image. highlightGradientEdgeColor is also available.
The color fields are RGBA.
The color fields are RGBA.
};
};
layout={ // git-only
layout={
<object name>={
<object name>={
visible=true;
visible=true;
};
};
assets={ // git-only
assets={
<object name>={
<object name>={
path = "relative_path_in_romfs";
path = "relative_path_in_romfs";
! Used fields (besides 'visible')
! Used fields (besides 'visible')
|-
|-
| logo || Hbmenu logo image. || Yes, Yes || posStart
| logo || Hbmenu logo image. || Yes, yes || posStart
|-
|-
| hbmenuVersion || Hbmenu version text. || Yes, Yes || posStart
| hbmenuVersion || Hbmenu version text. || Yes, yes || posStart
|-
|-
| loaderInfo || Loader info text (displayed next to hbmenuVersion with the defaults).
| loaderInfo || Loader info text (displayed next to hbmenuVersion with the defaults).
When the loader-info string doesn't contain a space, posStart is used directly for the text position, otherwise the right-justified position from posEnd is used.
When the loader-info string doesn't contain a space, posStart is used directly for the text position, otherwise the right-justified position from posEnd is used.
| Yes, Yes || posStart, posEnd
| Yes, yes || posStart, posEnd
|-
|-
| attentionText || Attention text (Applet Mode text). When posType is relative (the default), the base position is the final position used by 'status'. || Yes, Yes || posType, posStart
| attentionText || Attention text (Applet Mode text). When posType is relative (the default), the base position is the final position used by 'status'. || Yes, yes || posType, posStart
|-
|-
| logInfo || Logging info for debug enabled via a build define. || Yes, Yes || posStart
| logInfo || Logging info for debug enabled via a build define. || Yes, yes || posStart
|-
|-
| infoMsg || Text for NoAppsFound_Msg. || Yes, Yes || posStart
| infoMsg || Text for NoAppsFound_Msg. || Yes, yes || posStart
|-
|-
| menuPath || Menu path text. || No, Yes || posStart, size[0]
| menuPath || Menu path text. || No, yes || posStart, size[0]
|-
|-
| menuTypeMsg || Text for the current type of menu (such as "Theme Menu"). Position is right-justified from posStart. || No, Yes || posStart
| menuTypeMsg || Text for the current type of menu (such as "Theme Menu"). Position is right-justified from posStart. || No, yes || posStart
|-
|-
| msgBoxSeparator || Message-box separator. Position is relative to the bottom of the box. || No, No || posStart[1]
| msgBoxSeparator || Message-box separator. Position is relative to the bottom of the box. || No, no || posStart[1]
|-
|-
| msgBoxBottomText || Message-box text displayed at the bottom below the separator. Position is relative to the bottom of the box. || No, No || posStart[1]
| msgBoxBottomText || Message-box text displayed at the bottom below the separator. Position is relative to the bottom of the box. || No, no || posStart[1]
|-
|-
| backgroundImage || Background image, not set with the defaults. Requires assets.background_image to be setup. This is drawn after backgroundColor, the maximum drawn y-pos is the same as backgroundColor (drawing where the waves are located is skipped). Note that this can result in slowdown since sw-rendering is used, especially with an image which covers the entire screen (besides where the waves are displayed). || No, Yes || posStart
| backgroundImage || Background image, not set with the defaults. Requires assets.background_image to be setup. This is drawn after backgroundColor, the maximum drawn y-pos is the same as backgroundColor (drawing where the waves are located is skipped). Note that this can result in slowdown since sw-rendering is used, especially with an image which covers the entire screen (besides where the waves are displayed). || No, yes || posStart
|-
|-
| backWave || Back wave. The height is controlled by size[1], relative to the bottom of the screen. || No, Yes || size[1]
| backWave || Back wave. The height is controlled by size[1], relative to the bottom of the screen. || No, yes || size[1]
|-
|-
| middleWave || Middle wave. The height is controlled by size[1], relative to the bottom of the screen. || No, Yes || size[1]
| middleWave || Middle wave. The height is controlled by size[1], relative to the bottom of the screen. || No, yes || size[1]
|-
|-
| frontWave || Front wave. The height is controlled by size[1], relative to the bottom of the screen. || No, Yes || size[1]
| frontWave || Front wave. The height is controlled by size[1], relative to the bottom of the screen. || No, yes || size[1]
|-
|-
| buttonA || Button A, displayed with the string from theme*.buttonAText. With posType=relative (default is absolute) the position is relative to buttonAText. || No, Yes || posType, posStart
| buttonA || Button A, displayed with the string from theme*.buttonAText. With posType=relative (default is absolute) the position is relative to buttonAText. || No, yes || posType, posStart
|-
|-
| buttonAText || Button A text. posType=true is the same as absolute since the base-pos is 0. || No, Yes || posType, posStart
| buttonAText || Button A text. posType=true is the same as absolute since the base-pos is 0. || No, yes || posType, posStart
|-
|-
| buttonB || Button B, displayed with the string from theme*.buttonBText. With posType=relative the base position is buttonBText. || No, Yes || posType, posStart
| buttonB || Button B, displayed with the string from theme*.buttonBText. With posType=relative the base position is buttonBText. || No, yes || posType, posStart
|-
|-
| buttonBText || Button B text. With posType=relative the base position is buttonA. When buttonA is displayed with non-empty-directory, posStart is used, otherwise posEnd is used (buttonA not displayed). || No, Yes || posType, posStart
| buttonBText || Button B text. With posType=relative the base position is buttonA. When buttonA is displayed with non-empty-directory, posStart is used, otherwise posEnd is used (buttonA not displayed). || No, yes || posType, posStart
|-
|-
| buttonY || Button Y, displayed with the string from theme*.buttonYText. With posType=relative the base position is buttonYText. || No, Yes || posType, posStart
| buttonY || Button Y, displayed with the string from theme*.buttonYText. With posType=relative the base position is buttonYText. || No, yes || posType, posStart
|-
|-
| buttonYText || Button Y text. With posType=relative the base position is buttonB, or if that's not displayed (menu path is in the root directory) the base is buttonA instead. || No, Yes || posType, posStart
| buttonYText || Button Y text. With posType=relative the base position is buttonB, or if that's not displayed (menu path is in the root directory) the base is buttonA instead. || No, yes || posType, posStart
|-
|-
| buttonM || Button '-', displayed with the string from theme*.buttonMText. With posType=relative the base position is buttonMText. || No, Yes || posType, posStart
| buttonM || Button '-', displayed with the string from theme*.buttonMText. With posType=relative the base position is buttonMText. || No, yes || posType, posStart
|-
|-
| buttonMText || Button '-' text. With posType=relative the base position is buttonY. || No, Yes || posType, posStart
| buttonMText || Button '-' text. With posType=relative the base position is buttonY. || No, yes || posType, posStart
|-
|-
| buttonX || Button X, displayed with the string from theme*.buttonXText. With posType=relative the base position is buttonXText. || No, Yes || posType, posStart
| buttonX || Button X, displayed with the string from theme*.buttonXText. With posType=relative the base position is buttonXText. || No, yes || posType, posStart
|-
|-
| buttonXText || Button X text. With posType=relative the base position is buttonM. || No, Yes || posType, posStart
| buttonXText || Button X text. With posType=relative the base position is buttonM. || No, yes || posType, posStart
|-
|-
| networkIcon || Network status icon. With posType=relative the final position from 'status' is used for the base X-coordinate, however posStart[1] is used directly as the Y-coordinate regardless. || No, Yes || posType, posStart
| networkIcon || Network status icon. With posType=relative the final position from 'status' is used for the base X-coordinate, however posStart[1] is used directly as the Y-coordinate regardless. || No, yes || posType, posStart
|-
|-
| batteryCharge || Battery charge text. The position from posStart is right-justified. || No, Yes || posStart
| batteryCharge || Battery charge text. The position from posStart is right-justified. || No, yes || posStart
|-
|-
| batteryIcon || Battery icon. || No, Yes || posStart
| batteryIcon || Battery icon. || No, yes || posStart
|-
|-
| chargingIcon || Battery charging icon. || No, Yes || posStart
| chargingIcon || Battery charging icon. || No, yes || posStart
|-
|-
| status || Text displayed for the time. The position from posStart is right-justified. || No, Yes || posStart
| status || Text displayed for the time. The position from posStart is right-justified. || No, yes || posStart
|-
|-
| temperature || Temperature text. || No, Yes || posStart
| temperature || Temperature text. || No, yes || posStart
|-
|-
| menuList || Menu list. posStart is the absolute position for the first tile. posEnd is the relative position for the next tile, relative to the current tile (outline not included). The size doesn't include the outline. || No, No || posStart, posEnd, size
| menuList || Menu list. posStart is the absolute position for the first tile. posEnd is the relative position for the next tile, relative to the current tile (outline not included). The size doesn't include the outline. || No, no || posStart, posEnd, size
|-
|-
| menuListTiles || posEnd[0] is the the maximum number of tile entries to adjust the currently selected entry index by, for example with HID input for DPad Up/Down. || No, No || posEnd[0]
| menuListTiles || posEnd[0] is the the maximum number of tile entries to adjust the currently selected entry index by, for example with HID input for DPad Up/Down. || No, no || posEnd[0]
|-
|-
| menuListIcon || Menu entry icon. posStart is relative to the current tile entry (see menuList), regardless of posType. || No, No || posStart
| menuListIcon || Menu entry icon. posStart is relative to the current tile entry (see menuList), regardless of posType. size must be >0 and <=256x256, otherwise 256x256 is used. || No, no || posStart, size
|-
|-
| menuListName || Menu entry name text. posStart is relative to the current tile entry (see menuList), regardless of posType. || No, No || posStart, size
| menuListName || Menu entry name text. posStart is relative to the current tile entry (see menuList), regardless of posType. || No, no || posStart, size
|-
|-
| menuActiveEntryIcon || Icon for the currently active menu entry. || No, Yes || posStart
| menuActiveEntryIcon || Icon for the currently active menu entry. size must be >0 and <=256x256, otherwise 256x256 is used. || No, yes || posStart, size
|-
|-
| menuActiveEntryName || Name text for the currently active menu entry. || No, Yes || posStart, size
| menuActiveEntryName || Name text for the currently active menu entry. || No, yes || posStart, size
|-
|-
| menuActiveEntryAuthor || Author text for the currently active menu entry. || No, Yes || posStart
| menuActiveEntryAuthor || Author text for the currently active menu entry. || No, yes || posStart
|-
|-
| menuActiveEntryVersion || Version text for the currently active menu entry. || No, Yes || posStart
| menuActiveEntryVersion || Version text for the currently active menu entry. || No, yes || posStart
|-
|-
|}
|}
The generated menu entry launches the specified app_path where the first passed argument (argv[1] in the launched app) is the absolute filepath for the associated file. See below regarding the icon used for the menu entry. The author and version fields for the menu entry are loaded from app_path, while the name is the filename (unless a directory is being processed, in this case the directory name is used). When {$FILEPATH with extension changed to .nacp} exists, the aforementioned strings will be loaded from there instead.
The generated menu entry launches the specified app_path where the first passed argument (argv[1] in the launched app) is the absolute filepath for the associated file. See below regarding the icon used for the menu entry. The author and version fields for the menu entry are loaded from app_path, while the name is the filename (unless a directory is being processed, in this case the directory name is used). When {$FILEPATH with extension changed to .nacp} exists, the aforementioned strings will be loaded from there instead.
The only optional setting is icon_path. All paths are absolute. Icon will attempted to be loaded from the following: {$FILEPATH with extension changed to .jpg} -> icon_path setting if it exists (target setting -> main file_assoc setting) -> icon from app_path.
The only optional setting is icon_path and app_args. All paths are absolute. Icon will attempted to be loaded from the following: {$FILEPATH with extension changed to .jpg} -> icon_path setting if it exists (target setting -> main file_assoc setting) -> icon from app_path.
If you have targets where file_extension and filename both have the same extension, the filename target should be located before that file_extension target in the cfg. Targets which have both file_extension and filename settings are ignored. Each target must have either a file_extension or filename setting.
If you have targets where file_extension and filename both have the same extension, the filename target should be located before that file_extension target in the cfg. Targets which have both file_extension and filename settings are ignored. Each target must have either a file_extension or filename setting.
app_args specifies the args to pass following argv[0](app-path). This is an array of strings for each argv[N+1]. If a "%f" token is found (only one per array index is handled), it's replaced with the path for the fileassoc. If no "%f" token is specified or app_args is not specified, the fileassoc path is passed to argv[1].
Sample fileassoc file:
Sample fileassoc file:
app_path="/switch/myapp/app.nro";
app_path="/switch/myapp/app.nro";
icon_path="/switch/myapp/myicon.jpg";
icon_path="/switch/myapp/myicon.jpg";
app_args = ["arg1", "arg2", "%f"];
targets=(
targets=(
file_extension=".ext3";
file_extension=".ext3";
icon_path="/switch/myapp/myicon2.jpg";
icon_path="/switch/myapp/myicon2.jpg";
app_args = ["arg1", "arg2", "--path=%f"]; // Optional, overrides fileassoc.app_args.
},
},
{
{