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 Honosuseri
      As we celebrate 25 years of DOOM! John Romero has brought us SIGIL, an unofficial 5th chapter to the original game. So as Retroarch's Prboom core has now been updated to support it...figured I should really add it to my Doom Classics wheel...
      Threw together a Sigil theme, wheel art and video snap. I was pleasantly surprised, that the prboom core now played the midi music natively. Doom 1&2 originally required me to add the music tracks as mp3 files. 
    • By thatman84
      (FYI having trouble with upping some screenshots and the new formatting so please excuse the wierd format)
      Converting 16x9 Themes for Hyperspin Android
      List of theme animation compatibility
      https://drive.google.com/folderview?id=1-8Ofa_GrAdnQ22nf7W7QYVeQoKBQxA_-
      (I am in NO way competent with artwork resolutions but my method works and looks good to me)
      Why...
      Because sometimes that theme you really liked just doesn’t display correctly 
      The main reason for theme problems is the use of animation and scripting of the .swf assets in the “theme”.zip
      (It’s best to replace themes that cause Hyperspin to crash out, but you can try to convert them)
       What’s covered...
             1.      Extract PNG assets from swf files
             2.      Reduce HQ artwork to be compatible with Hyperspin
             3.      Further reduce artwork width to allow for Hyperspin 4x3 -> 16x9 stretching
             4.      Recompile your theme
       
      What is Needed:
      Update on resizing tool.
            Fotosizer is now advised against because of the compression/quality loss it causes.
      pPlease use Photoshop or this program recommended by @IceLancer https://sourceforge.net/projects/easyimagesizer/?source=typ_redirect
      A    A  Fotosizer (http://www.fotosizer.com/) batch resize image files
              B.     Flash Decompiler (https://www.free-dec...flash/download/) extract png’s from swf
              C.     Time and Themes
       I have done a little testing for Main Menu themes. This spreadsheet shows what I have tested and its Android compatibility status. The sheet has download section links for all themes I have tried.
       
       
      Let’s get to it... 
       
      So grab a theme zip you want to play with and Unzip it. Any 16x9 Main Menu, Game or System Default theme will do.
       
       
      BakerMan provided me a guide to extracting the PNG’s from SWF but it has since been lost. 
      These are the steps
              1.      Open JPEXS once downloaded and installed from link above
              2.      Click on the “Open” tab and browse to the offending .swf file from your unzipped theme
       
           SCREENSHOT
      3.     
       

       

             3.      Right click on “Images” on the left and click “Export Selection”
      (At this step you may find multiple images. If these images are only parts of one image, say the arms and legs of a character, you will have to lose that image completely from the theme or replace it with another one)
       
      SCREENSHOT2
             4.      Click “ok” to PNG file type then choose a location for the exported images (Default is Desktop. Only export one at a time and  then move the PNG out of the output folder as it overwrites each one if not)
       
       
      SCREENSHOT3
             5.      Now browse to that Output location and you will find your PNG’s in an “images” folder.
       

       
      You are now ready for phase 2 – Resizing the images
      Note, fotosizer does cause a reduction in artwork quality. If your sensitive to this you may want to use another method. (If you know of a better program please comment) I only run a 37' screen and don't mind myself.
      (Resizing Artwork is covered comprehensively by Avar in his tutorials found HERE)
      Open Fotosizer Add the Artwork that was converted to PNG Reduce the images to 68% KEEP MAINTAIN ASPECT RATIO TICKED (this is the best size for the ones I have done)  
              4.       Move the right side settings bar down and select an Output Folder
       

      5   Remove that Artwork from Fotosizer
      6.   Add the newly resized artwork back into Fotosizer
      7.   Reduce the Width to 75% (to allow HS to stretch it back when its loaded)
      8.   UNTICK MAINTAIN ASPECT RATIO
       
             9.   Now add this finished art back into the theme folder and zip it up again
            
             10.       Name the zip file the same as you have it in the “Main Menu.xml” database
       
      Final Thoughts...
       
       
      Now when you try this theme out you may find the artwork has slightly changed location. If so adjust the Artwork positions in the theme.xml file within the theme.zip OR load it into Hypertheme and adjust it as required
       
       
      Hope this helps someone.
       
       
      HS Android Theme Animations.txt
    • By reznnate
      Tested Emulators -- .ini config settings   Retroarch - Various emulators   exe=com.retroarch/com.retroarch.browser.retroactivity.RetroActivityFuture  parameters=<choose one of the emulator cores like below>   Examples of retroarch core parameters Atari 2600 core:  parameters=cores/stella_libretro_android.so PSX core:  parameters=cores/pcsx_rearmed_libretro_neon_android.so   libretro cores:  4do_libretro_android.so  bsnes_mercury_performance_libretro_android.so  bsnes_performance_libretro_android.so etc...     Dolphin - Gamecube/Wii/Wiiware exe=org.dolphinemu.dolphinemu/org.dolphinemu.dolphinemu.activities.MainActivity parameters=AutoStartFile    Newer Builds from Dolphin Website:-   exe=org.dolphinemu.dolphinemu/org.dolphinemu.dolphinemu.ui.main.MainActivity parameters=AutoStartFile    IrataJaguar - Atari Jaguar  exe=ru.vastness.altmer.iratajaguar/ru.vastness.altmer.iratajaguar.MainActivity  parameters=rom   Real3DOPlayer - 3DO  exe=ru.vastness.altmer.real3doplayer/ru.vastness.altmer.real3doplayer.MainActivity  parameters=cd   NES.emu - NES  exe=com.explusalpha.NesEmu/com.imagine.BaseActivity  parameters=   MSX.emu - Colecovision, MSX, etc.  exe=com.explusalpha.MsxEmu/com.imagine.BaseActivity  parameters=   Mame4Droid - MAME  exe=com.seleuco.mame4droid/com.seleuco.mame4droid.MAME4droid  parameters=   Mupen64Plus AE exe=paulscode.android.mupen64plus/paulscode.android.mupen64plusae.MainActivity
      parameters=    Nightly builds exe=org.mupen64plusae.v3.alpha/paulscode.android.mupen64plusae.SplashActivity parameters=     Play! - Playstation 2 exe=com.virtualapplications.play/com.virtualapplications.play.ExternalEmulatorLauncher parameters=   Reicast - Dreamcast  exe=com.reicast.emulator/com.reicast.emulator.MainActivity  parameters=   Redream - Dreamcast exe=io.recompiled.redream/io.recompiled.redream.MainActivity parameters=   Drastic - Nintendo DS  exe=com.dsemu.drastic/com.dsemu.drastic.DraSticActivity  parameters=GAMEPATH   Fpse - PSX  exe=com.emulator.fpse/com.emulator.fpse.Main  parameters=path   ePSX - PSX  exe=com.epsxe.ePSXe/com.epsxe.ePSXe.ePSXe   parameters=com.epsxe.ePSXe.isoName  * change romext=cue in settings.ini, iso did not work for me   PPSSPP (FREE version) - PSP  exe=org.ppsspp.ppsspp/org.ppsspp.ppsspp.PpssppActivity  parameters=org.ppsspp.ppsspp.Shortcuts PPSSPP Gold - PSP             exe=org.ppsspp.ppssppgold/org.ppsspp.ppsspp.PpssppActivity              parameters=   uoYabause - Sega Saturn exe=org.uoyabause.android/org.uoyabause.android.Yabause
      parameters=org.uoyabause.android.FileNameEx
      Yaba Sanshiro
           exe=org.uoyabause.uranus/org.uoyabause.android.Yabause
               parameters=org.uoyabause.android.FileNameEx
      Gearoid - Sega Game Gear  exe=com.androidemu.gg/com.androidemu.gg.EmulatorActivity   Parameters=   Colem - Speccy ZX - fMSX VGBANext  Emulators from Garage Research  PAID  com.fms.colem.deluxe - Colem - Colecovision  com.fms.fmsx.deluxe - fMSX  com.fms.ines - iNES  com.fms.emu - VGBAnext - GBA/GBC/GB Emulator  com.fms.vgb - VGBc - Gameboy Color  com.fms.mg - Master Gear - Sega Game Gear  com.fms.speccy.deluxe - Spectrum Sinclair ZX  FREE  com.fms.colem  com.fms.fmsx  com.fms.speccy    Set "??" to "com.fms.emulib.MainActivity" for all products but VGBAnext.   For VGBAnext:  ??=com.fms.vgba.MainActivity for opening *.gba files  ??=com.fms.vgb.MainActivity for opening *.gbc/*.gb files   OpenBOR - 2D Game Engine (Some integration issues with Hyperspin)              exe=org.openbor.engine/org.libsdl.app.SDLActivity Parameters=   Launch android app package names in database.xml Determine Android game name through Google Play web interface. i.e. https://play.google....ure.dragonslair   pcgame=true
×
×
  • Create New...