Toggle search
Toggle menu
10.3K
13.2K
1.2K
203.5K
GameBrew
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

RetroFlow Launcher Vita: Difference between revisions

From GameBrew
More actions
m (HydeWing moved page Retroflow Launcher Vita to RetroFlow Launcher Vita without leaving a redirect)
No edit summary
Line 8: Line 8:
|title=RetroFlow Launcher
|title=RetroFlow Launcher
|image=retroflowlaunchervita.jpg
|image=retroflowlaunchervita.jpg
|description=3D Coverflow launcher for PSVITA.
|description=3D Coverflow launcher for PS Vita, includes categories for retro games. Mod of HexFlow Launcher
|author=jimbob4000 & VitaHEX games
|author=jimbob4000 & VitaHEX games
|lastupdated=2022/12/01
|lastupdated=2022/12/01
Line 18: Line 18:
|source=https://github.com/jimbob4000/RetroFlow-Launcher
|source=https://github.com/jimbob4000/RetroFlow-Launcher
}}
}}
'''RetroFlow Launcher''' is a modded version of [[Hexflow Launcher Vita]]; a 3d coverflow like launcher for PS Vita.
RetroFlow Launcher is a modded version of [[HexFlow Launcher Vita|HexFlow Launcher]]; a 3d coverflow like launcher for PS Vita.


This version includes categories for retro games which can be launched without bubbles for RetroArch, DaedalusX64 and Flycast. Playstation and PSP games can also be launched without having to create bubbles for every game!
This version includes categories for retro games which can be launched without bubbles for RetroArch, DaedalusX64 and Flycast.  


==Main features added since forking from HexFlow==
Playstation and PSP games can also be launched without having to create bubbles for every game.
* No need to create bubbles for games
* Retro game categories added
* Favourite games category
* Recently played category
* Ability to search for games
* Ability to rename games
* Support for game backgrounds images
* Support for multiple music tracks
* Support for multiple wallapers
* Load from cache for faster startup
* File browser added for setting up game directories
* Fully translated


=== Supported systems ===
==Features==
PS Vita, PSP, Playstation, Nintendo 64, Super Nintendo, Nintendo Entertainment System, Game Boy Advance, Game Boy Color, Game Boy, Sega Dreamcast, Sega CD, Sega 32X, Sega Mega Drive / Genesis, Sega Master System, Sega Game Gear, PC Engine, PC Engine CD, TurboGrafx-16, TurboGrafx-CD, Commodore Amiga, Commodore 64, WonderSwan, WonderSwan Color, MSX, MSX2, ZX Spectrum, Atari Lynx, Atari 600, Atari 5200, Atari 7800, ColecoVision, Vectrex, FBA 2012, MAME 2003 Plus, MAME 2000, Neo Geo (FBA 2012) and Neo Geo Pocket Color.
* No need to create bubbles for games.
* Retro game categories added.
* Favourite games category.
* Recently played category.
* Ability to search for games.
* Ability to rename games.
* Support for game backgrounds images.
* Support for multiple music tracks.
* Support for multiple wallapers.
* Load from cache for faster startup.
* File browser added for setting up game directories.
* Fully translated.


[[Daedalus X64 Vita]] is required for N64 games.
==Installation==
Install the RetroFlow VPK's:
*Install [https://github.com/jimbob4000/RetroFlow-Launcher/releases the latest version of RetroFlow].
*Also install the additional [https://github.com/jimbob4000/RetroFlow-Launcher/releases RetroFlow Adrenaline launcher VPK].
*RetroFlow Launcher is the app you will use to browse games. RetroFlow Adrenaline launcher is needed for launching Playstation and PSP games.


[[Retroarch Vita]] is required for other retro systems.
Install any other necessary apps:
*[[Adrenaline Vita|Adrenaline]] is required for Playstation and PSP games.
*[[Daedalus X64 Vita|DaedalusX64]] is required for N64 games.
*[[Retroarch Vita|RetroArch]] is required for other retro systems.
*[[Flycast Vita|Flycast]] is required to play Dreamcast games. Also see the [https://newflycast.rinnegatamante.it/ compatibility list] as not all games are playable yet.
*Important: If Adrenaline games aren't launching after you have finished the setup, please install [[AdrBubbleBooterInstaller Vita|AdrBubbleBooterInstaller]]. Or try installing [[Adrenaline Bubble Manager Vita|Adrenaline Bubble Manager]].


[[Adrenaline Vita]] is required for Playstation and PSP games.
Check your PS1 and PSP are in the right Adrenaline folders:
*PS1 and PSP games with eboot files should be saved here: ux0:pspemu/PSP/GAME/.
*PSP ISO and CSO games should be saved here: ux0:pspemu/ISO/.
*uma0, ur0, imc0 and xmc0 partitions are also supported.
*The partition you use for Adrenaline will also need to be selected in the 'Scan settings' in RetroFlow.
*Tip: PS1 games can also be launched using RetroArch, helpful for games which don't run well in Adrenaline.


[[Flycast Vita]] is required to play Dreamcast games. Also see the [https://newflycast.rinnegatamante.it/ compatability list] as not all games are playable yet.
==User guide==
===Supported systems===
PS Vita, PSP, Playstation, Nintendo 64, Super Nintendo, Nintendo Entertainment System, Game Boy Advance, Game Boy Color, Game Boy, Sega Dreamcast, Sega CD, Sega 32X, Sega Mega Drive / Genesis, Sega Master System, Sega Game Gear, PC Engine, PC Engine CD, TurboGrafx-16, TurboGrafx-CD, Commodore Amiga, Commodore 64, WonderSwan, WonderSwan Color, MSX, MSX2, ZX Spectrum, Atari Lynx, Atari 600, Atari 5200, Atari 7800, ColecoVision, Vectrex, FBA 2012, MAME 2003 Plus, MAME 2000, Neo Geo (FBA 2012) and Neo Geo Pocket Color.


== How To Install RetroFlow Launcher==
===Add your retro games to RetroFlow===
=== 1. Install the RetroFlow VPK's. ===
For best results it's recommended that your games are named using the no-intro file naming convention, e.g. "Game Name (USA)", these names are used to download matching cover images.
Install the [https://github.com/jimbob4000/RetroFlow-Launcher/releases latest version of RetroFlow] and additional RetroFlow Adrenaline launcher VPK from [https://github.com/jimbob4000/RetroFlow-Launcher/releases here] or download both from gamebrew.


'RetroFlow Launcher' is the app you will use to browse games. 'RetroFlow Adrenaline launcher' is needed for launching Playstation and PSP games.
'''Option 1 - Use the default folders'''
*Launch RetroFlow for the first time, RetroFlow will create the folders where you can save your games.
*Once it's finshed loading; close RetroFlow and copy or move your favourite retro games into the relevant game subfolders here: ux0:/data/RetroFlow/ROMS/.


=== 2. Rename your PSP games using the steps below. ===
'''Option 2 - Use your own game folders'''
Renaming is needed for cover matching. RetroFlow will look for a title ID in the filename.
*If you don't want to save your games in the RetroFlow data folder, you can use your own directories.
*Go to 'Scan settings' and then "Edit game directories" to change the path to game folders.
*Once you are done, select "Rescan" to find the games.


==== Windows users: ====
'''Disc based games'''
Please rename PSP ISO and CSO files using Leecherman's [https://sites.google.com/site/theleecherman/PSPISORenamer PSP ISO Renamer tool] using the following parameters:
*PC Engine CD and TurboGrafx-CD: RetroFlow will look for .cue files for these CD systems. Please make sure all the games are loose with the system's rom folder with .cue files.
*Dreamcast: .gdi and .cdi games are supported.
*PS1 using RetroArch - They will use the 'PCSX ReARMed' core, [https://docs.libretro.com/library/pcsx_rearmed/ more information on supported extensions here].
*Note: If you're using an old version of RetroFlow (below v5) you will need to rename PSP and maybe PS1 games too, please see: [https://github.com/jimbob4000/RetroFlow-Launcher/blob/main/docs/Legacy_guide_-_Renaming_PSP_and_PS1.md Legacy guide - Renaming PSP and PS1].


<div class="snippet-clipboard-content notranslate position-relative overflow-auto">
===Rescan to find your games===
Press Start and go to "Scan Settings", select your Adrenaline location, and if you are using custom game folders, select those too, then select "Rescan".


<pre class="notranslate">%NAME% (%REGION%) [%ID%]</pre>
Your retro games should now appear when you restart the app.


The result should look like this (please notice the square brackets):
"Startup scan" can be turned off once you have finished adding your games, the app will startup faster when it's turned off.


<pre class="notranslate">Cars 2 (US) [UCUS-98766].iso</pre>
===Download covers and backgrounds===
To download cover images, press start, go to "Artwork" then choose which covers or backgrounds you would like to download.


Games can also be named with just the title ID like so: &quot;UCUS98766.iso&quot; but this isn't recommended.
From version 5 onwards you can also extract background images for PSP games from PSP iso files.


==== Mac users: ====
==Screenshots==
See the FAQ's section for a guide on [https://github.com/jimbob4000/RetroFlow-Launcher#im-on-a-mac-how-do-i-rename-psp-games renaming on a mac].
 
More information on PSP and Playstation after the FAQ's section.
 
=== 3. Check your PS1 and PSP are in the right Adrenaline folders ===
PS1 and PSP games with eboot files should be saved here:
 
<pre class="notranslate">ux0:pspemu/PSP/GAME/</pre>
 
PSP ISO and CSO games should be saved here:
 
<pre class="notranslate">ux0:pspemu/ISO/</pre>
 
uma0 can also be used.
 
'''Tip:''' PS1 games can also be launched using RetroArch, helpful for games which don't run well in Adrenaline.
 
=== 4. Add your retro games to RetroFlow ===
'''Option 1 - Use the default folders:''' Launch RetroFlow for the first time, RetroFlow will create the folders where you can save your games.
 
Once it's finshed loading; close RetroFlow and copy your favourite retro games into the relevant subfolders below:
 
<pre class="notranslate">ux0:/data/RetroFlow/ROMS/</pre>
 
For PC Engine CD and TurboGrafx-CD RetroFlow will look for '.cue' files for these CD systems. Please make sure all the games are loose with the system's rom folder with .cue files.
 
For Dreamcast '.gdi' and '.cdi' games are supported.
 
RetroArch Playstation 1 games use the 'PCSX ReARMed' core, more information on supported extensions here: https://docs.libretro.com/library/pcsx_rearmed/
 
'''Option 2 - Use your own game folders:''' If you don't want to save your games in the RetroFlow data folder, you can use your own directories.
 
Go to 'Scan settings' and then 'Edit game directories' to change the path to game folders.
 
Once you are done, select 'Rescan' to find the games.
 
'''Tip:''' It's important that your roms are named using the no-intro file naming convention, e.g. &quot;Game Name (USA)&quot; , otherwise cover images won't be found.
 
=== 5. Rescan to find your games ===
Press 'Start' and go to 'Scan Settings', then select 'Rescan' Your retro games should now appear when you restart the app. 'Startup scan' can be turned off once you have finished adding your games, the app will startup faster when it's turned off.
 
=== 6. Download covers &amp; backgrounds ===
To download cover images, press start, then choose which covers or backgrounds you would like to download.
 
==Issues loading games with Adrenaline? ==
Please try installing [https://vitadb.rinnegatamante.it/#/info/307 AdrBubbleBooterInstaller]. Or try installing [https://github.com/ONElua/AdrenalineBubbleManager/releases Adrenaline Bubble Manager] to check bubbles load okay.


==Media==
==Media==
<youtube>5lEWP8-K6OI</youtube>
<youtube>5lEWP8-K6OI</youtube>


==Screenshots==
https://dlhb.gamebrew.org/vitahomebrews/retroflowlaunchervita-01.jpg
https://dlhb.gamebrew.org/vitahomebrews/retroflowlaunchervita-02.jpg
https://dlhb.gamebrew.org/vitahomebrews/retroflowlaunchervita-03.jpg
https://dlhb.gamebrew.org/vitahomebrews/retroflowlaunchervita-04.jpg
==Possible incompatabilities==
=== Repatch ===
Potential issue with repatch / repatch_4 plugins in the tai config. May cause the Vita to shutdown. Try disabling these if you encounter an issue.
=== PSP Categories lite ===
Unsupported, if you're experiencing please try without the plugin.
== RetroFlow FAQ's ==
=== I'm on a Mac, how do I rename PSP games? ===
You can use the [https://github.com/BrosMakingSoftware/UMD_FileRenamer/releases/tag/v1.0 UMD FileRenamer app here].
Step 1. Download the UMD FileRenamer app above Open the 'UMD_FileRenamer-1.0.jar' file and select your folder of games, then rename.
Step 2. Replace (parenthesis) with [brackets] In the finder, select all the games, right click and select 'rename items'. Replace the opening and closing parenthesis with square brackets instead.
<pre class="notranslate">Name (XXXX-XXXXX).iso</pre>
Will be renamed to:
<pre class="notranslate">Name [XXXX-XXXXX].iso</pre>
The game names will be missing the region code, but it's not required for the RetroFlow to work.
=== Can I use HexFlow too? ===
Yes; RetroFlow is seperate, it uses different folders and a different title ID.
=== Do I need to create bubbles for games? ===
No; RetroFlow doesn't need bubbles for games.
=== Missing artwork - How should I name my games so covers are found? ===
It's recommended that your roms are named using the no-intro file naming convention, e.g. &quot;Game Name (USA)&quot; , these names are used to match with cover images.
You can manually download artwork, or rename your games to match the filenames in the [https://github.com/jimbob4000/hexflow-covers covers repo].
=== Some systems aren't showing? ===
Empty collections are hidden by default, once you add some games into the roms folder, they will appear.
=== Can I change the Mega Drive name to Genesis? ===
Sure; changing your language to 'English - American' will change the 'Mega Drive' name and logo to 'Genesis'.
=== Can I change a core for RetroArch? ===
The cores have been set by system and cannot be changed on a game-by-game basis at the moment.
To change the core for an entire system, search for &quot;Retroarch Cores&quot; in the file below and edit the core file names accordingly.
<pre class="notranslate">ux0:/app/RETROFLOW/index.lua</pre>
The RetroArch core files can be found here: &quot;ux0:/app/RETROVITA/&quot;
=== Can I change the rom folder locations? ===
Yes, from version 4.0 onwards. Go to 'Scan settings' and then 'Edit game directories' to change the path to game folders.
== Adding PSP and Playstation games ==
RetroFlow uses the game ID's for Playstation and PSP for cover matching. Please use the guides below.
=== PSP ===
For PSP ISO and CSO files please rename using Leecherman's [https://sites.google.com/site/theleecherman/PSPISORenamer PSP ISO Renamer tool] using the following parameters:
<pre class="notranslate">%NAME% (%REGION%) [%ID%]</pre>
The result should look like this:
<pre class="notranslate">Cars 2 (US) [UCUS-98766].iso</pre>
RetroFlow uses the ID to match artwork, and tidies the rest of the filename to display in the app. CSO files are also supported, and should be named as above.
=== Playstation ===
==== PS1 using Adrenaline ====
For PSX2PSP, game folder name must match with the GameID. For example:
<pre class="notranslate">ux0:pspemu/PSP/GAME/**SLES01234**</pre>
Games will need to be in a EBOOT format, see here for information on [https://www.cfwaifu.com/psx2psp/ how to convert PSX Disc Images to EBOOT for PSP]. RetroFlow also uses the ID to lookup the name of the game.
==== PS1 using RetroArch ====
RetroArch Playstation 1 games use the 'PCSX ReARMed' core, more information on supported extensions and setup see here: https://docs.libretro.com/library/pcsx_rearmed/
== Custom Game Covers, Game Backgrounds and Music ==
Place your custom covers in the game system's here &quot;''ux0:/data/RetroFlow/COVERS/''&quot;
Place your custom game backgrounds in the game system's here &quot;''ux0:/data/RetroFlow/BACKGROUNDS/''&quot;
Cover and background images must be in '''png''' format. For Vita, PSP, PSX games and Homebrew the The cover image file name must match the '''Game ID''' or the '''Game Name''' of each app. For roms the cover image name should match the '''Rom Name''' i.e. &quot;Game Name (USA).png&quot;. The recommended resolution for Vita covers is 250x320px. [https://live.staticflickr.com/7176/6885249717_738e8ee187_n.jpg Sample image]
=== Download Covers and Backgrounds ===
Covers and game backgrounds can be downloaded automatically from the artwork section of the settings menu (Start button). You can also download covers manually from the link below. A big thanks to '''astuermer''' for his contribution.
https://github.com/jimbob4000/hexflow-covers
=== Custom Backgrounds ===
Place your image in &quot;''ux0:/data/RetroFlow/WALLPAPER''&quot; (recomended resolution 1280x720px or less). Some custom backgrounds are available [https://github.com/andiweli/hexflow-covers/tree/main/Backgrounds HERE] You can change your background within the app by going to the settings menu &gt; theme &gt; custom background.
=== Custom Music ===
Place your '''.ogg''' formatted music files in &quot;''ux0:data/RetroFlow/MUSIC''&quot; (music will play automatically when the &quot;Sounds&quot; option is enabled).
== AutoBoot ==
If you want to auto-launch '''RetroFlow Launcher''' every time your PS Vita boots up you can use the [https://vitadb.rinnegatamante.it/#/info/261 '''AutoBoot'''] plugin by Rinnegatamante.
== Controls ==
Navigate your library using the '''DPad''' or the '''Left Stick''' or with the '''Touch Screen'''.
'''DPad Up''': Skip to favorites category
'''R/L triggers''': Skip 5 items
'''Cross''': Select/Launch game/app
'''Square''': Change Category/Rename game
'''Triangle''': Game Details/Add or remove favorites/About
'''Circle''': Change View/Cancel
'''Start''': Settings menu
'''Select''': Search


==Changelog==
==Changelog==
'''5.0.2'''
'''5.0.2'''
*Improvements
*Improvements:
**Adrenaline bubbles using 'PSPEMU' as titles are now excluded from the app.
**Adrenaline bubbles using 'PSPEMU' as titles are now excluded from the app.
**(The games used for the bubbles will still be included in the PSP or PS1 category).
**(The games used for the bubbles will still be included in the PSP or PS1 category).
 
*Bug fixes:
*Bug fixes
**RetroFlow Adrenaline Launcher - Corrected the LiveArea startup image position.
**RetroFlow Adrenaline Launcher - Corrected the LiveArea startup image position.
**Install the v3 vpk in this release or alternatively, once you have installed the 5.0.2 vpk you can install it from the app directory here:
**Install the v3 vpk in this release or alternatively, once you have installed the 5.0.2 vpk you can install it from the app directory here:
**ux0:/app/RETROFLOW/payloads/\nRetroFlow Adrenaline Launcher.vpk
**ux0:/app/RETROFLOW/payloads/\nRetroFlow Adrenaline Launcher.vpk.


'''5.0.1'''
'''5.0.1'''
*New
*New:
**Categories Lite support for Adrenaline
**Categories Lite support for Adrenaline.
 
*Bug fixes:
*Bug fixes
**More robust filtering for bad sfo files.
**More robust filtering for bad sfo files
**Fixed image error when overriding category.
**Fixed image error when overriding category.
 
*Pre-release:
*Pre-release
**This version will be updated incrementally with bug fixes until fully released.
**This version will be updated incrementally with bug fixes until fully released.


'''5.0.0'''
'''5.0.0'''
*New
*New:
**No longer need to rename PSP games - PSP and PS1 game titles are now extracted from iso, cso and pbp files.
**No longer need to rename PSP games - PSP and PS1 game titles are now extracted from iso, cso and pbp files.
**Extract PSP background images - New option to extract PSP background images from iso files rather than downloading in-game screenshots.
**Extract PSP background images - New option to extract PSP background images from iso files rather than downloading in-game screenshots.
Line 277: Line 127:
**New Control - DPad Down + L/R triggers: Skip games alphabetically.
**New Control - DPad Down + L/R triggers: Skip games alphabetically.
**New Languages - Dutch, Danish, Finnish, Norwegian, Turkish, Korean, Chinese (Simplified).
**New Languages - Dutch, Danish, Finnish, Norwegian, Turkish, Korean, Chinese (Simplified).
 
*Improvements:
*Improvements
**Language - Operating system language is checked the first time the app is opened and a matching language is set if available.
**Language - Operating system language is checked the first time the app is opened and a matching language is set if available.
**Language - Additional fonts added for Korean, traditional and simplified Chinese.
**Language - Additional fonts added for Korean, traditional and simplified Chinese.
**Renaming - When renaming a game, RetroFlow will now check for the cover and update if found.
**Renaming - When renaming a game, RetroFlow will now check for the cover and update if found.
 
*Bug fixes:
*Bug fixes
**Fixed issue when downloading a single cover, the custom cover would be removed.
**Fixed issue when downloading a single cover, the custom cover would be removed.
**Search and rename keyboard set to latin, as non latin characters don't seem to be supported.
**Search and rename keyboard set to latin, as non latin characters don't seem to be supported.
 
*Note:
*Note
**PS1 and PSP titles will change as the names are now coming from the game's sfo files rather than a database lookup.
**PS1 and PSP titles will change as the names are now coming from the game's sfo files rather than a database lookup.
**You can rename titles within the app if there's some you want to change.
**You can rename titles within the app if there's some you want to change.
 
*Translations:
*Translations
**If you would like to contribute to improving translations, please submit an issue or pull request.
**If you would like to contribute to improving translations, please submit an issue or pull request.


'''4.0.3'''
'''4.0.3'''
* New
* New:
** No longer need to rename PSP games - PSP and PS1 game titles are now extracted from iso, cso and pbp files.
** No longer need to rename PSP games - PSP and PS1 game titles are now extracted from iso, cso and pbp files.
** Extract PSP background images - New option to extract PSP background images from iso files rather than downloading in-game screenshots.
** Extract PSP background images - New option to extract PSP background images from iso files rather than downloading in-game screenshots.
Line 304: Line 150:
** New Control - DPad Down + L/R triggers: Skip games alphabetically.
** New Control - DPad Down + L/R triggers: Skip games alphabetically.
** New Languages - Dutch, Danish, Finnish, Norwegian, Turkish, Korean, Chinese (Simplified).
** New Languages - Dutch, Danish, Finnish, Norwegian, Turkish, Korean, Chinese (Simplified).
* Improvements  
* Improvements :
** Language - Operating system language is checked the first time the app is opened and a matching language is set if available.
** Language - Operating system language is checked the first time the app is opened and a matching language is set if available.
** Language - Additional fonts added for Korean, Chinese traditional and Chinese simplified.
** Language - Additional fonts added for Korean, Chinese traditional and Chinese simplified.
** Renaming - When renaming a game, RetroFlow will now check for the cover and update if found.
** Renaming - When renaming a game, RetroFlow will now check for the cover and update if found.
* Bug fixes  
* Bug fixes:
** Fixed issue when downloading a single cover, the custom cover would be removed.
** Fixed issue when downloading a single cover, the custom cover would be removed.
** Search and rename keyboard set to latin, as non latin characters don't seem to be supported.
** Search and rename keyboard set to latin, as non latin characters don't seem to be supported.
* Note  
* Note:
** PS1 and PSP titles will change as the names are now coming from the game's sfo files rather than a database lookup.
** PS1 and PSP titles will change as the names are now coming from the game's sfo files rather than a database lookup.
** You can rename titles within the app if there's some you want to change.
** You can rename titles within the app if there's some you want to change.
* Translations  
* Translations:
** If you would like to contribute to improving translations, please submit an issue or pull request.
** If you would like to contribute to improving translations, please submit an issue or pull request.
** Bulleted list item
** Bulleted list item
Line 322: Line 168:


'''4.0.2'''
'''4.0.2'''
New
*New:
*RetroArch PS1 support added. (Adrenaline still recommended over RetroArch for PS1)
**RetroArch PS1 support added. (Adrenaline still recommended over RetroArch for PS1).
 
*Bug fixes:
Bug fixes
**Fixed a small percentage of games not showing due to filename filtering.
*Fixed a small percentage of games not showing due to filename filtering.
**Fixed error on scanning when a file has no extension (retro systems), those files are now excluded from the scan.
*Fixed error on scanning when a file has no extension (retro systems), those files are now excluded from the scan.
**Fixed app name titles crashing into the footer text for one of the game view options (long names masked with a gradient).
*Fixed app name titles crashing into the footer text for one of the game view options (long names masked with a gradient).
**Battery icon repotioned slightly.
*Battery icon repotioned slightly.
*Note:
 
**More info on setting up the RetroArch PS1 core (PCSX ReARMed) here: https://docs.libretro.com/library/pcsx_rearmed/.
Note
*More info on setting up the RetroArch PS1 core (PCSX ReARMed) here: https://docs.libretro.com/library/pcsx_rearmed/
 
'''Full list of changes can be found [https://github.com/jimbob4000/RetroFlow-Launcher/releases here].'''
 
== Credits ==
* Original [https://github.com/VitaHEX-Games/HexFlow-Launcher HexFlow] app by : '''VitaHex Games'''
* Programming/UI: '''Sakis RG'''
* Developed with [http://rinnegatamante.github.io/lpp-vita/ Lua Player Plus] by '''Rinnegatamante'''


==Special Thanks ==
Full list of changes can be found [https://github.com/jimbob4000/RetroFlow-Launcher/releases here].
* '''Creckeryop'''
* '''andiweli''' ([https://github.com/andiweli/hexflow-covers HEXFlow Covers database])
* '''DRok17''' for his work on bubble builders.
* '''Rinnegatamante''' for tips and support with Lua.
* '''Leecherman''' for his work on AdrBubbleBooter and the [https://sites.google.com/site/theleecherman/PSPISORenamer PSP ISO Renamer]
* '''BlackSheepBoy69''' for sharing tips and code from [https://github.com/BlackSheepBoy69/HexFlow-Launcher-Unofficial-Custom HexFlow Launcher Unofficial Custom]


== Translations ==
==Credits==
* French - @chronoss
* Original [https://github.com/VitaHEX-Games/HexFlow-Launcher HexFlow] app by VitaHex Games.
* German - @stuermerandreas
* Programming/UI Sakis RG.
* Spanish - @kodyna91
* Developed with [http://rinnegatamante.github.io/lpp-vita/ Lua Player Plus] by Rinnegatamante.
* Italian - @TheheroGAC
* Russian - @_novff
* Portuguese - @nighto
* Japanese - @iGlitch
* Chinese - @acd13141
* Polish - @SK00RUPA


== Polite notice ==
Special Thanks:
Please note that I'm not a developer, this mod started as a personal project, please be mindful that there may be some redundant code, or some requests that will be beyond my knowledge to implement. Please feel free to build upon the mod as long as you provide credit to the original HexFlow developer and the people who contributed to the project.
* Creckeryop
* andiweli ([https://github.com/andiweli/hexflow-covers HEXFlow Covers database]).
* DRok17 for his work on bubble builders..
* Rinnegatamante for tips and support with Lua..
* Leecherman for his work on AdrBubbleBooter and the [https://sites.google.com/site/theleecherman/PSPISORenamer PSP ISO Renamer].
* BlackSheepBoy69 for sharing tips and code from [https://github.com/BlackSheepBoy69/HexFlow-Launcher-Unofficial-Custom HexFlow Launcher Unofficial Custom].


== Support ==
Translations:
* If you want to support VitaHex's work you can become a [https://www.patreon.com/vitahex Patron].
* French - @chronoss.
* PayPal option is also available [https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=RM8ECMVYMTXGJ&source=url HERE]
* German - @stuermerandreas.
* [https://twitter.com/VitaHex VitaHEX Twitter]
* Spanish - @kodyna91.
* [https://vitahex.weebly.com/ VitaHEX Official Page]
* Italian - @TheheroGAC.
* Russian - @_novff.
* Portuguese - @nighto.
* Japanese - @iGlitch.
* Chinese - @acd13141.
* Polish - @SK00RUPA.


== External links ==
== External links ==
* Official Website - https://github.com/jimbob4000/RetroFlow-Launcher
* GitHub - https://github.com/jimbob4000/RetroFlow-Launcher
* Github - https://github.com/jimbob4000/RetroFlow-Launcher
* VitaDB - https://vitadb.rinnegatamante.it/#/info/745
* VitaDB - https://vitadb.rinnegatamante.it/#/info/745

Revision as of 03:20, 16 December 2022

RetroFlow Launcher
File:Retroflowlaunchervita.jpg
General
Authorjimbob4000 & VitaHEX games
TypeTitle Launchers
Version5.0.2
LicenseMIT License
Last Updated2022/12/01
Links
Download
Source

RetroFlow Launcher is a modded version of HexFlow Launcher; a 3d coverflow like launcher for PS Vita.

This version includes categories for retro games which can be launched without bubbles for RetroArch, DaedalusX64 and Flycast.

Playstation and PSP games can also be launched without having to create bubbles for every game.

Features

  • No need to create bubbles for games.
  • Retro game categories added.
  • Favourite games category.
  • Recently played category.
  • Ability to search for games.
  • Ability to rename games.
  • Support for game backgrounds images.
  • Support for multiple music tracks.
  • Support for multiple wallapers.
  • Load from cache for faster startup.
  • File browser added for setting up game directories.
  • Fully translated.

Installation

Install the RetroFlow VPK's:

Install any other necessary apps:

Check your PS1 and PSP are in the right Adrenaline folders:

  • PS1 and PSP games with eboot files should be saved here: ux0:pspemu/PSP/GAME/.
  • PSP ISO and CSO games should be saved here: ux0:pspemu/ISO/.
  • uma0, ur0, imc0 and xmc0 partitions are also supported.
  • The partition you use for Adrenaline will also need to be selected in the 'Scan settings' in RetroFlow.
  • Tip: PS1 games can also be launched using RetroArch, helpful for games which don't run well in Adrenaline.

User guide

Supported systems

PS Vita, PSP, Playstation, Nintendo 64, Super Nintendo, Nintendo Entertainment System, Game Boy Advance, Game Boy Color, Game Boy, Sega Dreamcast, Sega CD, Sega 32X, Sega Mega Drive / Genesis, Sega Master System, Sega Game Gear, PC Engine, PC Engine CD, TurboGrafx-16, TurboGrafx-CD, Commodore Amiga, Commodore 64, WonderSwan, WonderSwan Color, MSX, MSX2, ZX Spectrum, Atari Lynx, Atari 600, Atari 5200, Atari 7800, ColecoVision, Vectrex, FBA 2012, MAME 2003 Plus, MAME 2000, Neo Geo (FBA 2012) and Neo Geo Pocket Color.

Add your retro games to RetroFlow

For best results it's recommended that your games are named using the no-intro file naming convention, e.g. "Game Name (USA)", these names are used to download matching cover images.

Option 1 - Use the default folders

  • Launch RetroFlow for the first time, RetroFlow will create the folders where you can save your games.
  • Once it's finshed loading; close RetroFlow and copy or move your favourite retro games into the relevant game subfolders here: ux0:/data/RetroFlow/ROMS/.

Option 2 - Use your own game folders

  • If you don't want to save your games in the RetroFlow data folder, you can use your own directories.
  • Go to 'Scan settings' and then "Edit game directories" to change the path to game folders.
  • Once you are done, select "Rescan" to find the games.

Disc based games

  • PC Engine CD and TurboGrafx-CD: RetroFlow will look for .cue files for these CD systems. Please make sure all the games are loose with the system's rom folder with .cue files.
  • Dreamcast: .gdi and .cdi games are supported.
  • PS1 using RetroArch - They will use the 'PCSX ReARMed' core, more information on supported extensions here.
  • Note: If you're using an old version of RetroFlow (below v5) you will need to rename PSP and maybe PS1 games too, please see: Legacy guide - Renaming PSP and PS1.

Rescan to find your games

Press Start and go to "Scan Settings", select your Adrenaline location, and if you are using custom game folders, select those too, then select "Rescan".

Your retro games should now appear when you restart the app.

"Startup scan" can be turned off once you have finished adding your games, the app will startup faster when it's turned off.

Download covers and backgrounds

To download cover images, press start, go to "Artwork" then choose which covers or backgrounds you would like to download.

From version 5 onwards you can also extract background images for PSP games from PSP iso files.

Screenshots

Media


Changelog

5.0.2

  • Improvements:
    • Adrenaline bubbles using 'PSPEMU' as titles are now excluded from the app.
    • (The games used for the bubbles will still be included in the PSP or PS1 category).
  • Bug fixes:
    • RetroFlow Adrenaline Launcher - Corrected the LiveArea startup image position.
    • Install the v3 vpk in this release or alternatively, once you have installed the 5.0.2 vpk you can install it from the app directory here:
    • ux0:/app/RETROFLOW/payloads/\nRetroFlow Adrenaline Launcher.vpk.

5.0.1

  • New:
    • Categories Lite support for Adrenaline.
  • Bug fixes:
    • More robust filtering for bad sfo files.
    • Fixed image error when overriding category.
  • Pre-release:
    • This version will be updated incrementally with bug fixes until fully released.

5.0.0

  • New:
    • No longer need to rename PSP games - PSP and PS1 game titles are now extracted from iso, cso and pbp files.
    • Extract PSP background images - New option to extract PSP background images from iso files rather than downloading in-game screenshots.
    • New loading screen - Progress bar added to loading / scanning screen.
    • New help section - Replaced the 'About' screen with a help section for general setup etc. (Also now fully translated). Press start then triangle to view the help section.
    • Adrenaline - Added support for ur0, imc0 and xmc0 partitions.
    • New Control - DPad Down + Square: Go back one category.
    • New Control - DPad Down + L/R triggers: Skip games alphabetically.
    • New Languages - Dutch, Danish, Finnish, Norwegian, Turkish, Korean, Chinese (Simplified).
  • Improvements:
    • Language - Operating system language is checked the first time the app is opened and a matching language is set if available.
    • Language - Additional fonts added for Korean, traditional and simplified Chinese.
    • Renaming - When renaming a game, RetroFlow will now check for the cover and update if found.
  • Bug fixes:
    • Fixed issue when downloading a single cover, the custom cover would be removed.
    • Search and rename keyboard set to latin, as non latin characters don't seem to be supported.
  • Note:
    • PS1 and PSP titles will change as the names are now coming from the game's sfo files rather than a database lookup.
    • You can rename titles within the app if there's some you want to change.
  • Translations:
    • If you would like to contribute to improving translations, please submit an issue or pull request.

4.0.3

  • New:
    • No longer need to rename PSP games - PSP and PS1 game titles are now extracted from iso, cso and pbp files.
    • Extract PSP background images - New option to extract PSP background images from iso files rather than downloading in-game screenshots.
    • New loading screen - Progress bar added to loading / scanning screen.
    • New help section - Replaced the 'About' screen with a help section for general setup etc. (Also now fully translated). Press start then trinagle to view the help section.
    • Adrenaline - Added support for ur0, imc0 and xmc0 partitions.
    • New Control - DPad Down + Square: Go back one category.
    • New Control - DPad Down + L/R triggers: Skip games alphabetically.
    • New Languages - Dutch, Danish, Finnish, Norwegian, Turkish, Korean, Chinese (Simplified).
  • Improvements :
    • Language - Operating system language is checked the first time the app is opened and a matching language is set if available.
    • Language - Additional fonts added for Korean, Chinese traditional and Chinese simplified.
    • Renaming - When renaming a game, RetroFlow will now check for the cover and update if found.
  • Bug fixes:
    • Fixed issue when downloading a single cover, the custom cover would be removed.
    • Search and rename keyboard set to latin, as non latin characters don't seem to be supported.
  • Note:
    • PS1 and PSP titles will change as the names are now coming from the game's sfo files rather than a database lookup.
    • You can rename titles within the app if there's some you want to change.
  • Translations:
    • If you would like to contribute to improving translations, please submit an issue or pull request.
    • Bulleted list item

4.0.3

  • Adrenaline - Added support for ur0, imc0 and xmc0 partitions. (ux0 and uma0 were already supported).

4.0.2

  • New:
    • RetroArch PS1 support added. (Adrenaline still recommended over RetroArch for PS1).
  • Bug fixes:
    • Fixed a small percentage of games not showing due to filename filtering.
    • Fixed error on scanning when a file has no extension (retro systems), those files are now excluded from the scan.
    • Fixed app name titles crashing into the footer text for one of the game view options (long names masked with a gradient).
    • Battery icon repotioned slightly.
  • Note:

Full list of changes can be found here.

Credits

  • Original HexFlow app by VitaHex Games.
  • Programming/UI Sakis RG.
  • Developed with Lua Player Plus by Rinnegatamante.

Special Thanks:

Translations:

  • French - @chronoss.
  • German - @stuermerandreas.
  • Spanish - @kodyna91.
  • Italian - @TheheroGAC.
  • Russian - @_novff.
  • Portuguese - @nighto.
  • Japanese - @iGlitch.
  • Chinese - @acd13141.
  • Polish - @SK00RUPA.

External links

Retrieved from ‘https://www.gamebrew.org/index.php?title=RetroFlow_Launcher_Vita&oldid=101731’

Advertising: