HexLauncher Custom Vita: Difference between revisions

HexFlow Custom
HexFlow Custom
General
Author	BlackSheepBoy69
Type	Title Launchers
Version	2.5.0
License	Mixed
Last Updated	2024/11/03
Links
	Download
	Website
	Source

Latest revision as of 00:54, 3 November 2024

HexLauncher Custom, also known as VitaHex Launcher Custom or HexFlow Launcher Unofficial Custom, is a revamp mod for VitaHEX's 3D coverflow style launcher for PS Vita.

VitaHEX's HexFlow Launcher is an application that display and launch your games and homebrews in style. It features a 3D user interface to display your games with their box art and supports many customization options like custom covers, backgrounds, and - in v0.6 and above - one custom category.

When you launch a game/app from HexFlow Launcher, the launcher will close automatically without asking.

User guide

AutoBoot

If you want to auto-launch HexFlow Launcher every time your PS Vita boots up you can use the AutoBoot plugin by Rinnegatamante.

Once it's installed and you restart your Vita, you can edit the file that should be there after restart: ux0:data/AutoBoot/boot.cfg.

Inside, put the text "HXLC00001" without quotes

Download Covers and Backgrounds

In v0.3 and above, covers can be downloaded automatically from the settings menu (Start button).

You can also download covers and backgrounds manually here. Thanks to astuermer for creating the original cover archive used in v0.9.1 and below, and big thanks to jimbob4000 for maintaining the current cover archive.

Custom Covers

Place your custom covers in ux0:/data/HexFlow/COVERS/PSVITA/.

Cover images must be in png format and the file name must match the App ID or the App Name of each app (recommended resolution 256x256px).

Sample vita cover image.

Custom Background

Place your Background.png or Background.jpg image in ux0:/data/HexFlow/ (recomended resolution 1280x720px or less).

Some custom backgrounds are available here. In v0.9 and above, these sample custom backgrounds are included by default.

If RetroFlow is enabled, special backgrounds for RetroFlow entries can be downloaded individually from the Triangle menu and can be found in ux0:/data/RetroFlow/BACKGROUNDS/.

Custom Category

In v0.6 and above, take the applist.dat file in ux0:data/HexFlow/ and rename it to customsort.dat. This will generate a 5th category "Custom" and you can put what games you want or reorder it within VitaShell, or on your PC in a unix-compatible text editor such as gVim Easy.

Windows notepad won't work.

Custom Music

Place your Music.ogg or Music.mp3 file in ux0:data/HexFlow/.

Music will play automaticaly when the "Sounds" option is enabled.

Notes

Subfolders and psp categories plugin are not supported.

Controls

D-Pad/Left Analog or Touchscreen - Navigate your library

R/L - Skip 5 items

Select+R/L - Skip by alphabet

Cross - Select/Launch game/app

Square - Change Category

Triangle - Game Details

Circle - Change View/Cancel

Start - Settings menu

D-Pad Up/Down - Access SwitchView UI menu

In v1.0 and above, D-Pad Up/Down can either be used to access SwitchView UI menu, or to change category if either of these options are enabled in the Settings menu.

Screenshots

Changelog

v2.5 2024/11/03

NEW
- CrossbarView!! (enable in settings: Allow 2D Views)
- Loading screen. Because this app has rolling cache, you'll only really see it when many entries are added to cache.
IMPROVEMENTS
- 'Download Snap' is now 'Download Background' and is now translated

v2.4.1 2024/10/14

IMPROVEMENTS

'Download Covers by Category' progress message is now translated. Found out why it wasn't working before: Because of an invisible symbol at the start of some translation files. More info here (link).
Minor code cleanup.

BUGFIXES

Fixed where theme color 'Pink' would display as theme color 'cover not found'

index.lua is the source code. View code differences between v2.4.0 and v2.4.1 here (link).

v2.4.0 2024/10/13

Quick overview: RetroFlow (enable in settings), SwitchView/GridView (enable in settings), JIT rolling cache, 8 backgrounds, 20 languages. Relies on Adrenaline Bubble Manager for PSP/PS1 game launching.

NEW

Added 10 new languages (20 total). Now supports EVERY language that the vita supports. Note: Auto-sets language on startup. The 'change language' setting is just for bug-testing now.
Each language now has a little flag
Added a cog icon for the settings menu. You'll see why in a later version. For now I just really wanted to get these old pull requests merged (sorry for taking so long!) and then go back to testing Adrenaline Launcher/Collections/XMB in the non-public version

BUGFIXES

Very minor bugfix related to app title renaming (prevents an esoteric rename that prevented app launches unless you deleted cache)
Very minor bugfix related to app title reading (now sanitizes invisible 'control' characters)
Removed several unnecesary local variables related to setting menu spacing not needed now due to better translations, such as 'Allow view #5/#6' >>>> 'Allow 2D Views'

index.lua is the source code. View code differences between v2.3.1 and v2.4 here (link).

v2.3.1 2024/01/18

(v2.3.1) Quick overview: RetroFlow (enable in settings), SwitchView/GridView (enable in settings), JIT rolling cache, 8 backgrounds, 10 languages. Relies on Adrenaline Bubble Manager for PSP/PS1 game launching.

NEW:

Added theme color 'pink' from YoDwarf's fork, here (link).
Language will now autodetect every time the app starts up (but can no longer be manually set) to make sure that the below bugfix worked. May revert in a later version to increase startup speed. If a compatible translation file isn't found, it'll default to English.

BUGFIXES:

Fixed (hopefully) a crash related to upgrading from a version below 2.0 (such as v0.5) up to the latest version, which seemed to cause an issue related to language string format: [string"?"]:597: bad argument # 2 to 'format' (number expected, got nil)

index.lua is the source code. View code differences between v2.3.0 and v2.3.1 here (link).

v2.3 2023/11/06

(v2.2) Quick overview: RetroFlow (enable in settings), SwitchView/GridView (enable in settings), JIT rolling cache, 8 backgrounds, 10 languages.

IMPROVEMENTS:

Minor code cleanup. May improve startup times when the option "RetroFlow: ON" is enabled.
Grid View: Tightened the Y-axis border on categories with 12 or less entries.

BUGFIXES:

Fixed where double-replaying a game would buck off the least-recently replayed game from the 'recently played' category.
Fixed where "RetroFlow: ON" would make it so the override animations wouldn't play in 'recently played' and 'custom' categories.
Grid View: Fixed the very tiny jump that occured when using the touchscreen to go down from the first row.
Grid View: Fixed a big jump that occurred when using analog sticks and touchscreen at the same time.
Grid View: Fixed where going negative out of bounds in categories with 12 or less entries would move the camera when it shouldn't.

A few improvements and bugfixes (that are now considered stable) imported from the experimental nonpublic version v3.0 which may release very soon with support for Adrenaline Launcher as well as many cool upgrades still in bugtesting. Note: unlike RetroFlow, this app v2.3 is still using Adrenaline Manager for PSP/PS1 for its stability - though this app does support RetroArch for PS1 (if "RetroFlow: ON" is enabled) as well, just like RetroFlow does. All other categories will launch direct with the big advantage that you will never have to refresh cache after the first startup due to rolling cache.

index.lua is the source code. View what has changed in the source code since last version here (link).

v2.2 2023/06/08

(v2.2) Quick overview: RetroFlow (enable in settings), SwitchView/GridView (enable in settings), JIT rolling cache, 8 backgrounds, 10 languages.

NEW:

"Utilities" section in the start menu to access Photo Album, Browser, Trophies, etc.
Small files (such as retro games from RetroFlow) will now display file sizes in Kilobytes (Kb) if they're too small to be measured in Megabytes (Mb).
Swap X/O buttons is now automatic.

BUGFIXES:

Fixed crash: "1438: error opening ux0:/app/PCSE00034/sce_sys/param.sfo" when you had a corrupt app installed.
Fixed where covers had issues downloading from the start menu.
Fixed the 3D model for N64 games being off-center in the triangle menu.
Fixed a buggy message when trying to download a snap with Custom Backgrounds: OFF
For Adrenaline Manager PSP/PS1 games: 1: No longer displays duplicate scanned ID. 2: Now shows proper game size.

IMPROVEMENTS:

Editted the "about"/"more information" section to be more clear about RetroFlow and adding your own custom backgrounds/music.

If you have issues or improvement ideas, please let me know. I'm currently working on to release the final update and it will be a big update. It will be a massive overhaul for the "custom category" which right now you only get 1 and it's not very set up to have RetroFlow games in it right now. Also to fix the minor audio pop, add the option for "Adrenaline Launcher", and possibly to add the option to have the last 6 categories RetroFlow has that this app doesn't (PS Mobile, SCUMMVM, MAME, MAME2003+, FBA, NeoGeo) which would slow loading times a tiny bit. Any other ideas please let me know.

v2.1 2023/05/13

(v2.1) Quick overview: RetroFlow (enable in settings), SwitchView/GridView (enable in settings), JIT rolling cache, 8 backgrounds, 10 languages

Added X/O Button swap option for Japanese users, credit to yzzyx-network.
Added a pretty basic language auto-detector. If it detects Japanese the first time you boot up HexFlow Custom, it will set "swap X/O" to "ON".
Fixed a bug where the app may crash when using Grid View, referencing an unused image.
Fixed a bug where it'd lag the first launch after resetting "Recently Played: ON/OFF".
Fixed the weird flicker that would occur sometimes when exiting triangle menu.
Fixed a glitch in Grid View where if you were in a category with 4+ rows with the camera bottomed out and you were currently situated in the 2nd to last row and pressed right, it would wrongly refocus the camera to the middle.
Fixed where in the triangle menu, it would display RetroFlow entries as "homebrew". Also made it so a PS1 Retroarch game will now be labelled respectively.
Cleaned up a lot of the code comments from v2.0.

This was originally going to be a bigger update and take longer (with features such as more languages and implementing "collections" similar to actual RetroFlow), but this update has been hurried because of a really cool pull request from user "yzzyx-network" as well as the kind of important bugfixes for Grid View.

v2.0 2023/05/09

(v2.0) THE BIG RETROFLOW UPDATE!

Quick Overview: RetroFlow (enable in settings), SwitchView/GridView, JIT rolling cache, 8 backgrounds, 10 languages

Finally added setting: RetroFlow ON/OFF!!! Has all the categories of RetroFlow 6.0 except: PSM, ScummVM, MAME/MAME+, NeoGeo, and FBA... However please note it DOES support several "newer" RetroFlow categories: RetroArch PS1, Pico-8, Dreamcast. Supports PS1/PSP without RetroFlow (Adrenaline Manager) but doesn't support PSP Categories Lite (yet).

It will read from the data folders created by RetroFlow, but it won't create or delete any folders or files except during cover downloads. If this is your first time using RetroFlow, it's recommended to install the current latest version of RetroFlow, run it at least once, and follow its installation instructions. This app uses Adrenaline Manager instead of RetroFlow's Adrenaline Launcher because many people have issues with Adrenaline Launcher.

Cache will magically always stay up to date due to JIT Switch Generation ("Rolling Cache") This is probably the main reason to use this app over RetroFlow.

Fixed a major bug from v1.2/v1.2.1 where sometimes if rolling cache activated, it would clear cache instead of updating a line... You will know you had the issue if the "writing to cache" screen showed up every time - it's not supposed to. Hopefully fixed in this version. The "writing to cache screen" should only show up when you install a new app! If you had the bug, startup should now be much faster. It's ~3.9 seconds with 500 games but if you enable RetroFlow, it adds ~2 seconds.

Finally released Grid View, available from the start menu with "Allow View #5/#6", because it has finally been optimized enough that it doesn't cause massive lag.

"Loose match" RetroFlow cover downloads... A lot of people really wanted this because of how strict the RetroFlow naming conventions are. Example: you can download a cover for a game called just "Super Metroid"... it will default to the USA cover.

Upgraded cover downloads by start menu a lot: skips entryes that already have covers. Added a "Screen.waitVblankStart()" so that you can see briefly see what covers are being skipped. Works for all categories now including homebrews that have a vita-style cover (you should override them if so). Made download synchronous instead of asynchronous: Seems much faster. Mass cover downloads for PSP/PS1 will now use the ID scanner, as is done in triangle menu. Fixed where it wouldn't error out for "no wifi".

Bulletproofed cur_quick_dir, a variable used for overrides and everywhere that the code System.doesFileExist(...) used to be (cur_quick_dir is much faster but less stable).

Drastically bulletproofed the function for increasing and decreasing category (ie: for when you press square). It will now properly hide an existing but empty CUSTOM category.

Added a new style for "Category Button: Up/Down"

Fixed N64 spacing in flat view (experimental)... added smoothness to zoomin view and left view. Credit to Axce for the idea but his code was not used. Currently experimenting with the best way to add smoothness to views other than zoomin/left view.

CUSTOM category can be used similar to "collections" in RetroFlow, ex: to hold all your "utility"-type apps. However, it needs upgraded to support RetroFlow entries... the upgrade is currently in bugtesting. When done, you'll be able to add stuff to CUSTOM category via the triangle menu.

Fixed where if it was the first time ever booting up, overrides wouldn't work on the first try.

Also includes the minor bugfix from v1.2.1 where some categories might not show up right first time ever booting up.

Added a new button at the bottom of the start menu "Exit", as a kind of placeholder: it'll be replaced by "Utilities" or "System Apps" when applicable.

The actual RetroFlow app might not register covers downloaded from this app if you have startup scan OFF in actual RetroFlow. Ones downloaded in RetroFlow will always show up here everytime due to rolling cache.

There is a bug relating to RetroFlow and "Return to Last-Played Game"... if you have 2 Retro games with the same filenames in DIFFERENT categories, it may pick the wrong one if the last played category was "All"/"CUSTOM"

If you were using an experimental version, file "ux0/data/HexFlow/debugfile.dat" can be deleted.

Changed app title to "HexFlow Custom". If the old title still remains, it may have registered as a "rename". You can reset it by scrolling to HexFlow Custom... pressing triangle... selecting "rename"... and setting it to blank which will reset the title.

Added more bulletproofing to the code Category_Plus(), Category_Minus(), and categoryButton; where you couldn't change category if you hacked "categoryButton" in config.dat to be an invalid value and where the first time you hit the category button, it wouldn't register if you hacked "showCat" in config.dat to have an invalid value (for forward compatability).

(Hopefully) fixed where a fresh install would lag for the first launch if Recently Played ON.

Minor bulletproofing/improvement: Only app folders with 9 characters imported, removes duplicates or manually backed-up / renamed folders.

Upgraded Italian translations, credit DaRk_ViVi

New bugs:

When you exit the triangle menu, the modbox will slightly glitch out for about 1/60th of a second or less in certain categories. You will easily miss it even if you're looking for it.

If you have 2 RetroFlow entries with the same base file name, then "return to last played", the "recently played" category, and the "custom" category might display the wrong one. For this reason, the "custom" category doesn't easily support RetroFlow entries. It will require a huge overhaul to make it work correctly The "overhaul" also allows this app to use "Collections" - one of the really great new features of actual RetroFlow 6.0... This "overhaul" is already done but is in bugtesting currently.

v1.2.2 2023/04/17

(v1.2.2) Fixed a newly-discovered major bug caused by a minor typo where sometimes if rolling cache activated, it would clear cache instead of updating a line. This version should be pretty rock solid!

v1.2.2 2023/04/03

(v1.2.1) Fixed where if this was your first time installing the app, the PS1/PSP categories may have been hidden; they should show up now (unless they're empty and you go in start menu and put "Hide Empty Categories: ON").

Note: This app uses "Adrenaline Manager" for PS1/PSP because it's a lot more stable than RetroFlow's "Adrenaline Launcher"... all bubbles made in "Adrenaline Manager" will be automatically put into their proper categories - PSP or PS1 - and can download covers regardless of their file names or ID's (like RetroFlow v5.0 and above).

v1.2 2023/04/02

(v1.2) Half a hotfix release, half a proper release; several new features and bugfixes.

Boots up in ~3.7 seconds with 500 games after first boot. JIT switch generation ("rolling cache") keeps cache always up-to-date instantly. 10 Languages.
Added "Recently Played ON/OFF" setting. TURNING IT OFF WILL CLEAR YOUR RECENTLY PLAYED DATA UNLESS STARTUP CATEGORY "Return to last played game" IS ENABLED. The first time you launch a game with "recently played" enabled, it will lag for a second. Not sure why. Doesn't happen for 2nd+ launches.
Simplified the reading/writing cache code, fixed rolling cache error ["String"?"]:1041:Attempt to call global 'FileConcat'(a nile value)"
Covers can now be downloaded for PSP games (and PS1 games) regardless of their name or ID!!!
Fixed a visual glitch when using "return to last played game" in SwitchView mode.
Moved footer bar slightly, to look more like HexFlow Launcher Official. Made start menu slightly more stylish.
Commented out ~100 lines of code not necessary anymore due to rolling cache. "Cache has been updated" removed from cover download message.
Prioritized CPU buff (faster startup).
Medium-sized code cleanup and replaced several System.doesFileExist() with cur_quick_dir[] (faster startup, faster overrides)
IF YOU WERE USING AN EXPERIMENTAL VERSION: ux0:data/HexFlow/debugfile.dat is no longer necessary... you can delete it.
"applistReadTime" (in start menu>more information) now includes time it took to write to cache (if applicable).
Combined "Music ON/OFF" and "Music: Loop ON/OFF" into one setting because it looks better, especially if "shuffle" is added.
"Music: Loop ON/OFF" can only be set if music exists.
Added credit to fwannmacher in credits (start menu>more information).

v1.1 2023/03/25

(v1.1) Roughly the same startup time as the previous version, but no more refreshing cache, even for hundreds of apps!!!!!

This is an intermediary release. Still working out an annoying GPU crash for the RetroFlow integration and the lag caused by grid view before either of those 2 features get released. It's just that someone requested what's stable to be released.

Removed the "Refresh Cache" and any settings related to startup scan.
New function switch_generator()... I worked very hard on it and it improves the app a LOT.
- 1: It reads the ENTIRE app folder almost instantly. This is better than Vita Launcher (which just reads app.db) because this should be able to display anything that couldn't get added to app.db
- 2: It almost instantly checks for any new covers for every app on startup.
- 3: Slightly faster overrides and cover downloads.
- 4: It improves startup time slightly.
- 5: In the unreleased version, it has been harnessed to instantly load all the RetroFlow ROM's and their overrides/renames/covers.
Reformatted the font files (credit RetroFlow) and optimized image metadata to reduce startup times.
Cleaned up a the code a little bit. Ex: in cache writer.
New Startup Category "Return to Last Played Game/Category" (Credit fwannmacher).
You can now tap in SwitchView.
You can now also use analog sticks or tapping to access the bottom menu in SwitchView
Upgraded the secret select+L/R jump-by-alphabet feature to be more like RetroFlow's (skip numbers, always go to first-of-a-kind).
Fixed an extremely rare crash related to select+L
Minor bugfix for shadows in SwitchView.
Now using Rinnegatamante's app title bugfix. Should fix Invictaz's issue regarding an app with a corrupt apptitle.

Downgrades:

Removed the Language 10 - Chinese - temporarily since some letters aren't displaying right. Will have to import the fix from RetroFlow. The translation file is up-to-date though.
Removed 3 "less popular" backgrounds - Wood 2, Marble, and Playstation Pattern 2.

v1.0.1-hotfix 2022/09/06

(v1.0.1) Still has all of the features of v1.0.0, ex: SwitchView UI integration, instant overrides, and cy33hc/copyicons integration.

Fixed where some overrides wouldn't save to overrides.dat,
Fixed where you sometimes have to click "download cover" twice for a PS1 game due to a value not being cleared.
Fixed where overriding to PS1 sometimes caused a minor visual bug.
New feature and/or bugfix: downloaded single covers now show up ASAP instead of showing blank temporarily.

Release notes.

Credits

Credits (Revamp Mod):

Programming - BlackSheepBoy69 and one or more coders who wish to remain anonymous.

Special Thanks:

Inspiration + various help from Team RetroFlow.
Users who enjoy HexFlow Launcher, HexLauncher Custom, and Retroflow, who submit feature requests to this/those projects (which I do watch), and occasionally code. Thank you.

Credits (General):

Programming/UI - Sakis RG.
Developed with Lua Player Plus by Rinnegatamante.

Special Thanks:

Creckeryop.
andiweli (HEXFlow Covers database) (v0.9.1 and below).
jimbob4000 (RetroFlow Covers database) (v1.0 and above).

Translations:

French - @chronoss.
German - @stuermerandreas.
Spanish - @kodyna91.
Italian - @TheheroGAC.
Russian - @_novff.
Swedish - @Spoxnus86.
Portuguese - @nighto (Retroflow).
Japanese - @iGlitch (Retroflow).
Chinese - @acd13141 (Retroflow).
Polish - @SK00RUPA (Retroflow).

Google Translate was used for HexFlow Launcher Unofficial Custom translations that weren't found on HexFlow Launcher and Retroflow. Retroflow's oddly formatted translation files have been standardized.

External links

@@ Line 1: / Line 1: @@
-{{#seo:
-|title=Vita Homebrew Apps (Title Launchers) - GameBrew
-|title_mode=append
-|image=vitahexlaunchercustom.jpg
-|image_alt=VitaHex Launcher Custom
-}}
 {{Infobox Vita Homebrews
-|title=VitaHex Launcher Custom
+|title=HexFlow Custom
-|image=vitahexlaunchercustom.jpg
+|image=vitahexlaunchercustom2.png
 |description=VitaHex Launcher Custom unofficial version.
 |author=BlackSheepBoy69
-|lastupdated=2022/09/06
+|lastupdated=2024/11/03
 |type=Title Launchers
-|version=1.0.1
+|version=2.5.0
 |license=Mixed
 |download=https://dlhb.gamebrew.org/vitahomebrews/vitahexlaunchercustom.7z
-|website=https://www.reddit.com/r/vitahacks/comments/u61nmt/release_vitahex_launcher_custom_v09_unofficial/
+|website=https://github.com/BlackSheepBoy69/HexFlow-Launcher-Unofficial-Custom/
 |source=https://github.com/BlackSheepBoy69/HexFlow-Launcher-Unofficial-Custom/
 }}
-'''VitaHex Launcher Custom''' is a revamp mod for [[Hexflow Launcher Vita
+{{#seo:
-|VitaHEX's 3D coverflow style]] launcher for PS Vita.
+|title=Vita Homebrew Apps (Title Launchers) - GameBrew
+|title_mode=append
+|image=vitahexlaunchercustom2.png
+|image_alt=HexFlow Custom
+}}
+HexLauncher Custom, also known as VitaHex Launcher Custom or HexFlow Launcher Unofficial Custom, is a revamp mod for [[HEXFlow Launcher Vita|VitaHEX's 3D coverflow style launcher]] for PS Vita.
+VitaHEX's HexFlow Launcher is an application that display and launch your games and homebrews in style. It features a 3D user interface to display your games with their box art and supports many customization options like custom covers, backgrounds, and - in v0.6 and above - one custom category.
+When you launch a game/app from HexFlow Launcher, the launcher will close automatically without asking.
-==What is VitaHex Launcher Custom?==
+==User guide==
-Display and launch your games and homebrews in style.
+===AutoBoot===
+If you want to auto-launch HexFlow Launcher every time your PS Vita boots up you can use the [[AutoBoot Vita|AutoBoot]] plugin by Rinnegatamante.
-'''HexFlow Launcher''' features a 3d user interface to display your games with their box art and supports many customization options like custom covers, backgrounds, and - in v0.6 and above - one custom category.
+Once it's installed and you restart your Vita, you can edit the file that should be there after restart: ux0:data/AutoBoot/boot.cfg.
-Launching a game/app from '''HexFlow Launcher''' will close the launcher automaticaly without asking.
+Inside, put the text "HXLC00001" without quotes
-=== Important ===
+===Download Covers and Backgrounds===
-For PSP bubbles generated by Adrenaline Bubbles Manager you must set the value of '''BubbleID''' to '''TitleID''' in the settings menu of ABM tool. In v0.9 and above, PS1 Bubble ID doesn't matter because it's scanned in binary during the startup.
+In v0.3 and above, covers can be downloaded automatically from the settings menu (Start button).
-'''Subfolders and psp categories plugin are not supported'''.
+You can also download covers and backgrounds manually [https://github.com/jimbob4000/hexflow-covers/ here]. Thanks to astuermer for creating [https://github.com/andiweli/hexflow-covers the original cover archive] used in v0.9.1 and below, and big thanks to jimbob4000 for maintaining [https://github.com/jimbob4000/hexflow-covers/ the current cover archive].
-== AutoBoot ==
+===Custom Covers===
-If you want to auto-launch '''HexFlow Launcher''' every time your PS Vita boots up you can use the [[Autoboot Vita]] plugin by Rinnegatamante.
+Place your custom covers in ux0:/data/HexFlow/COVERS/PSVITA/.
-== Controls ==
+Cover images must be in png format and the file name must match the App ID or the App Name of each app (recommended resolution 256x256px).
-Navigate your library using the '''DPad''' or the '''Left Stick''' or with the '''Touch Screen'''.
-'''R/L triggers''': Skip 5 items
+[https://live.staticflickr.com/7176/6885249717_738e8ee187_n.jpg Sample vita cover image].
-'''Select+R/L triggers''': Skip by alphabet
+===Custom Background===
+Place your Background.png or Background.jpg image in ux0:/data/HexFlow/ (recomended resolution 1280x720px or less).
-'''Cross''': Select/Launch game/app
+Some custom backgrounds are available [https://github.com/andiweli/hexflow-covers/tree/main/Backgrounds here]. In v0.9 and above, these sample custom backgrounds are included by default.
-'''Square''': Change Category
+If RetroFlow is enabled, special backgrounds for RetroFlow entries can be downloaded individually from the Triangle menu and can be found in ux0:/data/RetroFlow/BACKGROUNDS/.
-'''Triangle''': Game Details
+===Custom Category===
+In v0.6 and above, take the applist.dat file in ux0:data/HexFlow/ and rename it to customsort.dat. This will generate a 5th category "Custom" and you can put what games you want or reorder it within [[VitaShell]], or on your PC in a unix-compatible text editor such as gVim Easy.
-'''Circle''': Change View/Cancel
+Windows notepad won't work.
-'''Start''': Settings menu
+===Custom Music===
+Place your Music.ogg or Music.mp3 file in ux0:data/HexFlow/.
-'''DPad Up/Down''': Access SwitchView UI menu
+Music will play automaticaly when the "Sounds" option is enabled.
-'''In v1.0 and above, DPad Up/Down can either be used to access SwitchView UI menu, or to change category if either of these options are enabled in the Settings menu'''
+===Notes===
+Subfolders and psp categories plugin are not supported.
-== Custom Covers ==
+==Controls==
-Place your custom covers in &quot;''ux0:/data/HexFlow/COVERS/PSVITA/''&quot;
+D-Pad/Left Analog or Touchscreen - Navigate your library
-Cover images must be in '''png''' format and the file name must match the '''App ID''' or the '''App Name''' of each app (recomended resolution 256x256px). In v0.9 and above, games in the PS1 category can have cover png's named to match the '''App ID''', or the '''App Name''', or the '''PSX Serial''' as found in the triangle menu. [https://live.staticflickr.com/7176/6885249717_738e8ee187_n.jpg Sample vita cover image]
+R/L - Skip 5 items
-=== Download Covers and Backgrounds ===
+Select+R/L - Skip by alphabet
-In v0.3 and above, covers can be downloaded automatically from the settings menu (Start button). You can also download covers and backgrounds manually from the link below. A big thanks to '''astuermer''' for his contribution.
-*<s>https://github.com/andiweli/hexflow-covers</s> (v0.9.1 and below)
+Cross - Select/Launch game/app
-*https://github.com/jimbob4000/hexflow-covers/ (v1.0 and above)
-=== Custom Background ===
+Square - Change Category
-Place your '''Background.png''' or '''Background.jpg''' image in &quot;''ux0:/data/HexFlow/''&quot; (recomended resolution 1280x720px or less). Some custom backgrounds are available [https://github.com/andiweli/hexflow-covers/tree/main/Backgrounds HERE]. In v0.9 and above, these sample custom backgrounds are included by default.
-=== Custom Category ===
+Triangle - Game Details
-In v0.6 and above, take the '''applist.dat''' file in &quot;''ux0:data/HexFlow/''&quot; and rename it to '''customsort.dat'''. This will generate a 5th category - &quot;Custom&quot; - and you can put what games you want or reorder it within Vitashell, or on your PC in a unix-compatible text editor such as gVim Easy. Windows notepad won't work.
-=== Custom Music ===
+Circle - Change View/Cancel
-Place your '''Music.ogg''' or '''Music.mp3''' file in &quot;''ux0:data/HexFlow/''&quot; (music will play automaticaly when the &quot;Sounds&quot; option is enabled)
+Start - Settings menu
-==Media==
-'''HEX-Flow Launcher 0.3 - PS Vita Preview (VitaHEX Games)'''<br>
+D-Pad Up/Down - Access SwitchView UI menu
-<youtube>WDBgaAvhurY</youtube>
+In v1.0 and above, D-Pad Up/Down can either be used to access [[SwitchView UI Vita|SwitchView UI]] menu, or to change category if either of these options are enabled in the Settings menu.
 ==Screenshots==
-https://dlhb.gamebrew.org/vitahomebrews/vitahexlaunchercustom-01.jpg
+https://dlhb.gamebrew.org/vitahomebrews/vitahexlaunchercustom3.png
-https://dlhb.gamebrew.org/vitahomebrews/vitahexlaunchercustom-02.jpg
+https://dlhb.gamebrew.org/vitahomebrews/vitahexlaunchercustom1.png
+https://dlhb.gamebrew.org/vitahomebrews/vitahexlaunchercustom2.png
+==Changelog==
+'''v2.5 2024/11/03'''<br />
+* NEW
+** CrossbarView!! (enable in settings: Allow 2D Views)
+** Loading screen. Because this app has rolling cache, you'll only really see it when many entries are added to cache.
+* IMPROVEMENTS
+** 'Download Snap' is now 'Download Background' and is now translated
-== User Feature Requests ==
+'''v2.4.1 2024/10/14'''
-Feature requests and &quot;issues&quot; posted on Retroflow &amp; HexFlow Launcher are considered for being added to this list. Mostly no feature is impossible because there are experienced coders involved in the HexLauncher Custom project, but this entire project is just for me (only posted publicly out of the &quot;generousity of my heart&quot;) so only features that I like will get added.
-If you'd like to try coding up a feature (which may be faster than having me do it), then take your editted sourcecode and name it to &quot;index.lua&quot; and put it in like this: ux0:/app/HXLC00001/index.lua
+'''IMPROVEMENTS'''
-...Or put it directly into the vpk (openable with Winrar) to replace the index.lua there.
+* 'Download Covers by Category' progress message is now translated. Found out why it wasn't working before: Because of an invisible symbol at the start of some translation files. More info [https://stackoverflow.com/questions/33510700/excel-files-with-byte-order-mark-for-utf-8-causing-errors here (link).]
+* Minor code cleanup.
-The great feature of lua files is they can open in a simple text editor such as Notepad, and you don't need VitaSDK.
+'''BUGFIXES'''
-If your version works out, send it here as a github &quot;pull request&quot; and I'll see about adding your feature to this project so it can stay as the app updates. Otherwise you'll basicly have to wait for next release and hope I added a feature you want.
+* Fixed where theme color 'Pink' would display as theme color 'cover not found'
-== Planned Features for Upcoming Updates ==
+index.lua is the source code. View code differences between v2.4.0 and v2.4.1 [https://github.com/BlackSheepBoy69/HexFlow-Launcher-Unofficial-Custom/commit/355216679225f3f2cab65317a46edf7749088ec7 here (link).]
-*Rolling cache (costs ~0.5s startup time) ✔️Done, coming in v1.1
-*Optimized Fonts for even faster startup and even better performance. (saves ~0.5s startup time) ✔️Done, coming in v1.1
-*RetroFlow ✔️Done, coming in v1.1
-*RetroFlow: option to combine &quot;PCE-type categories&quot; - PCE, PCECD, TG16, TGCD ✔️Done, coming in v1.1
-*RetroFlow: option to combine &quot;Gameboy-type categories&quot; - GBA, GBC, GB ✔️Done, coming in v1.1
-*RetroFlow: option to combine &quot;Arcade Machine-type categories&quot; - FBA, MAME2000, MAME2003, NeoGeo ✔️Done, coming in v1.1
-*Categories: Dreamcast (&quot;Flycast&quot;)✔️Done, coming in v1.1
-*Categories: Nintendo DS ✔️Done, hidden feature in upcoming v1.1
-*Easier way to rename games
-*RetroFlow: &quot;MD5/CDC32 ROM scraping&quot; so you don't have to rename ROM's?
-*RetroFlow: change ROM directory - as in Retroflow v4.0.0+ (low priority)
-*Ability to use Adrenaline Bubble Manager, Adrenaline Launcher, and Retroarch for PSP/PS1 where possible, all at once if you so feel like it. ✔️ framework for this - &quot;pspemu_translation_table&quot; is included in v0.9+ but Adrenaline Launcher capabilities are not added yet, only this framework.
-*Categories: Android (&quot;YoYo Loader&quot;)
-*Categories: RPGMaker XP (&quot;MKXP&quot;) ASAP.
-*Categories: RPGMaker 2000/2003 (&quot;EasyRPG&quot; - low priority)
-*Categories: Pico8 (low priority, easy to program)
-*Categories: ScummVM (low priority)
-*Categories: Playstation Mobile (low priority)
-*Categories: remote play category (low priority)
-*Categories: recently played
-*Categories: most played (maybe)
-*Categories: favorites
-*Either new setting &quot;Jump to last played game on startup: ON/OFF&quot; or new startup category: &quot;ALL - *JUMP TO LAST PLAYED*&quot; ✔️Done, trying to decide which of the two ways it should be implemented. This will probably also be released alongside &quot;Recently Played&quot;.
-*&quot;Pro Triangle Menu&quot;: add all these settings to the triangle menu: Open a game's trophies (via trophy app URI call), Open a game's manual (not sure how to code this), send game save data to a PSTV, set individual app overclock via PSVShell and the &quot;L...&quot; overclocking program profile writer. AKA the ability to launch an app at 500 overclock through triangle menu. ✔️Only the overclocker is done but the others are planned to come with it if possible. Coming to the public release when Retroflow integration is added to public HexLauncher Custom release
-*Select opens up a sidebar similar to Vitashell's triangle menu, it will have &quot;search&quot; and little checkboxes to only show games of a certain genre ex: &quot;Puzzles&quot; and &quot;Mario&quot;, with &quot;Mario Picross&quot; being in both. Inspired by &quot;Dig - Emulator Front-End&quot; for android.
-*Absolute full translation for everything, including msg boxes (like retroflow)(easy but low priority)
-*RetroFlow: option to automatically colorize Game Boy (non-color) games that were officially retroactively given color when played on a GameBoy Color such as Super Mario Land, Super Mario Land 2, QIX, Hyper Lode Runner, DrMario, Metroid 2, etc)(low priority and this will be hard to program).
-*Extra smooth cover size adjusting, like the XBox &quot;Aurora&quot; coverflow app, you can see it at about 9 minute, 15 seconds into this video: https://www.youtube.com/watch?v=Kqvruf8q3J0 ✔️ There is a janky unreleased implementation of this, but it will probably be scrapped in favor of stealing the smooth scroll code from WiiFlow.
-*Launchbox view, TN-X view, Wii view, and &quot;List View&quot; with a list of text of game names and maybe 1 cover?
-*&quot;Advanced options&quot; button at the bottom so start menu can fit more settings? ...or just a RetroFlow style multi-tier settings menu?
-*Setting for &quot;livearea replacement mode: enables a loading screen image similar to the Enso &quot;Molecule&quot; image. Maybe have it set up autoboot for you, too? This will only be added if &quot;advanced options&quot; button is added. (easy)
-*Setting to cycle and/or shuffle background musics as in RetroFlow v4.0.1+
-*Setting to change the category text color (on the top left of the screen) for when you're using a bright background (low priority)
-*Setting to let you use the touchscreen to touch the &quot;X Launch&quot; on the bottom right of the screen to launch a game starting 1 second after you start HexLauncher Custom. (low priority). Any other touch features probably won't be added because when the screen gets wet it touches random places for you and also because I'm a lazy.
-*Cover downloads for homebrew, ex: CoolFiverIsABabe's homebrew cover archive. They might have to override to Vita if a cover is found, in order to look right.
-*The ability to quickly add an app to &quot;Custom&quot; (through triangle menu?). High priority if &quot;rolling refresh&quot; is added.
-*❌video/media category. Seems like an over-reach, just use MVPlayer.
-*❌uninstalling or otherwise altering any games (such as in OneMenu). It might mess up someone's Vita.
-== Known bugs ==
+'''v2.4.0 2024/10/13'''
-*It freezes/crashes every now and then, but it doesn't seem to happen while &quot;sounds&quot; are set to &quot;Off&quot;. ✔️Fix coming in v1.1 - it was an &quot;Out of Memory&quot;-type crash related to the uncompressed audio.
-*All the above bugs are also present in VitaHEX's HexFlow Launcher 0.5
-*Suspending sometimes causes a crash if you're using music.
-*New glitch in v1 and above: hitting &quot;download all PSP covers&quot; doesn't seem to work due to a typo in the code cleanup of v1.0, but all single downloads work fine.
-*Due to how the coding of the massive performance boost of v1.0.0+ is, some apps sometimes add garbage to the app title. A double scan on non-alphanumeric app titles might be able to fix this, or a better renaming function might work as a hotfix.
-== Support ==
+Quick overview: RetroFlow (enable in settings), SwitchView/GridView (enable in settings), JIT rolling cache, 8 backgrounds, 20 languages. Relies on Adrenaline Bubble Manager for PSP/PS1 game launching.
-If you want to support the original creator of HexFlow Launcher (not this revamp mod), you can join [https://www.patreon.com/vitahex his Patreon].
-==Changelog==
+'''NEW'''
-'''(v.1.0.1)'''
-* Still has all of the features of v1.0.0, ex: SwitchView UI integration, instant overrides, and cy33hc/copyicons integration.
+* Added 10 new languages (20 total). Now supports EVERY language that the vita supports. Note: Auto-sets language on startup. The 'change language' setting is just for bug-testing now.
-*Fixed where some overrides wouldn't save to overrides.dat,
+* Each language now has a little flag
-*Fixed where you sometimes have to click "download cover" twice for a PS1 game due to a value not being cleared.
+* Added a cog icon for the settings menu. You'll see why in a later version. For now I just really wanted to get these old pull requests merged (sorry for taking so long!) and then go back to testing Adrenaline Launcher/Collections/XMB in the non-public version
-*Fixed where overriding to PS1 sometimes caused a minor visual bug.
-*New feature and/or bugfix: downloaded single covers now show up ASAP instead of showing blank temporarily.
+'''BUGFIXES'''
+* Very minor bugfix related to app title renaming (prevents an esoteric rename that prevented app launches unless you deleted cache)
+* Very minor bugfix related to app title reading (now sanitizes invisible 'control' characters)
+* Removed several unnecesary local variables related to setting menu spacing not needed now due to better translations, such as 'Allow view [https://github.com/BlackSheepBoy69/HexFlow-Launcher-Unofficial-Custom/issues/5 #5]/[https://github.com/BlackSheepBoy69/HexFlow-Launcher-Unofficial-Custom/issues/6 #6]' &gt;&gt;&gt;&gt; 'Allow 2D Views'
+index.lua is the source code. View code differences between v2.3.1 and v2.4 [https://github.com/BlackSheepBoy69/HexFlow-Launcher-Unofficial-Custom/commit/816486898d0e3cf7028443d5789db653d061050f here (link).]
+'''v2.3.1 2024/01/18'''
+(v2.3.1)
+Quick overview: RetroFlow (enable in settings), SwitchView/GridView (enable in settings), JIT rolling cache, 8 backgrounds, 10 languages. Relies on Adrenaline Bubble Manager for PSP/PS1 game launching.
+NEW:
+* Added theme color 'pink' from YoDwarf's fork, [https://github.com/YoDwarf/HexFlow-Launcher-Unofficial-w-custom-menubar here (link).]
+* Language will now autodetect every time the app starts up (but can no longer be manually set) to make sure that the below bugfix worked. May revert in a later version to increase startup speed. If a compatible translation file isn't found, it'll default to English.
+BUGFIXES:
+* Fixed (hopefully) a crash related to upgrading from a version below 2.0 (such as v0.5) up to the latest version, which seemed to cause an issue related to language string format: [string&quot;?&quot;]:597: bad argument # 2 to 'format' (number expected, got nil)
+index.lua is the source code. View code differences between v2.3.0 and v2.3.1 [https://github.com/BlackSheepBoy69/HexFlow-Launcher-Unofficial-Custom/commit/c37d25c661603813376aea06ebf9a25038e82862 here (link).]
+'''v2.3 2023/11/06'''
+(v2.2) Quick overview: RetroFlow (enable in settings), SwitchView/GridView (enable in settings), JIT rolling cache, 8 backgrounds, 10 languages.
+IMPROVEMENTS:
+* Minor code cleanup. May improve startup times when the option &quot;RetroFlow: ON&quot; is enabled.
+* Grid View: Tightened the Y-axis border on categories with 12 or less entries.
+BUGFIXES:
+* Fixed where double-replaying a game would buck off the least-recently replayed game from the 'recently played' category.
+* Fixed where &quot;RetroFlow: ON&quot; would make it so the override animations wouldn't play in 'recently played' and 'custom' categories.
+* Grid View: Fixed the very tiny jump that occured when using the touchscreen to go down from the first row.
+* Grid View: Fixed a big jump that occurred when using analog sticks and touchscreen at the same time.
+* Grid View: Fixed where going negative out of bounds in categories with 12 or less entries would move the camera when it shouldn't.
+A few improvements and bugfixes (that are now considered stable) imported from the experimental nonpublic version v3.0 which may release very soon with support for Adrenaline Launcher as well as many cool upgrades still in bugtesting. Note: unlike RetroFlow, this app v2.3 is still using Adrenaline Manager for PSP/PS1 for its stability - though this app does support RetroArch for PS1 (if &quot;RetroFlow: ON&quot; is enabled) as well, just like RetroFlow does. All other categories will launch direct with the big advantage that you will never have to refresh cache after the first startup due to rolling cache.
+index.lua is the source code. View what has changed in the source code since last version [https://github.com/BlackSheepBoy69/HexFlow-Launcher-Unofficial-Custom/commit/22f7a84e1eff225a3e4d4b85348030f2e38aa90b here (link).]
+'''v2.2 2023/06/08'''
+(v2.2) Quick overview: RetroFlow (enable in settings), SwitchView/GridView (enable in settings), JIT rolling cache, 8 backgrounds, 10 languages.
+NEW:
+* &quot;Utilities&quot; section in the start menu to access Photo Album, Browser, Trophies, etc.
+* Small files (such as retro games from RetroFlow) will now display file sizes in Kilobytes (Kb) if they're too small to be measured in Megabytes (Mb).
+* Swap X/O buttons is now automatic.
+BUGFIXES:
+* Fixed crash: &quot;1438: error opening ux0:/app/PCSE00034/sce_sys/param.sfo&quot; when you had a corrupt app installed.
+* Fixed where covers had issues downloading from the start menu.
+* Fixed the 3D model for N64 games being off-center in the triangle menu.
+* Fixed a buggy message when trying to download a snap with Custom Backgrounds: OFF
+* For Adrenaline Manager PSP/PS1 games: 1: No longer displays duplicate scanned ID. 2: Now shows proper game size.
+IMPROVEMENTS:
+* Editted the &quot;about&quot;/&quot;more information&quot; section to be more clear about RetroFlow and adding your own custom backgrounds/music.
+If you have issues or improvement ideas, please let me know. I'm currently working on to release the final update and it will be a big update. It will be a massive overhaul for the &quot;custom category&quot; which right now you only get 1 and it's not very set up to have RetroFlow games in it right now. Also to fix the minor audio pop, add the option for &quot;Adrenaline Launcher&quot;, and possibly to add the option to have the last 6 categories RetroFlow has that this app doesn't (PS Mobile, SCUMMVM, MAME, MAME2003+, FBA, NeoGeo) which would slow loading times a tiny bit. Any other ideas please let me know.
+'''v2.1 2023/05/13'''
+(v2.1)
+Quick overview: RetroFlow (enable in settings), SwitchView/GridView (enable in settings), JIT rolling cache, 8 backgrounds, 10 languages
+* Added X/O Button swap option for Japanese users, credit to [https://github.com/yzzyx-network yzzyx-network].
+* Added a pretty basic language auto-detector. If it detects Japanese the first time you boot up HexFlow Custom, it will set &quot;swap X/O&quot; to &quot;ON&quot;.
+* Fixed a bug where the app may crash when using Grid View, referencing an unused image.
+* Fixed a bug where it'd lag the first launch after resetting &quot;Recently Played: ON/OFF&quot;.
+* Fixed the weird flicker that would occur sometimes when exiting triangle menu.
+* Fixed a glitch in Grid View where if you were in a category with 4+ rows with the camera bottomed out and you were currently situated in the 2nd to last row and pressed right, it would wrongly refocus the camera to the middle.
+* Fixed where in the triangle menu, it would display RetroFlow entries as &quot;homebrew&quot;. Also made it so a PS1 Retroarch game will now be labelled respectively.
+* Cleaned up a lot of the code comments from v2.0.
+This was originally going to be a bigger update and take longer (with features such as more languages and implementing &quot;collections&quot; similar to actual RetroFlow), but this update has been hurried because of a really cool pull request from user &quot;yzzyx-network&quot; as well as the kind of important bugfixes for Grid View.
+'''v2.0 2023/05/09'''
+(v2.0)
+THE BIG RETROFLOW UPDATE!
+Quick Overview:
+RetroFlow (enable in settings), SwitchView/GridView, JIT rolling cache, 8 backgrounds, 10 languages
+Finally added setting: RetroFlow ON/OFF!!! Has all the categories of RetroFlow 6.0 except: PSM,
+ScummVM, MAME/MAME+, NeoGeo, and FBA... However please note it DOES support several &quot;newer&quot;
+RetroFlow categories: RetroArch PS1, Pico-8, Dreamcast. Supports PS1/PSP without RetroFlow
+(Adrenaline Manager) but doesn't support PSP Categories Lite (yet).
+It will read from the data folders created by RetroFlow, but it won't create or delete any folders
+or files except during cover downloads. If this is your first time using RetroFlow, it's recommended
+to install the current latest version of RetroFlow, run it at least once, and follow its
+installation instructions. This app uses Adrenaline Manager instead of RetroFlow's Adrenaline
+Launcher because many people have issues with Adrenaline Launcher.
+Cache will magically always stay up to date due to JIT Switch Generation (&quot;Rolling Cache&quot;)
+This is probably the main reason to use this app over RetroFlow.
+Fixed a major bug from v1.2/v1.2.1 where sometimes if rolling cache activated, it would clear
+cache instead of updating a line... You will know you had the issue if the &quot;writing to cache&quot;
+screen showed up every time - it's not supposed to. Hopefully fixed in this version. The
+&quot;writing to cache screen&quot; should only show up when you install a new app! If you had the bug,
+startup should now be much faster. It's ~3.9 seconds with 500 games but if you enable
+RetroFlow, it adds ~2 seconds.
+Finally released Grid View, available from the start menu with &quot;Allow View [https://github.com/BlackSheepBoy69/HexFlow-Launcher-Unofficial-Custom/issues/5 #5]/[https://github.com/BlackSheepBoy69/HexFlow-Launcher-Unofficial-Custom/issues/6 #6]&quot;, because it
+has finally been optimized enough that it doesn't cause massive lag.
+&quot;Loose match&quot; RetroFlow cover downloads... A lot of people really wanted this because of
+how strict the RetroFlow naming conventions are. Example: you can download a cover for a
+game called just &quot;Super Metroid&quot;... it will default to the USA cover.
+Upgraded cover downloads by start menu a lot: skips entryes that already have covers. Added a
+&quot;Screen.waitVblankStart()&quot; so that you can see briefly see what covers are being skipped.
+Works for all categories now including homebrews that have a vita-style cover (you should
+override them if so). Made download synchronous instead of asynchronous: Seems much faster.
+Mass cover downloads for PSP/PS1 will now use the ID scanner, as is done in triangle menu.
+Fixed where it wouldn't error out for &quot;no wifi&quot;.
+Bulletproofed cur_quick_dir, a variable used for overrides and everywhere that the code
+System.doesFileExist(...) used to be (cur_quick_dir is much faster but less stable).
+Drastically bulletproofed the function for increasing and decreasing category (ie: for
+when you press square). It will now properly hide an existing but empty CUSTOM category.
+Added a new style for &quot;Category Button: Up/Down&quot;
+Fixed N64 spacing in flat view (experimental)... added smoothness to zoomin view and left view.
+Credit to Axce for the idea but his code was not used. Currently experimenting with the best
+way to add smoothness to views other than zoomin/left view.
+CUSTOM category can be used similar to &quot;collections&quot; in RetroFlow, ex: to hold all your
+&quot;utility&quot;-type apps. However, it needs upgraded to support RetroFlow entries... the upgrade
+is currently in bugtesting. When done, you'll be able to add stuff to CUSTOM category via
+the triangle menu.
+Fixed where if it was the first time ever booting up, overrides wouldn't work on the first try.
+Also includes the minor bugfix from v1.2.1 where some categories might not show up right
+first time ever booting up.
+Added a new button at the bottom of the start menu &quot;Exit&quot;, as a kind of placeholder:
+it'll be replaced by &quot;Utilities&quot; or &quot;System Apps&quot; when applicable.
+The actual RetroFlow app might not register covers downloaded from this app if you have
+startup scan OFF in actual RetroFlow. Ones downloaded in RetroFlow will always show up here
+everytime due to rolling cache.
+There is a bug relating to RetroFlow and &quot;Return to Last-Played Game&quot;... if you have 2
+Retro games with the same filenames in DIFFERENT categories, it may pick the wrong one if the
+last played category was &quot;All&quot;/&quot;CUSTOM&quot;
+If you were using an experimental version, file &quot;ux0/data/HexFlow/debugfile.dat&quot; can be deleted.
+Changed app title to &quot;HexFlow Custom&quot;. If the old title still remains, it may have registered
+as a &quot;rename&quot;. You can reset it by scrolling to HexFlow Custom... pressing triangle... selecting
+&quot;rename&quot;... and setting it to blank which will reset the title.
+Added more bulletproofing to the code Category_Plus(), Category_Minus(), and categoryButton;
+where you couldn't change category if you hacked &quot;categoryButton&quot; in config.dat to be an
+invalid value and where the first time you hit the category button, it wouldn't register if
+you hacked &quot;showCat&quot; in config.dat to have an invalid value (for forward compatability).
+(Hopefully) fixed where a fresh install would lag for the first launch if Recently Played ON.
+Minor bulletproofing/improvement: Only app folders with 9 characters imported, removes
+duplicates or manually backed-up / renamed folders.
+Upgraded Italian translations, credit DaRk_ViVi
+New bugs:
+When you exit the triangle menu, the modbox will slightly glitch out for about 1/60th of a
+second or less in certain categories. You will easily miss it even if you're looking for it.
+If you have 2 RetroFlow entries with the same base file name, then &quot;return to last played&quot;,
+the &quot;recently played&quot; category, and the &quot;custom&quot; category might display the wrong one. For
+this reason, the &quot;custom&quot; category doesn't easily support RetroFlow entries. It will require
+a huge overhaul to make it work correctly The &quot;overhaul&quot; also allows this app to use
+&quot;Collections&quot; - one of the really great new features of actual RetroFlow 6.0... This
+&quot;overhaul&quot; is already done but is in bugtesting currently.
+'''v1.2.2 2023/04/17'''
+(v1.2.2)
+Fixed a newly-discovered major bug caused by a minor typo where sometimes if rolling cache activated, it would clear cache instead of updating a line. This version should be pretty rock solid!
+'''v1.2.2 2023/04/03'''
+(v1.2.1)
+Fixed where if this was your first time installing the app, the PS1/PSP categories may have been hidden; they should show up now (unless they're empty and you go in start menu and put &quot;Hide Empty Categories: ON&quot;).
+Note: This app uses &quot;Adrenaline Manager&quot; for PS1/PSP because it's a lot more stable than RetroFlow's &quot;Adrenaline Launcher&quot;... all bubbles made in &quot;Adrenaline Manager&quot; will be automatically put into their proper categories - PSP or PS1 - and can download covers regardless of their file names or ID's (like RetroFlow v5.0 and above).
+'''v1.2 2023/04/02'''
+(v1.2)
+Half a hotfix release, half a proper release; several new features and bugfixes.
+* Boots up in ~3.7 seconds with 500 games after first boot. JIT switch generation (&quot;rolling cache&quot;) keeps cache always up-to-date instantly. 10 Languages.
+* Added &quot;Recently Played ON/OFF&quot; setting. TURNING IT OFF WILL CLEAR YOUR RECENTLY PLAYED DATA UNLESS STARTUP CATEGORY &quot;Return to last played game&quot; IS ENABLED. The first time you launch a game with &quot;recently played&quot; enabled, it will lag for a second. Not sure why. Doesn't happen for 2nd+ launches.
+* Simplified the reading/writing cache code, fixed rolling cache error [&quot;String&quot;?&quot;]:1041:Attempt to call global 'FileConcat'(a nile value)&quot;
+* Covers can now be downloaded for PSP games (and PS1 games) regardless of their name or ID!!!
+* Fixed a visual glitch when using &quot;return to last played game&quot; in SwitchView mode.
+* Moved footer bar slightly, to look more like HexFlow Launcher Official. Made start menu slightly more stylish.
+* Commented out ~100 lines of code not necessary anymore due to rolling cache. &quot;Cache has been updated&quot; removed from cover download message.
+* Prioritized CPU buff (faster startup).
+* Medium-sized code cleanup and replaced several System.doesFileExist() with cur_quick_dir[] (faster startup, faster overrides)
+* IF YOU WERE USING AN EXPERIMENTAL VERSION: ux0:data/HexFlow/debugfile.dat is no longer necessary... you can delete it.
+* &quot;applistReadTime&quot; (in start menu&gt;more information) now includes time it took to write to cache (if applicable).
+* Combined &quot;Music ON/OFF&quot; and &quot;Music: Loop ON/OFF&quot; into one setting because it looks better, especially if &quot;shuffle&quot; is added.
+* &quot;Music: Loop ON/OFF&quot; can only be set if music exists.
+* Added credit to fwannmacher in credits (start menu&gt;more information).
-'''(v.1.0)'''
+'''v1.1 2023/03/25'''
-*SwitchView UI v0.1.2 integration + vita cover crop ability.
-*Extreme performance boost, the best so far.
-*Much better cover downloads, especially PS1.
-*App Renaming. Reset via triangle/start menu.
-*Better music support. Toggle loop, use .OGG/.MP3
-*cy33hc/copyicons full integration (start menu)
-*Massively cleaned up code from v0.9
-*4 new backgrounds (12 total) or use your own.
-*Spin override animation + instant recache.
-*10 languages, easy to edit language files.
-*Many new options in settings.
-*Secret Feature: select+L/R to jump by alphabet.
-*Completed Frameworks for future features:
-*grid view support (search l==p in source code)
-*Retroflow (done, in bugtesting)
-*Individual app overclock profiler (done, in bugtesting)
-*Super-fast self-updating cache (done, in bugtesting)
-'''(v.0.9.1)'''
+(v1.1)
-* Editted some triangle menu messagebox translations to display properly.
+Roughly the same startup time as the previous version, but no more refreshing cache, even for hundreds of apps!!!!!
-*Removed select button debug messagebox that was accidentally left in public release.
-*Added oneshot.png and cache_GIF_25x25.gif to data folder so the finished app would be 6.68 instead of 6.66mb
-'''(v.0.9)'''
+This is an intermediary release. Still working out an annoying GPU crash for the RetroFlow integration and the lag caused by grid view before either of those 2 features get released. It's just that someone requested what's stable to be released.
-* +2 Languages (Chinese, Polish). 10 total.
-*8 backgrounds, 6 From HEXFlow ( https://github.com/andiweli/hexflow-covers/tree/main/Backgrounds ), 2 from Retroflow ( https://github.com/jimbob4000/RetroFlow-Launcher/releases/ )
-*Starts up in ~2.9 seconds for 550 games (after the first launch). Refresh cache via the start menu (a later version may have "rolling refresh", so you won't have to).
-*Click.wav -> ogg stability bugfix (credit retroflow). It was supposed to help reduce crashing but I'm not sure.
-*Minor graphical bugfix (in custom category in v0.8)
-*Still using the buffed CPU code at the start from HexLauncher Custom v0.8, (now also in Retroflow v3.5!) for performance boost.
-*General PS1 bugfix, proper categorization and you can press triangle to generate a serial for cover download of PS1 games with bad ID's (most of them).
-*So much better touch scrolling.
-*Cool loading screen for when writing to cache.
-*Instant inline recache for single cover download, instant inline recache for "overrides" was removed (well, it's still there but commented out) because some people said it caused a crash... so you'll have to do proper refreshes for that.
-*There is an unreleased version with full rolling cache (when you install an app, it's instantly be added to cache on startup), but the code is pretty cringeworthy so it's not released yet.
-*“You must close HexLauncher First” bugfix.
-*Extreme code cleanup
-*Some progress towards adding Retroflow Rom-launching features, specifically, “xCatLookup” function (only framework).
-*Proper footer button spacing (90% credit Retroflow)
-*It will generates "applist.dat" on launch or when you hit "Refresh Cache". Either edit it within Vitashell, or upload it to your computer and edit it with gVim. Notepad won't work, it must be a unix-based text editor. Rename it to "customsort.dat" and put it back in "ux0:/data/HexFlow/" to create the custom category.
-*I recommend you put Moonlight first, then your system apps like Retroarch and Autoplugin II, then leave the other games in normal alphabetical order. You can put them in any order you want though. For v0.8, you can have duplicates in customsort if you put them. (NOTE: this caused a minor graphical bug for some PSP games and was removed in next version).
-*Wanna know how fast your startup was? (it should be ~2900 milliseconds). Go to the start menu > about.
-'''(v.0.8)'''
+* Removed the &quot;Refresh Cache&quot; and any settings related to startup scan.
-*New Portugese and Japanese language options. (8 total)
+* New function switch_generator()... I worked very hard on it and it improves the app a LOT.
-*Starts up in ~4 seconds after the first launch. Refresh cache via the start menu (a later version may have "rolling refresh", so you won't have to). After overriding a game's category or downloading a cover, you must refresh cache.
+** 1: It reads the ENTIRE app folder almost instantly. This is better than Vita Launcher (which just reads app.db) because this should be able to display anything that couldn't get added to app.db
-*Super performance boost from buffed CPU code at the start.
+** 2: It almost instantly checks for any new covers for every app on startup.
-*It will generates "applist.dat" on launch or when you hit "Refresh Cache". Either edit it within Vitashell, or upload it to your computer and edit it with gVim. Notepad won't work, it must be a unix-based text editor. Rename it to "customsort.dat" and put it back in "ux0:/data/HexFlow/" to create the custom category.
+** 3: Slightly faster overrides and cover downloads.
-*I recommend you put Moonlight first, then your system apps like Retroarch and Autoplugin II, then leave the other games in normal alphabetical order. You can put them in any order you want though. For v0.8, you can have duplicates in customsort if you put them. (NOTE: this caused a minor graphical bug for some PSP games and was removed in next version).
+** 4: It improves startup time slightly.
-*Wanna know how fast your startup was? (it should be ~4000 milliseconds). Go to the start menu > about.
+** 5: In the unreleased version, it has been harnessed to instantly load all the RetroFlow ROM's and their overrides/renames/covers.
+* Reformatted the font files (credit RetroFlow) and optimized image metadata to reduce startup times.
+* Cleaned up a the code a little bit. Ex: in cache writer.
+* New Startup Category &quot;Return to Last Played Game/Category&quot; (Credit fwannmacher).
+* You can now tap in SwitchView.
+* You can now also use analog sticks or tapping to access the bottom menu in SwitchView
+* Upgraded the secret select+L/R jump-by-alphabet feature to be more like RetroFlow's (skip numbers, always go to first-of-a-kind).
+* Fixed an extremely rare crash related to select+L
+* Minor bugfix for shadows in SwitchView.
+* Now using Rinnegatamante's app title bugfix. Should fix Invictaz's issue regarding an app with a corrupt apptitle.
-'''(v.0.7)'''
+Downgrades:
-* The only difference between 0.7 and 0.6 is that this one loads all icons flat and refuses to use covers (this speeds up the app at least 15%). It also has only 2 categories (all and custom).
-'''(v.0.6)'''
+* Removed the Language 10 - Chinese - temporarily since some letters aren't displaying right. Will have to import the fix from RetroFlow. The translation file is up-to-date though.
-* Mod of VitaHex's HexFlow Launcher 0.5 that lets you custom sort your games in any order you want and put cool cases on them.
+* Removed 3 &quot;less popular&quot; backgrounds - Wood 2, Marble, and Playstation Pattern 2.
-==Credits==
+'''v1.0.1-hotfix 2022/09/06'''
-=== Credits (Revamp Mod) ===
-Programming: '''BlackSheepBoy69''' (me) and one or more coders who wish to remain anonymous
-=== Special Thanks ===
+(v1.0.1)
-Inspiration + various help: [https://github.com/jimbob4000/RetroFlow-Launcher/ Team RetroFlow]
+Still has all of the features of v1.0.0, ex: SwitchView UI integration, instant overrides, and cy33hc/copyicons integration.
-You! Users who enjoy HexFlow Launcher, HexLauncher Custom, and Retroflow, who submit feature requests to this/those projects (which I do watch), and occasionally code. Thank you!
+* Fixed where some overrides wouldn't save to overrides.dat,
+* Fixed where you sometimes have to click &quot;download cover&quot; twice for a PS1 game due to a value not being cleared.
+* Fixed where overriding to PS1 sometimes caused a minor visual bug.
+* New feature and/or bugfix: downloaded single covers now show up ASAP instead of showing blank temporarily.
-== Credits (General) ==
+[https://github.com/BlackSheepBoy69/HexFlow-Launcher-Unofficial-Custom/releases Release notes.]
-Programming/UI: '''Sakis RG'''
-Developed with [http://rinnegatamante.github.io/lpp-vita/ Lua Player Plus] by '''Rinnegatamante'''
+==Credits==
+Credits (Revamp Mod):
+*Programming - BlackSheepBoy69 and one or more coders who wish to remain anonymous.
-=== Special Thanks ===
+Special Thanks:
-'''Creckeryop'''
+*Inspiration + various help from [https://github.com/jimbob4000/RetroFlow-Launcher/ Team RetroFlow].
+*Users who enjoy HexFlow Launcher, HexLauncher Custom, and Retroflow, who submit feature requests to this/those projects (which I do watch), and occasionally code. Thank you.
-<s>'''andiweli''' ([https://github.com/andiweli/hexflow-covers HEXFlow Covers database])</s> (v0.9.1 and below)
+Credits (General):
+*Programming/UI - Sakis RG.
+*Developed with [http://rinnegatamante.github.io/lpp-vita/ Lua Player Plus] by Rinnegatamante.
-'''jimbob4000''' ([https://github.com/jimbob4000/hexflow-covers RetroFlow Covers database]) (v1.0 and above)
+Special Thanks:
+*Creckeryop.
+*andiweli ([https://github.com/andiweli/hexflow-covers HEXFlow Covers database]) (v0.9.1 and below).
+*jimbob4000 ([https://github.com/jimbob4000/hexflow-covers RetroFlow Covers database]) (v1.0 and above).
-=== Translations ===
+Translations:
-*French - @chronoss
+*French - @chronoss.
-*German - @stuermerandreas
+*German - @stuermerandreas.
-*Spanish - @kodyna91
+*Spanish - @kodyna91.
-*Italian - @TheheroGAC
+*Italian - @TheheroGAC.
-*Russian - @_novff
+*Russian - @_novff.
-*Swedish - @Spoxnus86
+*Swedish - @Spoxnus86.
-*Portuguese - @nighto (Retroflow)
+*Portuguese - @nighto (Retroflow).
-*Japanese - @iGlitch (Retroflow)
+*Japanese - @iGlitch (Retroflow).
-*Chinese - @acd13141 (Retroflow)
+*Chinese - @acd13141 (Retroflow).
-*Polish - @SK00RUPA (Retroflow)
+*Polish - @SK00RUPA (Retroflow).
 Google Translate was used for HexFlow Launcher Unofficial Custom translations that weren't found on HexFlow Launcher and Retroflow. Retroflow's oddly formatted translation files have been standardized.
-== External links ==
+==External links==
-* Github - https://github.com/BlackSheepBoy69/HexFlow-Launcher-Unofficial-Custom/
+* GitHub - https://github.com/BlackSheepBoy69/HexFlow-Launcher-Unofficial-Custom/
+* Reddit - https://www.reddit.com/r/vitahacks/comments/x7ryka/release_hexlauncher_custom_101_minor_bugfix_more/
+* Reddit - https://www.reddit.com/r/vitahacks/comments/x4bqve/release_hexlauncher_custom_10_revamp_mod_for/
 * Reddit - https://www.reddit.com/r/vitahacks/comments/u61nmt/release_vitahex_launcher_custom_v09_unofficial/
+* Reddit - https://www.reddit.com/r/vitahacks/comments/rnu978/release_hexlauncher_custom_08_revamp_mod_for/