Skip to content

Latest commit

 

History

History
99 lines (59 loc) · 3.96 KB

README.md

File metadata and controls

99 lines (59 loc) · 3.96 KB
Raw

ShellSecBat

Henkaku plugin that status bar displayed content customization.

This is a fusion between "ShellBat" and "LastSeconds" plugins. It also solves "12 hours" format issue when those plugins were manually combined.

Screenshot

Configurated ShellSecBat allows to add the date to the status bar (in addition to the time with seconds and the battery percent).

Screenshot

You can also visualize your drive state (total size and remaining space) by maintaining SELECT button and L or R trigger.

Screenshot

On a PlayStation TV, the useless battery percent is hidden (even if the configuration tries to enable it). All other features (seconds, date and drive state) are still available.

Screenshot

Installation

Add the plugin under *main section in ur0:tai/config.txt or ux0:tai/config.txt:

*main
ux0:tai/shellsecbat.suprx

Please remove any other plugin which impacts the status bar display (like "ShellBat", "ShellDateSecBat" or "LastSeconds").

Configuration

ShellSecBat can be configurated through a "ShellSecBat.txt" file. The file size should not exceed 116 bytes and its content should look like:

Features:11
Time:100/
Drives:11.111111
LeftKey:101
RightKey:201

This configuration sample matches the official default ShellSecBat settings (when there is no found configuration file).

Only the following paths are supported for the configuration file (they will be check in this same order):

  • ux0:/data/ShellSecBat.txt
  • ux0:/tai/ShellSecBat.txt
  • ur0:/tai/ShellSecBat.txt
  • ur0:/plugins/ShellSecBat.txt

The file must follows the following rules:

Features:[Drives display][Battery display]
Time:[Seconds display][Date display][Year display][Date separator]
Drives:[Skip unmounted][Free space display][Space decimal separator][imc0:][ur0:][ux0:][uma0:][xmc0:][grw0:]
LeftKey:[Keys combination for previous drive display]
RightKey:[Keys combination for next drive display]

You should be aware that configuration file reading is very basic (and it could easily fail if there is even the slightest mistake).

Keywords Feature:, Time:, Drives:, LeftKey: and RightKey: are used to find configuration parts. Once a configuration part is found, configuration parameters must directly follow the : character (without any blank character between):

  • Valid configuration part: Features:01
  • Invalid configuration part: Features: 01

For parameters which can be activated (all parameters except keys and separators), 1 means that it is enabled and any other character means that it is disabled.

LeftKey: and RightKey: must be followed by an hexadecimal value which describes the key combination. Hexadecimal flags for each key can be found here (on SceCtrlButtons section):

https://github.com/vitasdk/vita-headers/blob/master/include/psp2/ctrl.h

Additional rules are applied:

  • Keywords can appear in any order in the configuration but parameters must always exactly match what the keyword expects
  • Drives:, LeftKey: and RightKey: won't be parsed if "[Drives display]" is disabled
  • On PlayStation TV, "[Battery display]" is ignored as it will always be disabled

You can simulate ShellSecBat and ShellDateSecBat previous versions (prior to configuration file support) with the following configurations:

  • ShellSecBat V4 behavior: Features:11 Time:100/ Drives:01.011100 LeftKey:101 RightKey:201
  • ShellDateSecBat V4 behavior: Features:11 Time:110/ Drives:01.011100 LeftKey:101 RightKey:201

Credits