Jump to content
thatman84

(Tutorial) Hyperspin Android Overview and Install

Recommended Posts

Hyperspin Android Overview & Installation

Credits

BBB

Reznate

Thatman84

Lilcza

And anyone I have forgotten helped me learn this

My guides are only an extension of Reznnate's sticky posts

PLEASE READ the OTHER sticky posts

 

What is it?

An Android version of Hyperspin that works with existing themes and data directly from the Hyperspin community.   It launches both Android games and Android emulators.

 

Why?

Several reasons...    

  1. Android hardware is getting faster and faster.    
  2. Emulators for Android are getting better and better.    
  3. We wanted to play with our Hyperspin setups outside the house.    
  4. I wanted to replace the old PC in my MAME cabinet with a mobile device so I could justify leaving it on all the time.  
  5. It needed the ultimate launcher!!!

 

How?

Since the Windows version of Hyperspin is dependent on Adobe Flash, it was necessary to build the app from scratch. With performance in mind, the Android version is highly-threaded and renders with the GPU using OpenGL.

 

 

Compatibility

 

 

 

 

Hyperspin/Android Limitations

 

RocketLauncher is not available for use on Android but the settings files it uses within a PC setup are compatible.
 

  • Vertical Systems/Wheel list only
  • No Touch Screen Input (Controller required)
  • Favourites list feature not supported
  • Genre feature not supported
  • Searching subfolders for ROM’s not supported
  • Games list only supports launching of one emulator (multiple emulators can exist in settings line and the 1st one installed will be launched)
  • PC based animations and themes not fully functional. See this detailed post HERE

 

 

 

Never used Hyperspin before?

 

As Hyperspin Android was originally designed to allow PC users to have another way to experience their setup you will need to first decide how you would like to proceed with your Hyperspin Android setup

**Skip to Installation section if NOT using a PC**

 

 

  1. The easiest way is to  install the PC version for testing and building your Android setup (Follow Avar’s official tutorial videos HERE or follow step by step guides HERE
  2. Alternatively build your Hyperspin Android setup from iOS computer or directly from your Android device.

 

Already using Hyperspin on a PC?

You can co-exist your PC and Android Hyperspin setups in one Hyperspin folder by making the following additions.

 

  • Optional additional database file called "Main Menu_Android.xml". Located in your Hyperspin/Databases/Main Menu folder. This will allow for a specifically tailored Main Menu for your Hyperspin Android setup

1 Main Menu_Android xml.png

 

  • Optional additional settings folder called /Settings_Android. Located in your Hyperspin directory and populated with your Android specific Main Menu.ini, Settings.ini and SYSTEMNAME.ini’s. This allows both Windows and Android launcher/rompaths to co-exist in separate .ini files within the same Hyperspin directory.

2 Settings_Android Folder.png

 

**Note

Some of your PC Themes and features may not be compatible with your Android setup so it may pay to build a specific Hyperspin folder for your Android setup. If you take this opportunity to trim unneeded files to save storage space it will likely mean some 3rd party tools (Don’s Filter list and Hypertools) may not function correctly.

 

Also adjustments to your Android set of settings will need to be done manually with a text editor

 

 

 

 

Installation

 

What’s Needed:

  1. A file explorer installed on your Android device (ES File Explorer in this case)
  2. Optional: PC to make life easier

Step 1 – App Installation

Note: The device you are using and your chosen Hyperspin folder location (local, sdcard, external HDD or NAS) will directly affect your steps and settings file values

All testing was done on my NVIDIA Shield TV Pro 3.2 Marshmallow 6.0, slight differences may be found on other devices

                                                                     

  1. On your device open Google Play Store and search for Hyperspin

Hyperspin App Store.png

 

       2. Install as any other Play Store app, accepting all permissions when prompted

 

You will now see the Hyperspin app in you devices menu

Hperspin App Installed.png

 

 

Step 2 – Build your Hyperspin directories

To function, Hyperspin pulls all data from an installation folder NOT included with the app installation. Without this directory you will see the below screen when trying to launch Hyperspin

No HS Folder.png

Note: New users without a Hyperspin directory and not installing a PC version of Hyperspin please download

 

 Hyperspin Android base pack

(Adjusted from BBB's Hyperspin 1.3.3 file)

Existing users please locate your PC Hyperspin directory and copy this to the root of your preferred storage device (USB, SD card, internal storage or NAS) see below details.

 

 

But First...

 

Decide on Storage Media & Location...

 

I will now show you how to install Hyperspin onto the internal storage of your Android device. You are free to place your Hyperspin directory on a different storage device, including SD cards, USB storage and Network Attached Storage (NAS), but please be aware Hyperspin will seek and prioritize booting 1st from

 

/usbdrive/Hyperspin

then

/sdcard1/Hyperspin

then

/sdcard/Hyperspin

for your data.

 

Also note that on the Shield TV Pro /storage/Emulated/0 & /storage/sdcard are in fact the same location

 

If you will be using a NAS to store your Hyperspin directory, please be aware that there can only be one directory level between your devices /storage directory and your Hyperspin directory. For this to work, you will need to share your Hyperspin folder from your NAS device and the map that device to you Android device through its storage settings. It should then be seen in your devices /storage folder (I will cover this in detail in subsequent tutorials)

 

Example of correct NAS Path:-           /storage/MYNAS/Hyperspin

Example of incorrect NAS Path:-        /storage/MYNAS/SUBFOLDER/Hyperspin

 

My TEST path screenshot

  1. Is my Local device directory /storage
  2. Is the name of my NAS Drive sdcard1

1 NAS Path.png

 

Next – Get a file explorer

 

I Installed ES File Explorer (ESFE) by searching ES in your Play Store app and install as any other.

 

Play Store ESFE.png

 

A.        

Launch ESFE and navigate to the 1) Local then 2) Home - option. Place your Hyperspin folder here 3)

 

Local Hyperspin Folder Edit.png

 

 

Note: For a HSA to work the ONLY required files/folders for an Android installation are as follows

/Hyperspin

/Databases

/Media

/Settings

/Emulators (optional ROM location structure for ease of setup)

 

B.

Please now exit to your home screen and launch the Hyperspin App, to test everything is correct. Depending on your correct choice of Hyperspin directory you should now be greeted with the Hyperspin intro video and your Main Menu wheel of systems.

 

The base pack download will look similar to this example.

 

Default HS.png

 

This is what you get with the default Hyperspin 1.3.3 version I have adjusted

 

 

Now you have completed the basic installation there are some settings that require adjusting and reviewing to enable games to be launched.

Also the per system/wheel settings are covered here

 

  • Upvote 6

Share this post


Link to post
Share on other sites

Well done Thatguy, I'm sure this will be a great help to those who are struggling with Android.

  • Upvote 1

Share this post


Link to post
Share on other sites

Well done Thatguy, I'm sure this will be a great help to those who are struggling with Android.

Just me then! Lol

Share this post


Link to post
Share on other sites

There is badhemi'S set of about 86 systems in the Nividia beginners guide thread and also Reznates set of about 40 in the downloads section.

There is also a blank ini file in the

Anyone feel free to post up settings as settings will be my next focus.

There really is not many settings to change in the android version and big sets can leave odd problems I am aiming to overcome if possible.

Share this post


Link to post
Share on other sites

Cool JSK

Nice one badhemi, did you ever put your settings in the Upload section? If not I don't see why really. They are the biggest set I have come across

Share this post


Link to post
Share on other sites

Cool JSK

Nice one badhemi, did you ever put your settings in the Upload section? If not I don't see why really. They are the biggest set I have come across

no I didn't. Not sure where to do it

Share this post


Link to post
Share on other sites

The only space I see for these is templates. That is where my base pack is.

As they can't be used directly on the PC or with RocketLauncher

If your ok with it badhemi I will take your settings files and do the following for release.

1. Strip out RocketLauncher parameters

2. Set all filters to false

3. Set all indexes to true

4. Default any custom positions

5. Adjust the rompath to uniform location except those that require specific (MAME softlists)

This should give anyone new a solid and simple base to start with.

I have a vanilla set of about 217 so will basically copy the rompath, exe and parameters out.

You have any problems with reload_backgrounds. I have seen that issue pop up. I don't have transitions and I think that's to option for them.

Share this post


Link to post
Share on other sites

Updated Base pack with Badhemi's settings files

 

Currently porting the tutorial over from word to the forum

Share this post


Link to post
Share on other sites

So I don't suppose rezznate or whatever his name is ever added the ability to define different themes to be used for the Android version? A lot of my themes don't work on the android version and I definitely don't want to switch them just for android and make my PC themes be different. Was hoping putting those files on the internal of the shield would override what was on the external drive but it seems the external is taking priority.

Share this post


Link to post
Share on other sites

Im fairly certain defining different themselves is not possible.

Hyperspin prioritises usb 1st

Are you using game themes?

Share this post


Link to post
Share on other sites

Bummer that sucks. Using default themes which makes use of swf files, don't care about game themes. Wish he would have made some options like before giving up on the program, I'm not going to "degrade" my PC install for the android version.

Share this post


Link to post
Share on other sites

Well that's not so bad then.

I have a process to convert the themes which works well depending on the animation used.

Sounds like you would be best creating a copy of your Hyperspin setup and adjusting the media for android. Then leave the rompath pointing to wherever it is. May be hard if your swapping a drive between droid and PC

(Reznate has done a great job getting it this far, but yes an update would be awesome. Developers are hard to come by on Android, I think it's the main reason for stagnation)

Share this post


Link to post
Share on other sites

Nah, I don't wanna break/lessen themes for PC just for Android. My Hyperspin for PC resides on my drive in the root in the Hyperspin folder, I would rather not have to rename that as I have a lot of other stuff dependent on that path. Oh well though, will drop Android until the day he may issue an update. Probably around the same time HS PC will get one =P

Share this post


Link to post
Share on other sites

So I don't suppose rezznate or whatever his name is ever added the ability to define different themes to be used for the Android version? A lot of my themes don't work on the android version and I definitely don't want to switch them just for android and make my PC themes be different. Was hoping putting those files on the internal of the shield would override what was on the external drive but it seems the external is taking priority.

what do you mean by your themes dont work? What's it doing?

Share this post


Link to post
Share on other sites

badhemi cheers for the themes any chance you could share your ini files too. PLEASE

Post #9 has badhemi's settings files link and it you look at the android base pack linked in first post you will find a cleaned up version with all RocketLauncher and filter preference's removed. For I hope easier setup.

Share this post


Link to post
Share on other sites

​Thanks thatman84 i have that pack but some ini files are missing and these are the ones i need like GOG,Popcap,Bigfish Games.I have fifty systems set up with media.Forty seven systems working so far and counting thanks to this forum 

Share this post


Link to post
Share on other sites

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.

Guest
Reply to this topic...

×   Pasted as rich text.   Paste as plain text instead

  Only 75 emoji are allowed.

×   Your link has been automatically embedded.   Display as a link instead

×   Your previous content has been restored.   Clear editor

×   You cannot paste images directly. Upload or insert images from URL.


  • Similar Content

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