ShellSecBat Vita

ShellSecBat by OperationNT
ShellSecBat by OperationNT
	File:Shellsecbatbyoperationntvita.jpg
General
Author	OperationNT
Type	Plugins
Version	10
License	MIT License
Last Updated	2019/08/18
Links
	Download
	Website
	Source

ShellSecBat is a plugin that merges LastSeconds and Shellbat plugins with some bugfixes and improvements.

What is ShellSecBat?

ShellSecBat is a 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.

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

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

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.

How To Install ShellSecBat?

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").

How To Configure ShellSecBat

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

Changelog

(v10)

Add support for 3.55. All credits goes to nowrep for the offsets!
Fix display issue when a size was beyond 1 TB, thanks to eviltpot for the tests!

(v9)

Add support for devkit and testkit on 3.65. All credits goes to nowrep for the offsets!
Thanks to Exeedy for his validation.

(v8)

Add support for FW 3.67, thanks to victorafs for the tests!

(v7)

Add "xmc0:" partition support which become important for SD2Vita users on FW 3.68. Thanks to BenMitnicK!

WARNING: If you use a custom configuration "ShellSecBat.txt", the "Drives:" section should be updated to include setting for this new partition (between settings for "uma0:" and "grw0:" partitions).

(v6)

Add support for 3.68 retail units. All credit goes to nowrep!

(v5)

Possibility to have year in the date display
Customisable separators for date and drive space decimal displays
Support of "imc0" and "grw0" partitions on drive display
Automatically skip unmounted partitions
Possibility change "free space" with "occupied space"
Customisable key combination to switch drive display

(v4)

Add support for 3.65 retail units and 3.60 devkit units. All credit goes to nowrep!

(v3)

The battery percent (previously fixed at 90%) is now hidden on PlayStation TV.
All other features (date, seconds and drive state) remain available on this model type.

(v2)

You can switch to drive state display (ur0, ux0 and uma0) by maintaining SELECT+L or SELECT+R at least one second.

(v1)

First release of ShellDateSecBat which allow to add date in the status bar.
DO NOT use both "shellsecbat.suprx" and "shelldatesecbat.suprx"!

(v0)

Fusion between ShellBat and LastSeconds plugins (code is based on ShellBat source).
It fixes "12 hours" issue when those 2 plugins were manually combined.

Credits

nowrep for "ShellBat" Shellbat Vita.
theorywrong for "LastSeconds" Lastseconds Vita.

External links

Official Website - https://wololo.net/talk/viewtopic.php?f=116&t=48325
Github - https://github.com/OperationNT414C/ShellSecBat
VitaDB - https://vitadb.rinnegatamante.it/#/info/289