Jump to content

SETUP: Hyperspin for Android

Recommended Posts

z7jPgNL.jpg?1  SETUP:  Hyperspin (for Android)
  • Install
    • Install Android .apk on your NVIDIA Shield portable, tablet, or TV/console
    • Copy data to internal storage or insert sdcard or connect USB hard drive with Hyperspin data
    • Run app
  • Android additions 
    • Hyperspin will seek and prioritize /usbdrive/Hyperspin first, then /sdcard1/Hyperspin, then /sdcard/Hyperspin for your data
    • Optional additional database file called "Main Menu_Android.xml" offers a subset or superset of wheels 
    • Optional additional settings folder called /Settings_Android allows both Windows and Android launcher/rompaths to co-exist.
    • Within settings .ini files, you can define multiple emulators on the exe= and parameter= lines (i.e. 2600.emu and Retroarch/Stella) and it will launch the first emulator that is installed.   See the example Android .ini files posted in the download area..
  • Upvote 4

Share this post

Link to post
Share on other sites
Supported Hyperspin ini config file settings


The two major types of ini config files in Hyperspin are Settings.ini, and the Game System.ini file that each wheel menu loads.    This is the list of currently supported ini config file options that are 'hooked up' in our Hyperspin Android app.    If not 'supported', then there is a hard-coded value or the parameter is ignored currently.



Settings.ini file


 Menu_Mode=<supports "multi" and "single" menu mode>

  -multi - Default mode that goes from Intro->Main Menu->Game Menu

  -single - Mode that goes from Intro->Game Menu

 Single_Mode=<supports name of directory to use for game level menu>

 Enable_Exit=<not supported>

 Exit_Default=<not supported>

 Exit_Action=<not supported>

 Version=<not supported>



 Not supported - It always renders fullscreen stretched to display



 Not supported

  -It always renders with bilinear filtered textures

  -No support for backgrounds outside of video transitions



 Not supported - It always plays intro video and stops on keypress



 Not supported - Only controllable with Android volume controls



 Not supported



 [P1 Controls]

 [P2 Controls]

 [P1 Joystick]

 [P2 Joystick]



 Not supported - Only hardcoded support for Android controllers


 [startup Program]

 [Exit Program]



 Not supported




Game System.ini file  

 [exe info]

 path=<not supported>

 rompath=<supports absolute path to menu's rom directory>

 userompath=<not supported, it's always "true">

 exe=<supports package/class format of launching intents>

 romextension=<supports comma-seperated list of rom extensions to use>

 parameters=<supports "cores/emulator_library.so" format for libretro>

 searchsubfolders=<not supported, does not search subfolders>

 pcgame=<supports "true" and "false">

  -true - Looks in database.xml for package/class to launch

  -false - Launches "exe" intent with "parameter" options

 winstate=<not supported>

 hyperlaunch=<not supported, always "false">



 parents_only=<not supported, always "false">

 themes_only=<supports "true" and "false">

 wheels_only=<not supported, always false>

 roms_only=<supports "true" and "false">



 Not supported



 alpha=<not supported, always "1">

 speed=<not supported>

 vert_wheel_position=<not supported, always "right">

 text_with_images=<not supported, always "true">

 text_width=<supports any pixel width value>

 text_font=<not supported, always uses default font>

 small_text_width=<supports any pixel width value>

 large_text_width=<supports any pixel width value>

 text_stroke_size=<not supported>

 text_stroke_color=<not supported>

 text_color1=<supports hex value color>

 text_color2=<supports hex value color>

 text_color3=<not supported>

 color_ratio=<not supported>

 shadow_distance=<not supported>

 shadow_angle=<not supported>

 shadow_color=<not supported>

 shadow_alpha=<not supported>

 shadow_blur=<not supported>



 x=<supports any x value>

 y=<supports any y value>


 [video defaults]

 Not supported



 Not supported



 Not supported


 [artwork2 defaults]

 [artwork3 defaults]

 [artwork4 defaults]

 Not supported


 [special Art A]

 [special Art B]

 default=<supports "true" or "false" use of default special art in "Main Menu">

 active=<supports "true" or "false" to enable rendering of special art>

 x=<supports x location of special art>

 y=<supports y location of special art>

 in=<not supported>

 out=<not supported>

 length=<supports seconds of how long each special art file should display>

 delay=<not supported>

 type=<not supported>

 start=<not supported, always "none">


 [Game Text]

 game_text_active=<not supported, always "true">

 show_year=<not supported, always "true">

 show_manf=<not supported, always "true">

 show_description=<not supported, always "true">

 text_color1=<supports hex color of top of text>

 text_color2=<supports hex color of bottom of text>

 stroke_color=<supports hex color of text outline>

 text_font=<not supported, always uses default font>

 text1_textsize=<supports size of description text>

 text1_strokesize=<supports size of description text outline>

 text1_x=<supports x location of description text>

 text1_y=<supports y location of description text>

 text2_textsize=<supports size of title text>

 text2_strokesize=<supports size of title text outline>

 text2_x=<supports x location of title text>

 text2_y=<supports y location of title text>


 [Genre Screen]

 Not supported - Genre Screen not implemented

Share this post

Link to post
Share on other sites
Tested Emulators  

This is a list of tested emulators and their working ini config settings. 


Retroarch - Various emulators 


 parameters=<choose one of the emulator cores like below>


Examples of retroarch core parameters

Atari 2600 core:


PSX core:



libretro cores:














































NES.emu - NES




MSX.emu - Colecovision, MSX, etc.




Mame4Droid - MAME



* rom folder path set inside app (need to request this fix)


Reicast - Dreamcast




Drastic - Nintendo DS




Fpse - PSX







 * change romext=cue in settings.ini, iso did not work for me


PPSSPP (FREE version) - PSP








Gearoid - Sega Game Gear




Colem - Speccy ZX - fMSX VGBANext

 Emulators from Garage Research


 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






 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


Launch android app package names in database.xml

Determine Android game name through Google Play web interface.


  • Upvote 2

Share this post

Link to post
Share on other sites
This topic is now closed to further replies.

  • Similar Content

    • By thatman84
      Hyperspin Android ScummVM with RetroArch
      What is it?
      ScummVM is a program which allows you to run certain classic graphical point-and-click adventure games, provided you already have their data files. The clever part about this: ScummVM just replaces the executables shipped with the games, allowing you to play them on systems for which they were never designed!
      Assets and Links
      Latest ScummVM release at time of posting Dec 17, 2017: ScummVM 2.0.
      Diskmach Updated Database ScummVM 2.1
      Latest HyperSpin database ScummVM 1.8

      Working RetroArch core at time of posting scummvm 2.0.0 93d1ca1
      Location of current core
      How to setup...
      Grab these setup files as they will be needed.
      (Includes the Android XML and "Official" XML databases)
      Follow this guide to set up RetroArch ScummVM core directly Get your games and place them in folders named after this spreadsheet OR download the above setup files and create folders for them (with help of the below guide) Follow this guide to setup the folder structure for Hyperspin Android "folder trick" Use the below ini file settings for reference and add the system to your Hyperspin wheel as any other exe=com.retroarch/com.retroarch.browser.retroactivity.RetroActivityFuture
      Run Hypersync with the NON android xml as its not compatible with sync.
      The progress sheet below was adopted on the RetroArch documentaion and holds all my findings. I did duplicate 1 game to aid with android setup
      I created a "simon" folder for the Simon the Sorcerer's Puzzle Pack as all the games are in one folder.

      Backup of Working Core
      Helpful Links
    • By DrSoupants
      Dear Hyperspin Community. 
      Before I go any further, can I please apologise for posting this request for information. I have no doubt that this has been covered thousands of times on thousands of posts on this website and I am indeed sorry. Feel free to scream at me profusely and use a range of poo emojis to communicate your frustration with me. I guess I'm a little overwhelmed with all of the content and I'm a bit unsure where to start. I'm definitely new to Hyperspin and need some help. 
      I have an Nvidia Shield, complete rom packs (at least I think they're complete) for a range of consoles, have the Retroarch emulator working and have a range of other emulators to play all of the games I want. I have a 2TB hard drive that am using as shared (or emulated) storage device and this is dedicated to the shield (non-removable). Ok......this is where you get pissed. 
      1.) Hyperspin tells me "Warning.....attempting to launch missing rom". Because my HD is emulated the path in ES explorer reads: 'storage/emulated/0/hyperspin/emulators ( …….then all of the console folders (eg: MAME)……. then all the rom folder)'.  Roms are placed in this folder. Can someone please tell me what I need to write in the individual setting file (eg: Nintendo 64.ini)  as I have had no luck at all with any of the games on the Hyperspin interface. I believe this to be my major problem. 
      2.) This is where you're really going to get the shits. I downloaded the base pack for the Nvidia Shield (from the Hyperspin site) and the start menu is great. When I enter a console I have a warning triangle telling me "Video Previews available at emumovies.com". How do I sinc the videos with the individual menus (I think they are referred to as 'systems' but I have no idea how to install these)???????? Soooo...……..where can I find these and how and where do I install them??
      3.) I believe that the fonts and images associated with roms are called 'wheels'. I have downloaded a few of these but how would I install these on the shield? 
      Basically, what I'm asking is...……... how can I setup Hyperspin on the Shield using a shared storage device so that it kicks some serious ass. 
      A huge thank you for anyone that can help me. Feel free to kick my ass in the comments but I've already done that over the past couple of weeks so I'm well ahead of you.
      Thank you so much Hyperspin and hope to hear from you soon. 
      Soup Pants.