MAMEWAH v1.6+ INI System

This is how the ini system works:  MAMEWAH uses three main types of ini config files; mamewah.ini (main/global settings), emuname.ini (emulator-specific settings), and emuname-?.ini (list-specific settings, where ? is the list no.).

mamewah.ini is auto-generated/updated when you run MAMEWAH, and resides in \mamewah.

To generate emuname.ini or emuname-?.ini, simply place suitably named text file(s) in the \mamewah\ini folder (eg mame.ini, mame-0.ini, mame-1.ini etc.), and run MAMEWAH.  The ini files will be automatically populated/updated with default settings.  You must have emuname.ini for each emulator you require, and the number of lists available is determined by however many emuname-?.ini files you have (emuname-0.ini will be the main, non-filterable list).

Settings Overview:

### mamewah.ini ###

### (Global) Screen-Saver Options ###
delay                       5			(seconds)
slide_duration              3			(seconds)

### Audio Options ###
enable_sounds               1			(0=no, 1=yes)
sound_volume                100			(0-100%)
music_path                  			(music folder, eg c:\music)
enable_music                1			(0=no, 1=yes)
music_volume                100			(0-100%)

### Movie Options ###
intro_movie_file            			(movie filename, eg c:\movies\intro.mpg)
exit_movie_file             			(movie filename, eg c:\movies\exit.mpg)
keep_movie_preview_aspect   game_aspect		(no / video_aspect / game_aspect)
delay_before_movie_preview  2			(seconds)
music_movie_mix             mute_movies		(mute_movies / merge / pause_music)
movie_volume                100			(0-100%)

### Misc Options ###
layout                      Classic 640x480	(layout name, see layouts.txt)
ctrlr                       			(ctrlr name, see ctrlr.txt)
wrap_list                   0			(0=no, 1=yes)
remember_current_game	    1			(0=no, 1=yes)
keep_image_aspect           1			(0=no, 1=yes)
refresh_images              0			(0=no, 1=yes)
correct_orientations        horizontal		(horizontal / vertical / no)
safe_mode		    0			(0=no, 1=yes)
show_cursor                 0			(0=no, 1=yes)
keyboard_led_states         -,-,-		(x,x,x where x=: -=leave, 0=off, 1=on, eg 1,1,1)
winipac_file                			(winipac exe filename, eg c:\winipac\winipac.exe)
mamewah_ipc_file            			(default ipac ipc file, eg c:\ipc\mamewah.ipc)
lcd_com_port                1			(lcd display serial [com] port no.)
lcd_settings                			(lcd settings *)
exit_action                 choice		(choice / windows / run_app / reboot / shutdown)
app_to_run_on_exit				(application filename, eg c:\app.exe)

### Settings used by MAMEWAH ###
current_emulator            mame		(ignore, generated by MAMEWAH)
locked                      0			(ignore, generated by MAMEWAH)
last_ipc                    			(ignore, generated by MAMEWAH)


* lcd settings should be as follows:

baud rate (110/300/600/1200/2400/9600/14400/19200/28800/38400/56000/128000/256000), parity ([e]ven, [o]dd, [n]one, [m]ark, [s]pace), data bits (4-8), stop bits (1, 1.5, 2)

eg: 9600,n,8,1

------------------------------------------------------------------------

### emuname.ini ###

emulator_title                            				(title of your choice, eg M.A.M.E.)

### List Generation Settings ###
rom_path                                  				(rom folder, eg c:\mame\roms)
rom_extension                             zip				(file extension)
dat_file                                  				(dat filename, eg c:\mame\mame.dat)
nms_file                                  				(nms filename, eg c:\mame\mame.nms)
catver_ini_file                           				(catver.ini filename, eg c:\mame\catver.ini)
list_generation_method                    rom_folder_vs_listxml		(rom_folder / rom_folder_subfolders / dat_file / rom_folder_vs_dat_file / rom_folder_vs_listinfo / verifysets_vs_listinfo / rom_folder_vs_listxml / verifysets_vs_listxml)

### Execution Settings ###
emulator_executable                       				(emulator filename, eg c:\mame\mame.exe)
commandline_format                           				(emulator commandline format *)
alt_commandline_format_1                           			(emulator commandline format *)
alt_commandline_format_2                           			(emulator commandline format *)
game_specific_config_path						(game-specific config .cfg file folder, eg c:\gameconfig)

### Artwork Locations ###
artwork_1_image_path                      				(image file folder, eg c:\mame\snap)
artwork_2_image_path                      				(image file folder, eg c:\mame\snap)
artwork_3_image_path                      				(image file folder, eg c:\mame\snap)
artwork_4_image_path                      				(image file folder, eg c:\mame\snap)
artwork_5_image_path                      				(image file folder, eg c:\mame\snap)
artwork_6_image_path                      				(image file folder, eg c:\mame\snap)
artwork_7_image_path                      				(image file folder, eg c:\mame\snap)
artwork_8_image_path                      				(image file folder, eg c:\mame\snap)
artwork_9_image_path                      				(image file folder, eg c:\mame\snap)
artwork_10_image_path                     				(image file folder, eg c:\mame\snap)
movie_preview_path                        				(movie preview folder, eg c:\mame\previews)
movie_artwork_no                          1				(1-10)

### Screen-Saver Settings ###
enable_music_in_screensaver 		  1				(0=no, 1=yes)
saver_type                                slideshow			blank_screen / slideshow / movie / run_selected_game / run_random_game / run_random_game_and_quit / run_random_game_using_wrapper / launch_scr / power_saving / shutdown
movie_path                                				(movie folder, eg c:\movies - saver_type movie only)
quit_delay								(seconds - saver_type run_random_game_and_quit only )
wrapper_executable                        				(wrapper filename, eg c:\mame\cmd-launch2.exe - run_random_game_using_wrapper only)
wrapper_commandline_format                     				(emulator commandline format - run_random_game_using_wrapper only *)
scr_file                                  				(screensaver filename, eg c:\mamess\mamescreensaver.scr - launch_scr only)

### External Application Settings ###
ipc_file_or_path                          				(ipc filename or path, eg c:\ipc\mame.ipc or c:\ipc)
app_1_executable       							(external application #1 filename, eg c:\cpviewer\cpviewer.exe)
app_1_commandline_format                     				(external application #1 commandline format *)
app_2_executable                          				(external application #2 filename, eg c:\cpviewer\cpvgeneric.exe)
app_2_commandline_format                     				(external application #2 commandline format *)
app_3_executable                         				(external application #3 filename, eg c:\jukebox\jukebox.exe)
app_3_commandline_format                     				(external application #3 commandline format *)
auto_launch_apps                          				(the order apps are launched prior to the emulator, eg 1,2,3 or 3,2,1 or 1,2 or 1 etc.)

### Additional Settings ###
music_path                                				(music folder, eg c:\music)
lcd_display_file_path                     				(lcd file folder, eg c:\lcd)
lcd_fe_text   								(text of your choice, eg M.A.M.E. - Multiple Arcade Machine Emulator)

### Settings used by MAMEWAH ###
current_list                              0				(ignore, generated by MAMEWAH)


* commandline_format flags:

As well as regular switches etc., the following strings can be used, and MAMEWAH will replace them suitably with information on the currently selected game when the application is launched:

[description] - full game name,
[name] - romname,
[year] - year made,
[manufacturer] - manufacturer,
[cloneof] - parent romname,
[romof] - bios/parent romname,
[screen] - screen type,
[orientation] - screen orientation,
[input] - input type,
[status] - driver status,
[color] - color status,
[sound] - sound status,
[category] - game category/genre.

Note that if '-clone [cloneof]' is present in the commandline_format, and the selected game is not a clone, then '-clone [cloneof]' will be ignored.

In order to alter the commandline format used, the following flags can also be used:

[rompath] - rom path excluding trailing '\',
[romext] - rom extension excluding '.',
{8.3string} - can be used to convert 'string' to a short (8.3) filename (note that quotes if applicable must be used outside of the {}'s),
{dosbox} - this specifies dos window is to be visible upon launching emulator/app,
{nodosbox} - this specifies dos window is to be hidden upon launching emulator/app,
{autodosbox} - this specifies dos window is to be visible only if necessary upon launching emulator/app (this should be used for M.A.M.E. only!!),
{safelaunch} - this 'safe launches' the emulator/app, use this if the emulator/app is not launching properly from MAMEWAH,
{nosafelaunch} - this launches the emulator/app as normal (use if possible),
{nomusic} - this pauses music playback while the emulator/app is running,
{music} - this allows music playback to continue while emulator/app is running,
{nocursor} - this hides the cursor while the emulator/app is running,
{cursor} - this makes the default cursor visible while the emulator/app is running,
{cursor filename} - this makes the cursor specified by 'filename' visible while the emulator/app is running.

Note: 	If no 'dosbox' flag is set then '{dosbox}' will be assumed,
	If no 'safelaunch' flag is set then '{safelaunch}' will be assumed,
	If no 'music' flag is set then '{nomusic}' will be assumed,
	If no 'cursor' flag is set then '{nocursor}' will be assumed.

Flags in {curley brackets} are not used in the actual commandline sent to the emulator.

------------------------------------------------------------------------

### emuname-1.ini ###

list_title                                		(title of your choice, eg Joystick Games)

### Games List Settings ###
cycle_list                                1		(0=no, 1=yes)
list_type                                 normal	(normal / most_played / longest_played)
display_clone_info                        0		(0=no, 1=yes)
max_favorites                             0		(0=no limit, >0=limit)

### Execution Settings ###
commandline_format                        		(emulator commandline format *)
alt_commandline_format_1                  		(emulator commandline format *)
alt_commandline_format_2                  		(emulator commandline format *)

### Settings used by MAMEWAH ###
current_game                              1		(ignore, generated by MAMEWAH)


NOTE: emuname-0.ini does not have the list_type, display_clone_info or max_favorites settings, as these properties for the main list are fixed.