Jump to content
HyperSync, HyperList and FTP are now back online ×

Archived

This topic is now archived and is closed to further replies.

thatman84

(Tutorial) Using Games In Subfolders - "Folder Trick"

Recommended Posts

Setting Up Systems That Have/Need Games In Subfolders

Credits
loueradun
brentg

This guide requires the text editor Notepad++
https://notepad-plus-plus.org/

NOTE
A PC IS REQUIRED

Why? - HSAndroid doesn't support games stored in subfolders directly

There are a few systems that "need" games to be stored in subfolders, to retain specific rom file names and structure (ScummVM, Quake collection etc) and some that you really should organise games into subfolders to save a world of renaming "full sets" (Playstation or any large CD based system with bin/cue files or alike).

This thread was the source of this information and IS a very welcome tip for any HyperSpin Android user (I should have done this post long ago...)

 

Side Effects...

The main side effect of doing this trick means all media needs to be stored in subfolders...It's a simple fix but will take a little extra work on your part. (Much less than renaming everything imo)

The knock on side effects are...

  • Custom database is required.
  • The roms_only filter doesn't function

How?
1. For CD based systems like PS1

Note.
For more information on databases refer to the
Tutorial Section Here.
There are tools availiable for creating databases from your rom folders automatically. You will be missing all meta data but its up to. I personally dont create databases this way but have used
Don's Tools Here to do it before. Other apps may be better... See 3rd Party Apps Here

Step 1
Your game folders along with the game file Hyperspin launches (i.e. .CUE files) must be named as stated in the xml or vice versa, as per normal Hyperspin setups require.

 

Screenshot (263).png

Step 2

Once your files are renamed and organised as required you will need to open the .xml database in Notepad++

  • Hit control "ctrl f" to open the "Find" console
  • Choose the Replace tab (or navigate to Search=>Replace from the menu)

 

Under "Find What:" input

(?<=\<game name=\")(.*?)(?=\")

Under "Replace With:" input

$0/$0

And finally make sure "Regular expression" is marked in the Search ModeScreenshot (265).png

Click "Replace All" then save your file.

 

Exampl Output Database Entry

Note "game name" is repeated twice. "Blockids (USA)/Blockids (USA)"

</game>
	<game name="Blockids (USA)/Blockids (USA)" index=""  image="">
		<description>Blockids (USA)</description>
		<cloneof></cloneof>
		<crc></crc>
		<manufacturer>Natsume</manufacturer>
		<year>2003</year>
		<genre>Puzzle</genre>
		<rating>ESRB - E (Everyone)</rating>
		<enabled>Yes</enabled>
	</game>
	<game name="Blood Lines (

Tip

If you want to reverse these settings, use these values for the regex:

(?<=\<game name=\")(.*?)/(.*?)(?=\")
$1

One thing to note is that the regex is searching for the string <game name=" and stops when it sees the next double quote so if you have any additional spaces or a name is not the first attribute on the game element in the xml then it won't find the right string.

 

2. For Systems like Quake (Tyrquake core in RetroArch)

As the Quake Collection has different names for Game Folders and Game Files you would need to manually create the entries in the database.

So long as you put the "folder/gamefile" under the <game name= tag everything will work correctly.

Screenshot (267).png

 

Step 3 - Organising your media

As I mentioned before ALL of your "per game" media will need to be sorted into their own folder to be of any use.... The database is looking for files inside a folder named the same as the file :confused:

  • Wheel Art
  • Box Art/Cart Art (Basically anthing in the Artwork 1 to 4 folders)
  • Videos
  • Game Themes (default.zip theme EXCLUDED)

For Collections like Quake some games are named the same (PAK0.pak)....In this case you will probably have to manualy organise the media or manually rename it to match the xml.

 

There are many methods of doing this in batch format. The quickest method I have found is a Program by EmuMovies user Tempest.

https://emumovies.com/files/file/597-roms-in-and-out-of-folders/

MAKE SURE YOU READ THE RELEASE POST.
It will put EVERY file into a folder so only run it on a folder thats artwork only
(There is a reverse program included)

Quick Steps...

  1. Download the file (linked above) and unzip it.
  2. Copy the "Put Roms in Folders.exe" in to your artwork folder
  3. Double click
  4. Rince and Repeat for all types of game media you have

File2Folder1.png

File2Folder2.png

Alternativley you can use WinRAR to zip everything then unzip all files to their own folder.

Or another program that adds a shell extension to your right click menu

http://www.dcmembers.com/skwire/download/files-2-folder/

Another program I have that will browse to your directory is "File_in_Folder_Renamer.exe" but I cant find a link for that.

Share this post


Link to post
Share on other sites

Respekt for writing up "the folder trick" as I like to call it. As you well know, I just pointed people to that PS thread you have given credit to.

Yes unfortunately ALL media needs to be stored in subfolders and that includes the unique game themes we sometimes use, rather than just the "default.zip" in the themes folder.

Is there a thread/guide for creating a custom database that could be added as a link in the OP? A custom database  (of just the games we want) is required as we MUST set "roms only=false" in the filters section of the .ini file for the system. Meaning ALL games are shown from the XML whether we have the game or not. If it's set to "roms only=true" nothing will display whether you have the games or not and you will just get kicked back to the main menu of Hyperspin.

Yes this trick makes doing the system more "tricky" BUT it's not really that difficult once you get the hang of it. Fine work my friend :)

 

Share this post


Link to post
Share on other sites
1 hour ago, Honosuseri said:

Respekt for writing up "the folder trick" as I like to call it. As you well know, I just pointed people to that PS thread you have given credit to.

Yes unfortunately ALL media needs to be stored in subfolders and that includes the unique game themes we sometimes use, rather than just the "default.zip" in the themes folder.

Is there a thread/guide for creating a custom database that could be added as a link in the OP? A custom database  (of just the games we want) is required as we MUST set "roms only=false" in the filters section of the .ini file for the system. Meaning ALL games are shown from the XML whether we have the game or not. If it's set to "roms only=true" nothing will display whether you have the games or not and you will just get kicked back to the main menu of Hyperspin.

Yes this trick makes doing the system more "tricky" BUT it's not really that difficult once you get the hang of it. Fine work my friend :)

 

Thanks for the extra info dude. I went through the process of renaming all my sets so only used this for Quake and now scrummvm (unfinshed).

I can link the DB guides in the tutorials section and update the side effects with themes & rom filter :)

Share this post


Link to post
Share on other sites

Yes I'm the same. Renamed my PS 1 images and they are in one folder not sub folders. I have used this trick for a few systems though, can't recall them all off the top of my head. Yes Doom Classics, the Quake Collection & ScummVM are amongst them.

Happy to provide the extra info. Figured it made sense for "noobs" to have a link from here, so they know how to make a gamelist xml for only the games they want shown.

Share this post


Link to post
Share on other sites
On 23/04/2018 at 8:12 AM, Honosuseri said:

Respekt for writing up "the folder trick" as I like to call it. As you well know, I just pointed people to that PS thread you have given credit to.

Yes unfortunately ALL media needs to be stored in subfolders and that includes the unique game themes we sometimes use, rather than just the "default.zip" in the themes folder.

Is there a thread/guide for creating a custom database that could be added as a link in the OP? A custom database  (of just the games we want) is required as we MUST set "roms only=false" in the filters section of the .ini file for the system. Meaning ALL games are shown from the XML whether we have the game or not. If it's set to "roms only=true" nothing will display whether you have the games or not and you will just get kicked back to the main menu of Hyperspin.

Yes this trick makes doing the system more "tricky" BUT it's not really that difficult once you get the hang of it. Fine work my friend :)

 

Updated OP....Default.zip theme works fine in the Quake collection but yes games themes need to be in subfolders.

I know you may not be getting this :)

Now to start the folder organising thing. Need to get this and Quake mods wrapped up.....TO MANY unfinished projects!

 

Share this post


Link to post
Share on other sites

  • Similar Content

    • By Honosuseri
      Right guys as some of you are aware Google changed how things work on the Google Play Store a while back, when we install an app it will use the 32 or 64 bit version depending on what's native to the device. As we're mainly focused on the Shield TV here on the Android part of the forum, it is a 64 bit device. This has proved to be a bit of an issue for those of us who love Retroarch as there are some serious differences between the 32bit and 64bit versions. In a nutshell currently we have access to more cores for us to play our retro systems on the 32 bit version. RetroArch provide a RetroArch_ra32.apk which is a dedicated 32bit version we can sideload/install and use, however Hyperspin is NOT setup to use this version as some of the paths changed.

      So...I decompiled the Hyperspin.apk and made the necessary changes (yes including the config path) to solely use RA_32. I've done some limited testing with RA_32 (1.8.7) and it seems a okay to me (even the Daphne test core works) however I don't use screen overlays or really bother with alternate config setups (in truth I've not used the STV in many months!). Feel free to download it and test yourselves, obviously backup your essential files AND do remember the .ini files need to be adjusted to use RA32....

      exe=com.retroarch/com.retroarch.browser.retroactivity.RetroActivityFuture
      becomes
      exe=com.retroarch.ra32/com.retroarch.browser.retroactivity.RetroActivityFuture

      It's easy enough to open all your .ini files with notepad++. Use the Search and replace feature to find com.retroarch/ and replace to com.retroarch.ra32/ do this for all opened files then save all.

      Those who use adopted storage it's wise to move the Retroarch_ra32 app to internal storage after installing AND before running it for the first time. Let me know how it works for you, I'll do a Youtube video to help those less experienced with setting up Hyperspin when I know it's working 100% and I have the free time.

      Mega Link for Hyperspin_0.1.8_Hono.apk (https://mega.nz/file/zQNBCYKI#QVrG4uVVmvXHshl8LbosQi7LAjQmUA09R5k_YqhcMBI)
      RetroArch_ra32 (1.8.8) newest stable version at time of posting (http://buildbot.libretro.com/stable/1.8.8/android/)
    • By Wandurlust
      Hi all, It seems retroarch (at least on android) has removed their Mupen64plus core and replaced it with Mupen64plus-next. My hyperspin (Nvidia shield) won't launch N64 games anymore because it's trying to launch a core that no longer exist. I have tried editing my "Nintendo 64.ini" file with multiple variations to get the new core to launch, but I cannot get it to work. Anyone know the new core parameters off hand? I've searched quite a bit and am coming up empty.  Just to clarify I'm looking for the "Parameters =" line under the exe= that determines which core retro arch will use. I have confirmed manually loading the "Mupen64Plus-Next" core works with content. I just can't seem to get the command line correct to have it launch from hyperspin. Any help is appreciated thanks! I have already switched to it launching "Mupen64 FZ" in the meantime, but I prefer the launch coming from retroarch because FZ resumes mid-game where you left off when starting from hyperspin, and I prefer the WOW factor of games loading from the title screen.
    • By Honosuseri
      I realise there is already a thread for the Commodore Amiga in the Android section. I should know, as of late I've essentially taken it over! It's one of the most viewed threads in the Android section, so clearly many of you adore the Amiga as much as I do. 
      That thread has become quite long and it's quite confusing with people choosing to emulate the Amiga in different ways. I decided it would be best to start my own thread, streamlining it to show the best way to get this done. As I do have a "proof of concept" setup working! 
      This project I've taken on is a mammoth undertaking, as the Amiga is quite a complicated system to do. I'll try to explain why and how I've decided to proceed, keeping you guys up to speed with my progress here. 
      The first real issue is the naming that Hyperspin has been using for some time now. It's based from the Whdload zip file names, which was a logical choice BUT the problem is these zip names keep changing over time as they get updated. This throws the database entries and all media assets out of whack. It's my belief that this naming is what is really holding us back doing the Amiga justice.
      Second problem for us Android users anyway, is that we can't use the zip files directly with an emulator. They needed to be extracted out and we used a bootloader to patch the files for the emulator and launch the games. All seemed well and good until I started testing games and found many wouldn't work. Very confusing as the same game files worked fine from a workbench environment I'd set up, with it's own bootloader I added in. I suspected it was the "ultimate amiga" bootloader for the Hyperspin wheel at fault, which proved to be correct. 
      So the best way to launch these Amiga games from the Hyperspin wheel, is to actually use HDF versions of the games. This removes the need for the bootloader. I decided to keep the game folders extracted from the whdload zip files. Continuing to use these with the workbench (Amiga's OS) hdf I created. Having this is a nice nostalgic nod, I'm sure genuine Amiga fans will appreciate. 
      Unfortunately we can't just point the emulator to these hdf files, it's not that simple. Each game requires a config file that points to where the particular hdf game file is, what kick-start (i.e Bios) to use, video settings, control bindings etc. These files are known as uae files, as that is the extension we tell Hyperspin to look for. We trick it into thinking these uae's are the actual "game Roms".
      Sadly uae files aren't universal between emulators. So choosing the right emulator to begin with is important. Many people had chosen to use RetroArch. Which can't do the CD32, so I'll strike it off for that reason alone (although there are other reasons). I spent a long time waiting on Amiberry to be ported to Android but the devs haven't delivered. I'm not waiting any longer, so I'm continuing to proceed with Uae4arm. 
      As I write this, the latest version of Uae4arm crashes on Android TV (i.e Shield TV) but does run fine on Android phones. The devs are aware and trying to resolve this. There is an older apk version we can install for now, which does work. Another slight annoyance is that Uae4arm is quite fussy about how the uae files are named. They can NOT have special characters in them (e.g a space) or the emulator won't launch them!
      My next complaint was that Hyperspin has "rules" about what games should be included in the xml database file. I do NOT agree with these "guidelines". I want a definitive collection of Amiga games. 
      I've decided to branch the Amiga out into different wheels, ECS, AGA and CD32. As an analogy think of Sega's Megadrive and it's hardware addons. Megadrive=ECS, Sega32X=AGA (better graphics chipset on later Amigas) and finally the MegaCD=CD32 (better audio track and FMV).
      There is a "HDF game set" floating around. However... I got to know the creator, from doing videos on my proof of concept setup. I've persuaded him to rename the files to something more sensible, that should help other frontends scrape for metadata and artwork. These names will not change over time as he updates the collection. He does release notes, so this info can be used to keep the xml database file up to date. Currently he's overhauling the hdf files so they take up less storage and even adding cheat and trainer options to the loading splash screen....very cool stuff!
      I'm working on creating missing artwork (wheel, 3D box, diskette and video snaps), keeping busy until this new hdf collection is complete. Then I can start creating the uae files needed. This will be laborious, as Uae4arm doesn't do cycle exact emulation. I need to make sure each game is configured correctly to run at the proper speed, I'll also bind commonly needed keyboard keys to the gamepad on a per game basis.
      If you're confused, that's OK! It should all make sense, once I get around to uploading some more videos. Yes I will make my assets available to you all (minus the games obviously due to Hyperspin rules), once I'm happy with the collection.

      ***UAE4ARM BETA APK LINK***

      https://mega.nz/#!TYMQQKob!9pzwooQbkxVd-__mwmqtFWNF9JSR7D7rEgY8tqu31Vg
       
    • By Honosuseri
      Retroarch (Google Play) has updated itself to the latest version 1.7.8 and it seems to have broken compatibility with Hyperspin ?

      Having done some quick reading (https://www.libretro.com/index.php/retroarch-1-7-8-important-changes-for-people-using-the-google-play-build/) it seems under the "infinite wisdom" of Google. They're forced to build in both 32 and 64bit support for the app, so the device (Shield TV) will default to using the 64bit version as it is a 64bit device. I'm not entirely sure what's gone wrong as I haven't had time to delve further into it, although I know ZeroJay did a modded Hyperspin apk for 64bit support (that doesn't work either). Just wanted to warn users so they don't update and have any aggro.

      You can still side load 32bit versions of Retroarch, I'll do that later and test. I'm actually quite excited about some of the features that have now come in the latest version.

      ***EDIT***

      The retroarch_ra32.apk (v1.7.8) changes the path (typical). So it's now "exe=com.retroarch32/com.retroarch.browser.retroactivity.RetroActivityFuture". Hyperspin doesn't like this and it misbehaves as it did trying to load the original 64bit Google play version, which is why ZeroJay did the modified Hyperspin apk.
       
    • By thatman84
      Please note my knowledge of this system does not run deep but everything here works and plays fine.
      What is it?
      Capcom Play System III or CPS-3 is an arcade system board that was first used by Capcom in 1996 with the arcade game Red Earth. It was the second successor to the CP System arcade hardware, following the CP System II. It would be the last proprietary system board Capcom would produce before moving on to the Dreamcast-based Naomi platform.
      How to emulate in Android (Shield TV)
      Quick and simple way is with the FBA core of RetroArch and matching FBA romset.
      At time of writing current versions are:-
      Core:- FB Alpha v0.2.97.42 (commit 6b7a701)
      FBA:- 0.2.97.42 (9 July 2017)
      Other options are MAME core in RetroArch or MAME4Droid reloaded (0.139mame romset). I believe the CHD files are needed for some games and with MAME4Droid, at least,  I had to "install" the game when it 1st launched in the emulator. That process took about 20-30mins and not all worked. Redearth was one I tested and "installed".
      Games
      JoJo no Kimyouna Bouken: Miraie no Isan (Japan 990913) = (jojoba.zip)
      JoJo's Venture (USA 990108) = (jojo.zip)
      Red Earth (Euro 961121) = (redearth.zip)
      Street Fighter III 2nd Impact: Giant Attack (USA 970930) = (sfiii2.zip)
      Street Fighter III 3rd Strike: Fight for the Future (EUR 990608) = (sfiii3.zip)
      Street Fighter III: New Generation (USA 970204) = (sfiii.zip)
       
      Note:-
      I replaced this entry in the official database with the european version as I could not get it to launch in FBA.
      Street Fighter III 3rd Strike: Fight for the Future (USA 990608) = (sfiii3u.zip)
      EDIT:- USA version is working with RetroArch core version 0.2.97.44. Make sure you have the correct RomSet version
      Setup Steps...
      1.  Open RetroArch and download the Arcade (FA Alpha) core.
                                     Main Menu -> Online Updater -> Core Updater

      1a. Transfer your games to your prefered location (You only need the six zip files listed in the database and above)

      2. Add the "Capcom Play System III" system to your Hyperspin setup with HyperHQ on a PC and transfer the files/folder to your device or by manually creating all the relevent folders to your device. (Download at bottom of guide)
      3. Add Capcom Play SYstem III to your Main Menu.xml or Main Menu_Android.xml
      4. Add these lines to your Capcom Play System III.ini file found in Hyperspin/Settings/ or Hyperspin/Settings_Android/
      exe=com.retroarch/com.retroarch.browser.retroactivity.RetroActivityFuture
      romextension=zip
      parameters=cores/fbalpha_libretro_android.so
       
      PLAY SOME STREET FIGHTER .......................
       
      Extra Notes:-
      Under the FB Alpha "Quick Menu -> Options" you can select between different regions. Choosing a different region will give you the different loading screens along with other things I'm not sure about.
      Street Fighter III 3rd Strike (Default)Euro

      Street Fighter III 3rd Strike (USA)

       
      ANDROID MEDIA PACK AND DATABASE (Get your videos from emumovies.com)
      Hyperspin-CPS3Android.zip
       
       
×
×
  • Create New...