Toggle menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

HexLauncher Custom Vita: Difference between revisions

From GameBrew
m (HydeWing moved page VitaHex Launcher Custom Vita to HexLauncher Custom Vita without leaving a redirect)
No edit summary
Line 15: Line 15:
|license=Mixed
|license=Mixed
|download=https://dlhb.gamebrew.org/vitahomebrews/vitahexlaunchercustom.7z
|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://www.reddit.com/r/vitahacks/comments/x7ryka/release_hexlauncher_custom_101_minor_bugfix_more/
|source=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
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 3D coverflow style]] launcher for PS Vita.


==What is VitaHex Launcher Custom?==
VitaHEX's HexFlow Launcher is an application that display and launch your games and homebrews in style.
Display and launch your games and homebrews in style.


'''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.
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.


Launching a game/app from '''HexFlow Launcher''' will close the launcher automaticaly without asking.
When you launching a game/app from HexFlow Launcher, the launcher will close automatically without asking.


=== Important ===
==User guide==
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.
===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.


'''Subfolders and psp categories plugin are not supported'''.
===Download Covers and Backgrounds===
In v0.3 and above, covers can be downloaded automatically from the settings menu (Start button).  


== AutoBoot ==
You can also download covers and backgrounds manually [https://github.com/jimbob4000/hexflow-covers/ 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.
If you want to auto-launch '''HexFlow Launcher''' every time your PS Vita boots up you can use the [[Autoboot Vita]] plugin by Rinnegatamante.


== Controls ==
===Custom Covers===
Navigate your library using the '''DPad''' or the '''Left Stick''' or with the '''Touch Screen'''.
Place your custom covers in ux0:/data/HexFlow/COVERS/PSVITA/.


'''R/L triggers''': Skip 5 items
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).


'''Select+R/L triggers''': Skip by alphabet
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.


'''Cross''': Select/Launch game/app
Sample vita cover image.


'''Square''': Change Category
===Custom Background===
Place your Background.png or Background.jpg image in ux0:/data/HexFlow/ (recomended resolution 1280x720px or less).


'''Triangle''': Game Details
Some custom backgrounds are available here. In v0.9 and above, these sample custom backgrounds are included by default.


'''Circle''': Change View/Cancel
===Custom Category===
In v0.6 and above, take the applist.dat file in ux0:data/HexFlow/ and rename it to customsort.dat.


'''Start''': Settings menu
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.


'''DPad Up/Down''': Access SwitchView UI menu
Windows notepad won't work.


'''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'''
===Custom Music===
Place your Music.ogg or Music.mp3 file in ux0:data/HexFlow/.


== Custom Covers ==
Music will play automaticaly when the "Sounds" option is enabled.
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 (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]
===Important notes===
For PSP bubbles generated by [[Adrenaline Bubble Manager Vita|Adrenaline Bubbles Manager]] you must set the value of BubbleID to TitleID in the settings menu of ABM tool.  


=== Download Covers and Backgrounds ===
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). 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)
Subfolders and psp categories plugin are not supported.
*https://github.com/jimbob4000/hexflow-covers/ (v1.0 and above)


=== Custom Background ===
==Controls==
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.
D-Pad/Left Analog or Touchscreen - Navigate your library


=== Custom Category ===
R/L - Skip 5 items
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 ===
Select+R/L - Skip by alphabet
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)
 
==Media==
'''HEX-Flow Launcher 0.3 - PS Vita Preview (VitaHEX Games)'''<br>
<youtube>WDBgaAvhurY</youtube>


==Screenshots==
Cross - Select/Launch game/app
https://dlhb.gamebrew.org/vitahomebrews/vitahexlaunchercustom-01.jpg
https://dlhb.gamebrew.org/vitahomebrews/vitahexlaunchercustom-02.jpg


== User Feature Requests ==
Square - Change Category
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
Triangle - Game Details


...Or put it directly into the vpk (openable with Winrar) to replace the index.lua there.
Circle - Change View/Cancel


The great feature of lua files is they can open in a simple text editor such as Notepad, and you don't need VitaSDK.
Start - Settings menu


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.
D-Pad Up/Down - Access SwitchView UI menu


== Planned Features for Upcoming Updates ==
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.
*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 ==
==Screenshots==
*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.
vitahexlaunchercustom3.png
*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 ==
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==
==Changelog==
'''(v.1.0.1)'''
'''v1.0.1'''
* Still has all of the features of v1.0.0, ex: SwitchView UI integration, instant overrides, and cy33hc/copyicons integration.
*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 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 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.
*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.
*New feature and/or bugfix: downloaded single covers now show up ASAP instead of showing blank temporarily.


'''(v.1.0)'''
'''v1.0'''
*SwitchView UI v0.1.2 integration + vita cover crop ability.
*SwitchView UI v0.1.2 integration + vita cover crop ability.
*Extreme performance boost, the best so far.
*Extreme performance boost, the best so far.
*Much better cover downloads, especially PS1.
*Much better cover downloads, especially PS1.
*App Renaming. Reset via triangle/start menu.
*App Renaming. Reset via triangle/start menu.
*Better music support. Toggle loop, use .OGG/.MP3
*Better music support. Toggle loop, use .OGG/.MP3.
*cy33hc/copyicons full integration (start menu)
*cy33hc/copyicons full integration (start menu).
*Massively cleaned up code from v0.9
*Massively cleaned up code from v0.9.
*4 new backgrounds (12 total) or use your own.
*4 new backgrounds (12 total) or use your own.
*Spin override animation + instant recache.
*Spin override animation + instant recache.
Line 168: Line 114:
*Secret Feature: select+L/R to jump by alphabet.
*Secret Feature: select+L/R to jump by alphabet.
*Completed Frameworks for future features:
*Completed Frameworks for future features:
*grid view support (search l==p in source code)
*grid view support (search l==p in source code).
*Retroflow (done, in bugtesting)
*Retroflow (done, in bugtesting).
*Individual app overclock profiler (done, in bugtesting)
*Individual app overclock profiler (done, in bugtesting).
*Super-fast self-updating cache (done, in bugtesting)
*Super-fast self-updating cache (done, in bugtesting).


'''(v.0.9.1)'''
'''v0.9.1'''
* Editted some triangle menu messagebox translations to display properly.
*Edited some triangle menu messagebox translations to display properly.
*Removed select button debug messagebox that was accidentally left in public release.
*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
*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)'''
'''v0.9'''
* +2 Languages (Chinese, Polish). 10 total.
*+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/ )
*8 backgrounds, 6 From [https://github.com/andiweli/hexflow-covers/tree/main/Backgrounds HEXFlow], 2 from [https://github.com/jimbob4000/RetroFlow-Launcher/releases/ Retroflow].
*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).
*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.
*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)
*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.
*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).
*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).
Line 191: Line 137:
*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.
*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.
*“You must close HexLauncher First” bugfix.
*Extreme code cleanup
*Extreme code cleanup.
*Some progress towards adding Retroflow Rom-launching features, specifically, “xCatLookup” function (only framework).
*Some progress towards adding Retroflow Rom-launching features, specifically, “xCatLookup” function (only framework).
*Proper footer button spacing (90% credit Retroflow)
*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.
*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).
*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.
*Wanna know how fast your startup was? (it should be ~2900 milliseconds). Go to the start menu > about.


'''(v.0.8)'''
'''v0.8'''
*New Portugese and Japanese language options. (8 total)
*New Portugese and Japanese language options. (8 total).
*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.
*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.
*Super performance boost from buffed CPU code at the start.
*Super performance boost from buffed CPU code at the start.
Line 206: Line 152:
*Wanna know how fast your startup was? (it should be ~4000 milliseconds). Go to the start menu > about.
*Wanna know how fast your startup was? (it should be ~4000 milliseconds). Go to the start menu > about.


'''(v.0.7)'''
'''v0.7'''
* 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).
*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)'''
'''v0.6'''
* 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.
*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.


==Credits==
==Credits==
=== Credits (Revamp Mod) ===
Credits (Revamp Mod):
Programming: '''BlackSheepBoy69''' (me) and one or more coders who wish to remain anonymous
*Programming - BlackSheepBoy69 and one or more coders who wish to remain anonymous.
 
=== Special Thanks ===
Inspiration + various help: [https://github.com/jimbob4000/RetroFlow-Launcher/ Team RetroFlow]
 
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!
 
== Credits (General) ==
Programming/UI: '''Sakis RG'''
 
Developed with [http://rinnegatamante.github.io/lpp-vita/ Lua Player Plus] by '''Rinnegatamante'''


=== 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.
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/u61nmt/release_vitahex_launcher_custom_v09_unofficial/
* Reddit - https://www.reddit.com/r/vitahacks/comments/rnu978/release_hexlauncher_custom_08_revamp_mod_for/

Revision as of 02:40, 16 December 2022

VitaHex Launcher Custom
File:Vitahexlaunchercustom.jpg
General
AuthorBlackSheepBoy69
TypeTitle Launchers
Version1.0.1
LicenseMixed
Last Updated2022/09/06
Links
Download
Website
Source

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 launching 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.

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 (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.

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.

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.

Important notes

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.

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

vitahexlaunchercustom3.png

Changelog

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.

v1.0

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

v0.9.1

  • Edited some triangle menu messagebox translations to display properly.
  • 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.

v0.9

  • +2 Languages (Chinese, Polish). 10 total.
  • 8 backgrounds, 6 From HEXFlow, 2 from Retroflow.
  • 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.

v0.8

  • New Portugese and Japanese language options. (8 total).
  • 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.
  • Super performance boost from buffed CPU code at the start.
  • 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 ~4000 milliseconds). Go to the start menu > about.

v0.7

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

v0.6

  • 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.

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:

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

Advertising: