BlackSheepBoy69 / HexFlow-Launcher-Unofficial-Custom

A 3d cover flow like launcher for PS Vita
MIT License
54 stars 5 forks source link

HexFlow-Launcher-Unofficial-Custom

Releases page: https://github.com/BlackSheepBoy69/HexFlow-Launcher-Unofficial-Custom/releases

Revamp mod for VitaHEX's 3D coverflow style launcher for PS Vita.

Releases page: https://github.com/BlackSheepBoy69/HexFlow-Launcher-Unofficial-Custom/releases

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.

Launching a game/app from HexFlow Launcher will close the launcher automaticaly without asking.

Custom Covers

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

If RetroFlow is enabled, Retro covers can be found in "ux0:/data/RetroFlow/COVERS/"

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). Sample vita cover image

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 from the link below. 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.

https://github.com/jimbob4000/hexflow-covers/

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. This can be used for real apps, for example, to create a "utilities" category, however it doesn't currently support RetroFlow entries and a fix for this is in bugtesting.

Custom Music

Place your Music.ogg or Music.mp3 file in "ux0:data/HexFlow/" (music will play automaticaly when the "Sounds" option is enabled)

 

AutoBoot

If you want to auto-launch HexFlow Launcher Unofficial Custom every time your PS Vita boots up you can use the AutoBoot plugin by Rinnegatamante. It's also available on Autoplugin II, however some people recommend to not use autoplugin. 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

 

Controls

Navigate your library using the DPad or the Left Stick or with the Touch Screen.

R/L triggers: Skip 5 items

Select+R/L triggers: Skip by alphabet

Cross: Select/Launch game/app

Square: Change Category

Triangle: Game Details

Circle: Change View/Cancel

Start: Settings menu

DPad Up/Down: Access SwitchView UI menu

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

 

IMPORTANT

Subfolders and psp categories plugin are not supported. Support for these is currently in bugtesting..

Downloads

Grab the latest version from the releases page: https://github.com/BlackSheepBoy69/HexFlow-Launcher-Unofficial-Custom/releases

 

Credits (Revamp Mod)

Programming: BlackSheepBoy69 (me) and one or more coders who wish to remain anonymous

Special Thanks

Code for "Return to Last Played Game": fwannmacher (v1.1 and above)

jimbob4000 (RetroFlow Covers database) (v1.0 and above)

Inspiration + various help: Team RetroFlow

Inspiration for adding smooth view in "Zoom-In" View/"Left-Side" View: Axce. He has coded for it to work in all views but I will fine tune it a little more before adding it to all the views.

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 Lua Player Plus by Rinnegatamante

Special Thanks

Creckeryop

Translations

French - @chronoss

German - @stuermerandreas

Spanish - @kodyna91

Italian - @TheheroGAC, @DaRk_ViVi

Russian - @_novff

Swedish - @Spoxnus86

Portuguese - @nighto (Retroflow)

Japanese - @iGlitch (Retroflow)

Polish - @SK00RUPA (Retroflow)

Google Translate was used for HexFlow Launcher Unofficial Custom translations that weren't found on HexFlow Launcher and Retroflow.

 

Support

If you want to support the original creator of HexFlow Launcher (not this revamp mod), you can join his Patreon.

or send to his PayPal link.

Official VitaHEX Twitter

Official VitaHEX Website

Official VitaHEX HexFlow Launcher Github (abandoned?)

HexFlow Launcher Unofficial Custom download page

User Feature Requests

Feature requests and "issues" posted on Retroflow & 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 "generousity of my heart") 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 "index.lua" and put it in like this: ux0:/app/HXLC00001/index.lua

...Or put it directly into the vpk (openable with Winrar) to replace the index.lua there.

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

If your version works out, send it here as a github "pull request" 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.