HyperSpin Startup Script 1.08

[ghutch92]

File Name: HyperSpin Startup Script 1.08

File Submitter: ghutch92

File Submitted: 08 May 2015

File Category: Add-Ons

Credits: ghutch92

 

 

 

http://www.hyperspin-fe.com/topic/9028-hyperspin-startup-script/ - support topic in forums

Ok, this is not amazing but it is useful for you joystick/gamepad users and multi-taskers. This script is written in autohotkey and borrows some code from RocketLauncher.

This startup utility allows you to start and close an unlimited amount of processes and programs when hyperspin starts and closes. It allows you to use your gamepad/joystick in the hyperspin program without paying for 3rd party software. It can minimize your background windows when you start hyperspin and restore them in the opposite order when you close hyperspin. It has a volume bar that moves in from the bottom of the screen that allows you to control the volume in hyperspin using hyperspin keyboard controls or joystick controls. It has a quicklaunch bar that moves in from the left side of the screen from which you can launch commonly used programs that are used in setting up hyperspin or your gaming session and even restart hyperspin (examples: hyperhq, RocketLauncherUI, don's hypertools, an internet browser, fraps, etc)





To use it Open HyperHQ, Go to Main Settings -> Startup\Exit -> and set the .exe file as your startup program.


How to make it work:
Run it once, a new file should appear in the folder it is in. It's name will be the same name as this program and will have the extension "ini"
Open the ini file. You should see some of the settings described below.

[Required]
HyperSpin_Folder_Path REQUIRED! is the path to the folder containing hyperspin.exe (Default is .\ which would be the same folder as the startup script. ..\ means one folder up. ..\..\ would mean two folders up). Absolute paths are still accepted.
Primary_Color_RRGGBB is the background color of the menus given in a hex rrggbb format. Examples and a color picker can be found here.
Secondary_Color_RRGGBB is the background color of the menus given in a hex rrggbb format. Examples and a color picker can be found here.

[Controls]
Joysticks_Enabled can be true or false. Set this to true to use a joystick or gamepad with hyperspin. May work for controllers other than the 360 controller.
Joystick_Delay is the number of milliseconds to wait before repeating for only the hyperspin startup menus
Joystick_Deadzone is a number between 0 and 49 representing the size of the axis deadzone for every axis. 0 is the most sensitive. 49 is the least sensitive.
Joysticks_MaxNumberOfJoysticks is a number between 1 and 16 that represents how many joysticks you want to use at the same time (using same control layout) to control hyperspin
Joystick_Up, Joystick_Down, Joystick_SkipUp, Joystick_SkipDown, Joystick_SkipUpNumber, Joystick_SkipDownNumber, Joystick_HyperSpin, Joystick_Genre, Joystick_Favorites, Joystick_Start and Joystick_Exit do the same thing as their HyperSpin keyboard counterparts.
Joystick_Roulette, Joystick_Volume, Joystick_Volume_Close, Joystick_QuickLaunch and Joystick_QuickLaunch_Close joystick controls for roulette, volume bar and quicklaunch bar.
Joystick_Info, Joystick_Info_Close, Joystick_Filters and Joystick_Filters_Close are not yet implemented, need to be able to receive Event Dispatcher info, com xml code are needed to get these controls to work.

Joystick control options in the settings are separated by a vertical bar delimiter | . The joystick control options available are as follows
for axis: JoyX-, JoyX+, JoyY-, JoyY+, JoyZ-, JoyZ+, JoyR-, JoyR+, JoyU-, JoyU+, JoyV- and JoyV+
for dpad/hat switch: JoyPOVN, JoyPOVE, JoyPOVS and JoyPOVW
for buttons: Joy1, Joy2, Joy3, Joy4, Joy5, Joy6, Joy7, Joy8, Joy9, Joy10, Joy11, Joy12, Joy13, Joy14, Joy15, Joy16, Joy17, Joy18, Joy19, Joy20, Joy21, Joy22, Joy23, Joy24, Joy25, Joy26, Joy27, Joy28, Joy29, Joy30, Joy31 and Joy32

[startup]
Minimize_Background_Windows_Enabled can be true or false. Set this to true to minimize windows when this script starts.
Window_Classes_To_Not_Minimize is a comma delimited list of window classes that will not be minimized. To get the window class you can use this tool AU3 Window Spy.zip.

[Exit]
Restore_Windows_On_Exit can be true or false, if true it will restore all windows minimized by the script, if false the windows will stay minimized when hyperspin exits

[startup] & [Exit]
Process_Name_To_Close_1 is the name of the process you wish to close. To add more processes to close, just change the 1 to a 2 for the second process, the 2 to a 3 for a third process, etc. Example:

 

 

 

Process_Name_To_Close_1=notepad.exeProcess_Name_To_Close_2=hyperlaunch.exe

 

Program_To_Run_Target_1 is a document, URL, executable file (.exe, .com, .bat, etc.), shortcut (.lnk), or system verb to launch. If Target is a local file and no path was specified with it, The script's directory will be searched first. If no matching file is found there, the system will search for and launch the file if it is integrated ("known"), e.g. by being contained in one of the PATH folders. To pass parameters, add them immediately after the program or document name. If a parameter contains spaces, it is safest to enclose it in double quotes (even though it may work without them in some cases). Paths relative to the startup script are allowed.
Program_To_Run_Working_Dir_1 is the working directory for the launched item. Do not enclose the name in double quotes even if it contains spaces. If omitted, the script's own working directory will be used. Relative Paths are not allowed.
Program_To_Run_MaxMinHide_1 is if omitted, Target will be launched normally. Alternatively, it can contain one or more of these words:
Max :launch maximized
Min :launch minimized
Hide : launch hidden (cannot be used in combination with either of the above)
Note: Some applications (e.g. Calc.exe) do not obey the requested startup state and thus Max/Min/Hide will have no effect.
To add more programs to open, just change the 1 to a 2 for the second program, the 2 to a 3 for a third program, etc.
Example:

Program_To_Run_Target_1=C:\Utilities\Xpadder\xpadder.exe "C:\HyperLaunch\Profiles\xpadder\HyperSpin\p1.xpadderprofile" /MProgram_To_Run_Working_Dir_1=Program_To_Run_MaxMinHide_1=Program_To_Run_Target_2=HyperSearch.exeProgram_To_Run_Working_Dir_2=C:\HyperSpin\HyperSearchProgram_To_Run_MaxMinHide_2=Program_To_Run_Target_3=explorer.exeProgram_To_Run_Working_Dir_3=Program_To_Run_MaxMinHide_3=

 

[Roulette]
Roulette_Key is the compatible autohotkey key name for the key or two key combo used to trigger the roulette event. Modifier Symbols are accepted. There is already built in support for the roulette function for joysticks.
Roulette_Min_MilliSeconds is the minimum amount of milliseconds to spin the HyperSpin menu wheel
Roulette_Min_MilliSeconds is the maximum amount of milliseconds to spin the HyperSpin menu wheel

[Volume_Menu]
Volume_Menu_Key is the compatible autohotkey key name for the key or two key combo used to open/close the volume bar. Modifier Symbols are accepted. There is already built in support for the volume menu for joysticks.
Volume_Bar_Offset_From_Bottom is the distance in pixels from the bottom of the screen to the bottom of the volume bar. For reference the windows 7 taskbar is typically 40 pixels.

[QuickLaunch]
QuickLaunch_Key is the compatible autohotkey key name for the key or two key combo used to open/close the quicklaunch menu. Modifier Symbols are accepted. There is already built in support for the quicklaunch menu for joysticks.
QuickLaunch_Enabled can be true or false. Set to false to disable the use of the quicklaunch menu, useful to disable if you don't want to ruin the arcade experience, useful to enable to help troubleshoot and make changes to your setup, amongst other things.
QuickLaunch_Left_Offset is the distance in pixels from the left of the screen to the left edge of the logos
QuickLaunch_Top_Offset is the distance in pixels from the top of the screen to the top edge of the first selectable logo
QuickLaunch_Bottom_Offset is the distance in pixels from the bottom of the screen to the bottom edge of the last selectable logo
Item_1_Path is a document file, executable file (.exe, .com, .bat, etc.), or shortcut file (.lnk), to launch. If Target is a local file and no path was specified with it, The script's directory will be searched first. If no matching file is found there, it will not be added to the menu as an option. Paths relative to the startup script are allowed.
Item_1_Parameters is the parameters to pass to the application. If a parameter contains spaces, it is safest to enclose it in double quotes (even though it may work without them in some cases).
Item_1_LogoPath is a path to an image file to be used as the logo for the application in the quicklaunch menu. If this value does not exist or is empty, this script will attempt to extract and use the application's icon.
Item_1_Ignore_Process_Close can be true or false. does not reactivate hyperspin or the quicklaunch menu when the application specified is closed. Useful for for applications that use a launcher.
To add more items to the quicklaunch menu, just change the 1 to a 2 for the second item, the 2 to a 3 for a third item, etc.
Example:

Item_1_Path=C:\HyperSpin\HyperSpin.exeItem_1_Parameters=Item_1_LogoPath=Item_1_Ignore_Process_Close=falseItem_2_Path=C:\HyperSpin\HyperHQ.exeItem_2_Parameters=Item_2_LogoPath=Item_2_Ignore_Process_Close=falseItem_3_Path=C:\HyperSpin\HyperSync Cloud\HyperSync Cloud.exeItem_3_Parameters=-trueItem_3_LogoPath=Item_3_Ignore_Process_Close=falseItem_4_Path=C:\HyperLaunch\HyperLaunchHQ\HyperLaunchHQ.exeItem_4_Parameters=Item_4_LogoPath=C:\HyperLaunch\HyperLaunch Icons\hlhqicon256x256.pngItem_4_Ignore_Process_Close=falseItem_5_Path=C:\HyperSpin\HyperTools\Filter HyperList.exeItem_5_Parameters=Item_5_LogoPath=Item_5_Ignore_Process_Close=falseItem_6_Path=C:\HyperSpin\HyperTools\Rename ROMs.exeItem_6_Parameters=Item_6_LogoPath=Item_6_Ignore_Process_Close=falseItem_7_Path=C:\HyperSpin\HyperTools\Split HyperList.exeItem_7_Parameters=Item_7_LogoPath=Item_7_Ignore_Process_Close=falseItem_8_Path=C:\HyperSpin\HyperTools\Create New HyperList.exeItem_8_Parameters=Item_8_LogoPath=Item_8_Ignore_Process_Close=falseItem_9_Path=C:\HyperSpin\HyperTools\Merge HyperLists.exeItem_9_Parameters=Item_9_LogoPath=Item_9_Ignore_Process_Close=false

 

If you want the source ahk code for the latest version just pm me for it. I will fix bugs, but I am not taking feature requests nor helping others set it up.

 

 

Click here to download this file

 

 

HS Startup.zip

HyperSpin Startup Script.zip

Joystick Detection.ahk

Link to the downloads section

[windowlicker11]

Thanks. This looks to be a good replacement for my quick and dirty startup script I was using. PM Sent.

[Gius3ppe]

I'll try it !

Thanks.

Sent from my iPhone using Tapatalk - now Free

[penduzecat]

Great tool !

[vindic8r]

I'm getting tired of the command prompt window that briefly interrupts my cabinet's boot sequence. This should do the trick! Thanks!

[bb_neo]

I do not use xpadder so I replaced it to joytokey (Keymapper=joytokey) but I still get this error:

Edited October 31, 2013 by bb_neo

[gigapig]

Hi ghutch

Any idea what may cause this.

This is my empty desktop after exiting HS, all that is left are those grey rectangles. Icons are gone and so is the cpu meter.

I wanted to use your tool to minimise any windows I forget to minimise when I start HS, as occasionally when I exit a game,

1 or more of those windows may be over the top of HS.

The only way I know to return things to normal is to reboot. Sometimes the show desktop button will bring icons back.

Thanks for any input.

[ghutch92]

Hi ghutch

Any idea what may cause this.

[ATTACH=CONFIG]34161[/ATTACH]

This is my empty desktop after exiting HS, all that is left are those grey rectangles. Icons are gone and so is the cpu meter.

I wanted to use your tool to minimise any windows I forget to minimise when I start HS, as occasionally when I exit a game,

1 or more of those windows may be over the top of HS.

The only way I know to return things to normal is to reboot. Sometimes the show desktop button will bring icons back.

Thanks for any input.

@bb_neo, I fixed the bug you found, thanks for reporting it.

@gigapig, some windows don't like to be minimized so when they are forced to minimize they leave those boxes. Use the Window Spy utility that comes with the autohotkey or autoit downloads to get the class name. Just append the class name of that window to the list in the ini of the window class names not to minimize.

[penduzecat]

.

Edited November 2, 2013 by penduzecat
nvm

[ghutch92]

Got a problem with this tools :

What i want to do is to launch hyperspin.exe instead of explorer.exe

But when i do this, programs in HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Run won't start with windows

So i used your software and i added daemons tools, nomousy, xpadder and total hotkeys

For some reasons, my joystick doesn't work anymore on hyperspin, i had to do an alt+tab then it works.

I tried to :

change the order of software launch > didn't work

start total_hotkeys as a windows service > didn't work

start total hotkeys with a batch, then kill the 2nd instance > didn't work (and total hotkeys doesn t works after)

start xpadder with hyperHQ setting > didn't work

enable all option on your tool > didn't work

... > didn't work

I don't know how so solve this problem except launch explorer.exe and start hyperspin.exe after, but i really want to block the desktop

(I need total hotkeys to set the volume up/down, shutdown computer with shortcut like numkey 8+9 = start+back on my joystick)

I think you'll need to start with explorer.exe to have DT and xpadder and joysticks working correctly. Also the shutdown hotkey makes no sense to me, would it not be better to set it up so that when you exit your frontend your computer shuts down, instead of mapping a hotkey to do it? Did you know xpadder has media key options that allow you turn the volume up or down using your joystick?

Added new version that can hide the mouse and taskbar, get it in the first post. I find this useful for programs that put the taskbar back into focus like xpadder. Uses the same methods as HyperLaunch to accomplish this. User Beware: I know of no easy way to get the cursor back and taskbar back, so leave this disabled unless you're feeling adventurous or wanting to shell windows and you need explorer.exe to start.

[miamisurf]

Worx a treat thank you

[famuhnic5]

Hey ghutch when I run this script I get an error saying: Error at line 1, line text [settings] error this line does not contain an recognized action. I followed your guide and the only thing I changed was C:\ to H:\ since H is where hyperspin is.

[ghutch92]

Hey ghutch when I run this script I get an error saying: Error at line 1, line text [settings] error this line does not contain an recognized action. I followed your guide and the only thing I changed was C:\ to H:\ since H is where hyperspin is.

screenshot?

I have no issues running from a separate drive using the version found in my first post. I feel like it's something on your end.

Edited November 18, 2013 by ghutch92

[famuhnic5]

screenshot?

I have no issues running from a separate drive using the version found in my first post. I feel like it's something on your end.

[ghutch92]

error screenshot or error never happened.

[famuhnic5]

error screenshot or error never happened.

[ghutch92]

[ATTACH=CONFIG]34931[/ATTACH]

I see a user error, not a program error. You can't just go around changing file extensions to ahk and expect it to work. Nowhere in the instructions did I tell you to change your ini file's extension to ahk.

If you want to write an ahk file read the autohotkey documentation.

Edited November 18, 2013 by ghutch92

[famuhnic5]

I see a user error, not a program error. You can't just go around changing file extensions to ahk and expect it to work. Nowhere in the instructions did I tell you to change your ini file's extension to ahk.

If you want to write an ahk file read the autohotkey documentation.

I see thought that was what needed to be done sorry for the inconvenience. Thanks for the help non the less.

Edited November 18, 2013 by famuhnic5

[Skandal]

This is superb!

[potts43]

Hi - I would like to run my hyperspin xpadder profile. How do I tell xpadder via this program which profile to run? Sorry if this is basic.

[craiganderson]

edit.

got rid of the backslash ...seems to work now

thank u

___________________________________________________________

hello

thank you for your program

i get this error

any help is appreciate

my hyperspin folder is on drive E

Edited March 31, 2014 by craiganderson

[bb_neo]

Ghutch,

I have tried to add the new HyperSearch tool to your HS Startup script but I get this below. HyperSearch starts fine when launching his exe. I have double checked the paths.

Can you test to add this on your side please?

I tested with and without the "\" and end of the line but same error.

Program_To_Run_Working_Dir_2=z:\HYPERSPIN\HyperSearch\

[ghutch92]

Ghutch,

I have tried to add the new HyperSearch tool to your HS Startup script but I get this below. HyperSearch starts fine when launching his exe. I have double checked the paths.

[ATTACH=CONFIG]39923[/ATTACH]

Can you test to add this on your side please?

I tested with and without the "\" and end of the line but same error.

Program_To_Run_Working_Dir_2=z:\HYPERSPIN\HyperSearch\

Tested and no issue, maybe you are looking at the wrong setting?

EDIT: My bad, it's fixed on my end but I just tested the one I had in the download link and it seems to be the older v1.02 I just updated it.

Edited April 6, 2014 by ghutch92

[bb_neo]

Thanks for the update. Confirm working with my settings above. However, if you set HyperSearch to be Target_1 the script tried to open 2 processes of HyperSearch.

Example:

[settings]
HyperLaunch_Path=Z:\HYPERSPIN\HyperLaunch
Hide_Cursor=false
Hide_Taskbar=false
[Keymapper]
Keymapper=joytokey
Keymapper_Enabled=true
keymapperAhkExternalEnabled=false
[Programs]
Minimize_Background_Windows_Enabled=false
Window_Classes_To_Not_Minimize=Shell_TrayWnd,Button

Program_To_Run_Target_1=HyperSearch.exe
Program_To_Run_Working_Dir_1=z:\HYPERSPIN\HyperSearch\
Program_To_Run_MaxMinHide_1=
Process_Name_To_Close_1=

I get this:

bb_neo / aka advanced HS Startup beta-tester

[ghutch92]

Thanks for the update. Confirm working with my settings above. However, if you set HyperSearch to be Target_1 the script tried to open 2 processes of HyperSearch.

Example:

[settings]
HyperLaunch_Path=Z:\HYPERSPIN\HyperLaunch
Hide_Cursor=false
Hide_Taskbar=false
[Keymapper]
Keymapper=joytokey
Keymapper_Enabled=true
keymapperAhkExternalEnabled=false
[Programs]
Minimize_Background_Windows_Enabled=false
Window_Classes_To_Not_Minimize=Shell_TrayWnd,Button

Program_To_Run_Target_1=HyperSearch.exe
Program_To_Run_Working_Dir_1=z:\HYPERSPIN\HyperSearch\
Program_To_Run_MaxMinHide_1=
Process_Name_To_Close_1=

I get this:

[ATTACH=CONFIG]39944[/ATTACH]

bb_neo / aka advanced HS Startup beta-tester

That warning comes from HyperSearch and not the Startup Script.