NAME

xmame - THE Arcade game machine emulator for UNIX/X

SYNOPSIS

xmame.{x11,svga,xgl,sdl} [options] [rom]

DESCRIPTION

xmame is the (M)ulti (A)rcade (M)achine (E)mulator for Unix. It
emulates the hardware of many classic arcade game machines.
MAME is an arcade machine emulator. Started in 1997 by Nicola
Salmoria, MAME started out as a series of emulators for individual
games. This series of emulators was combined into a single multi-game
emulator. This is the current form of MAME; no longer a one-man show,
there are over 100 contributors to the project.

OPTIONS

Digitalsoundrelated-dpplugin,-dsp-pluginplugin
Select which plugin to use for digital sound.
-ldp,-list-dsp-plugins
List available sound-dsp plugins.
-[no]ti,-[no]timer
Toggle timer based audio (normally it will be used automatically
when necessary).
Soundmixerrelated-smpplugin,-sound-mixer-pluginplugin
Select which plugin to use for the sound mixer.
-lmp,-list-mixer-plugins
List available sound-mixer plugins.
Videorelated-bdepth,-bppdepth
Specify the colordepth the core should render, one of: 0 (auto),
8, 16.
-ahheight,-arbheightdepth
Scale video to exactly this height (0 = disable).
-heightscaleyaspect,-hsyaspect
Set Y-Scale aspect ratio.
-wsxaspect,-widthscalexaspect
Set X-Scale aspect ratio.
-sscale,-scalescale
Set X-Y Scale to the same aspect ratio. For vector games scale
(and also width- and height-scale) may have values like 1.5 and
even 0.5. For scaling of regular games this will be rounded to
an integer value.
-efeffect,-effecteffect
Video effect:
0 none (default)
1 scale2x (smooth scaling effect)
2 scan2 (light scanlines)
3 rgbstripe (3x2 rgb vertical stripes)
4 rgbscan (2x3 rgb horizontal scanlines)
5 scan3 (3x3 deluxe scanlines)
-[no]adb,-[no]autodouble
Enable/disable automatic scale doubling for 1:2 pixel aspect
ratio games.
-[no]sl,-[no]scanlines
Enable/disable displaying simulated scanlines.
-[no]art,-[no]artwork
Use additional game artwork (sets default for specific options
below).
-[no]backdrop,-[no]use_backdrops
Use backdrop artwork.
-[no]overlay,-[no]use_overlays
Use overlay artwork.
-[no]bezel,-[no]use_bezels
Use bezel artwork.
-[no]artcrop,-[no]artwork_crop
Crop artwork to game screen only.
-artresres,-artwork_resolutionres
Artwork resolution (0 for auto)
-fsrskip,-frameskipperskip
Select which autoframeskip and throttle routines to use.
Available choices are:
0 DOS frameskip code
1 Enhanced frameskip code by William A. Barath
-[no]th,-[no]throttle
Enable/disable throttle.
-ftrframes,-frames_to_runframes
Sets the number of frames to run within the game.
-[no]si,-[no]sleepidle
Enable/disable sleep during idle.
-[no]afs,-[no]autoframeskip
Enable/disable autoframeskip.
-mafsmaxskip,-maxautoframeskipmaxskip
Set highest allowed frameskip for autoframeskip.
-fsskip,-frameskipskip
Set frameskip when not using autoframeskip.
-brtbrightness,-brightnessbrightness
Set the brightness correction (0.5 - 2.0).
-pbpause,-pause_brightnesspause
Additional pause brightness (float).
-gcgamma,-gammagamma
Set the gamma correction (0.5 - 2.0).
-[no]nr,-[no]norotate
Do not apply rotation.
-[no]rr,-[no]ror
Rotate screen clockwise.
-[no]rl,-[no]rol
Rotate screen counter-clockwise.
-[no]autoror
Automatically rotate screen clockwise for vertical games.
-[no]autorol
Automatically rotate screen counter-clockwise for vertical
games.
-[no]fx,-[no]flipx
Flip screen left-right.
-[no]fy,-[no]flipy
Flip screen upside-down.
Vectorrelated-vresvres,-vectorresvres
Always scale vectorgames to XresxYres, keeping their aspect
ratio. This overrides the scale options.
-Bbeam,-beambeam
Set the beam size for vector games (float).
-fflicker,-flickerflicker
Set the flicker size for vector games (float).
-intensityintensity
Set intensity in vector games (float).
-[no]aa,-[no]antialias
Enable/disable antialiasing.
-[no]t,-[no]translucency
Enable/disable translucency.
X11related-x11mode,-x11-mode
Select x11 video mode (if compiled in).
0 Normal window (hotkey left-alt + insert)
1 Fullscreen DGA (hotkey left-alt + home)
2 Windowed Xv
3 Fullscreen Xv
X11-windowrelated-[no]cu,-[no]cursor
Show/don’t show the cursor.
-[no]ms,-[no]mitshm
Use/don’t use the MIT shared memory extension (if available and
compiled in).
-[no]fullscreen
Start in fullscreen mode.
-[no]yuv
Force YUV mode (for video cards with broken RGB hwscales).
-[no]yv12
Force YV12 mode (for video cards with broken RGB hwscales).
-[no]xs,-[no]xsync
Use/don’t use XSync instead of XFlush as screen refresh method.
-[no]p,-[no]privatecmap
Enable/disable use of private color map.
-[no]x,-[no]xil
Enable/disable use of XIL for scaling (if available and compiled
in).
-[no]mtx,-[no]mtxil
Enable/disable multi threading of XIL.
-[no]root,-[no]run-in-root-window
Enable/disable running in root window.
-ridwindow,-root_window_idwindow
Create the xmame-window in an alternate root-window, mostly
useful for frontends.
-geometrylocation,-geolocation
Specify the location of the window (string).
Videomodeselectionrelated-[no]ka,-[no]keepaspect
Try / don’t try to keep the aspect ratio of a game when
selecting the best videomode.
-darratio,-displayaspectratioratio
Set the display aspect ratio of your monitor (float). This is
used for -keepaspect. The default is 1.33 (4/3). Use 0.75
(3/4) for a portrait monitor.
-dmdisable,-disablemodedisable
Don’t use mode XRESxYRESxDEPTH. This can be used to disable
specific video modes which don’t work on your system. The
xDEPTH part of the string is optional. This option may be used
more then once
X11-inputrelated-[no]gm,-[no]grabmouse
Enable/disable mouse grabbing (also alt + pagedown).
-[no]gkb,-[no]grabkeyboard
Enable/disable keyboard grabbing (also alt + pageup).
-[no]wk,-[no]winkeys
Enable/disable mapping of Windows keys under X.
-mkkeymap,-mapkeykeymap
Set a specific key mapping, see xmamerc.dist.
Soundrelated-[no]snd,-[no]sound
Enable/disable sound (if available).
-[no]sam,-[no]samples
Use/don’t use samples (if available).
-fsnd,-fakesound
Generate sound even when sound is disabled. This is needed for
some games which won’t run without sound.
-sffreq,-samplefreqfreq
Set the playback sample-frequency/rate.
-bsbuffer,-bufsizebuffer
Number of frames of sound to buffer (float).
-vvolume,-volumevolume
Specify audio attenuation in dB (-32 (soft) - 0 (loud)).
-addevice,-audiodevicedevice
Use an alternative audiodevice.
-mdmixer,-mixerdevicemixer
Use an alternative mixerdevice.
Inputrelated-jtjoy,-joytypejoy
Select type of joystick support to use:
0 No joystick
1 Standard joystick
2 FM Towns pad
3 NetBSD/FreeBSD USB joystick
4 PS2-Linux native pad
5 SDL joystick
-[no]as,-[no]analogstick
Use joystick as analog for analog controls.
-jdevdevice,-joydevnamedevice
Joystick device prefix (defaults to /dev/js).
-[no]m,-[no]mouse
Enable/disable mouse (if supported).
-[no]ugcicoin
Enable/disable UGCI(tm) Coin/Play support.
-[no]pspad,-[no]usbpspad
Enable/disable USB PS Game Pad joystick support.
-[no]rapidf,-[no]rapidfire
Enable/disable rapid-fire support for joysticks.
-ctrlrcontroller
Preconfigure for specified controller, e.g., HotRod, HotRodSE,
SlikStik, XArcade.
FileI/Orelated-rprompath,-rompathrompath
Search path for ROM files.
-spsamplepath,-samplepathsamplepath
Search path for sample files.
-inipathinipath
Search path for ini files.
-cfg_directorycfgpath
Directory to save configurations.
-nvram_directorynvrampath
Directory to save nvram contents.
-memcard_directorymemcardpath
Directory to save memory card contents.
-input_directoryinputpath
Directory to save input device logs.
-hiscore_directoryhipath
Directory to save hiscores.
-state_directorystatepath
Directory to save states.
-artwork_directoryartpath
Directory for artwork (overlays etc.)
-snapshot_directoryscreenshotpath
Directory for screenshots (PNG format).
-diff_directorydiffpath
Directory for hard drive image difference files.
-ctrlr_directorycontrollerpath
Directory to save controller definitions.
-cheat_filecheatfile
Cheat filename.
-hiscore_filehifile-history_filehistoryfile-mameinfo_filemameinfofile-reckeyfile,-recordkeyfile
Set a file to record keypresses into.
-pbplayfile,-playbackplayfile
Set a file to playback keypresses from.
-outstdout,-stdout-filestdout
Set a file to redirect stdout to
-errstderr,-stderr-filestderr
Set a file to redirect stderr to.
-Llogfile,-loglogfile
Set a file to log debug info to.
MAMErelated-defdefaultgame,-defaultgamedefaultgame
Set the default game started when no game is given on the
commandline, only useful for the config files.
-langlanguage,-languagelanguage
Select the language for the menus and OSD.
-[no]fc,-[no]fuzzycmp
Enable/disable use of fuzzy gamename matching when there is no
exact match.
-[no]c,-[no]cheat
Enable/disable cheat subsystem.
-[no]skip_disclaimer
Skip displaying the disclaimer screen.
-[no]skip_gameinfo
Skip displaying the game info screen.
-[no]crconly
Use only CRC for all integrity checks.
-biosbios
Change system bios (int).
Frontendrelated-l,-list
List supported games matching gamename, or all, gamename may
contain * and ? wildcards.
-lf,-listfull
Like -list, with full description.
-lg,-listgames
Like -list, with manufacturer and year.
-ld,-listdetails
Like -list, with detailed info.
-lgl,-listgamelist
Like -list, with specially formatted extra info for generating
gamelist.mame.
-lsf,-listsourcefile
Like -list, with driver sourcefile.
-lcol,-listcolors
Like -list, with the number of colors used.
-lrs,-listromsize
Like -list, with the year and size of the ROMs used.
-lps,-listpalettesize
Like -list, with the year and palette size of the roms used.
-lr,-listroms
Like -list, but lists used ROMs.
-lcrc,-listcrc
Like -list, but lists used ROMs with CRC-32s.
-lsha1,-listsha1
Like -list, but lists used ROMs with SHA-1s.
-lmd5,-listmd5
Like -list, but lists used ROMs with MD5s.
-ls,-listsamples
Like -list, but lists used audio samples.
-lsd,-listsamdir
Like -list, but lists dir where samples are taken from.
-vr,-verifyroms
Verify ROMs for games matching gamename, or all, gamename may
contain * and ? wildcards.
-vrs,-verifyromsets
Like -verifyromsP,butlessverbose.-vs,-verifysamples
Like -verifyroms but verify audio samples instead.
-vss,-verifysamplesets
Like -verifysamplesP,butlessverbose-[no]cl,-[no]clones
Show / don’t show bootlegs/clones in the above list commands.
-lcl,-listclones
Like -list, but lists the clones of the specified game.
-li,-listinfo
List all available info on drivers.
-lc,-listcpu
List CPU usage statics per year.
Internalverificationlistcommands(onlyfordevelopers)-ldc,-listdupcrc
Like -list, but lists ROMs with identical CRC.
-lwo,-listwrongorientation
Like -list, but lists any games which use the orientation flags
wrongly.
-lwm,-listwrongmerge
Like -list, but lists any games which use the clone_of field
wrongly.
-lwf,-listwrongfps
Like -list, but lists any games which use the FPS field wrongly.
-srtn,-sortname
Sort ROMs by name.
-srtd,-sortdriver
Sort ROMs by driver name.
ROMidentificationrelated-id,-ident
Identify unknown ROM dump, or unknown ROM dumps in dir/zip.
-ik,-isknown
Check if romdump or romdumps in dir/zip are known.
Generaloptions-[no]lcf,-[no]loadconfig
Enable/disable loading of config files.
-sc,-showconfig
Display running parameters in rc style.
-mh,-manhelp
Print commandline help in man format, useful for manpage
creation.
-V,-version
Display version.
-?,-help
Show help.

EXAMPLES

LEGALNOTICE

The main issue involves ROM images. ROM images are protected under the
copyrights of their authors, and CANNOT be distributed in the same
package as xmame. Download any ROM images at your own risk and
responsibility.
PLEASEBEAWAREOFTHEPOSSIBLELEGALRAMIFICATIONSOFDOWNLOADINGROMIMAGES,BEFOREYOUACTUALLYDOSO!YOUHAVEBEENWARNED,ANDWETAKENORESPONSIBILITYFORYOURACTIONS--YOUAREONYOUROWN!
Also, the xmame authors ask that you DO NOT distribute any ROM images
with either source code or binaries of the xmame emulator.