mupen64plus(6)							   Games Manual 						    mupen64plus(6)

NAME

       mupen64plus - Console front-end for the Mupen64Plus N64 emulator

SYNOPSIS

       mupen64plus [parameters(s)] [romfile]

DESCRIPTION

       Mupen64Plus is a plugin-based N64 emulator for Linux/Unix, OSX, and Windows which is capable of accurately playing many games. Included are
       four MIPS R4300 CPU emulators, with dynamic recompilers for 32-bit x86 and 64-bit amd64 systems, and necessary plugins for audio, graphical
       rendering (RDP), signal co-processor (RSP), and input. There are currently two OpenGL video plugins available: the included Rice Video, and
       Arachnoid (at http://bitbucket.org/wahrhaft/mupen64plus-video-arachnoid/).

       The most current documentation can be found at the project's homepage:

       http://code.google.com/p/mupen64plus

       -h, --help
	      Print help message.

       --noosd
	      Disable onscreen display.

       --osd  Enable onscreen display.

       --fullscreen
	      Run emulator in fullscreen display mode.

       --windowed
	      Run emulator in windowed display mode.

       --resolution res
	      Display resolution (640x480, 800x600, 1024x768, etc)

       --cheats cheat-spec
	      Enable or list cheat codes for the given rom file.

       --corelib filepath
	      Specifies a filename (optionally with a preceding directory path) to load a specific Mupen64Plus core library.

       --configdir directory
	      Specifies a directory to look for the mupen64plus.cfg file. Default is ~/.config/mupen64plus/.

       --datadir directory
	      Specifies a directory to search for shared data files (fonts, cheat codes, .ini files). Default is PREFIX/share/mupen64plus/.

       --plugindir directory
	      Specifies a directory to search for plugin files. Default is PREFIX/lib/mupen64plus/.

       --sshotdir directory
	      Specifies a directory to save screenshots captured during gameplay. Default is ~/.local/share/mupen64plus/screenshot/.

       --gfx plugin-spec
	      Specifies a plugin-spec to select a graphics plugin for use during emulation.

       --audio plugin-spec
	      Specifies a plugin-spec to select an audio plugin for use during emulation.

       --input plugin-spec
	      Specifies a plugin-spec to select an input plugin for use during emulation.

       --rsp plugin-spec
	      Specifies a plugin-spec to select an RSP plugin for use during emulation.

       --emumode mode
	      Specifies which mode the emulator core should run in. mode should be set to  one	of  the  following  numbers:  0=Pure  Interpreter,
	      1=Cached Interpreter, 2=Dynamic Recompiler (DynaRec).

       --testshots list
	      Take screenshots at frames given in the comma-separated list, then quit.

       --core-compare-send
	      Use  the core comparison debugging feature, in data sending mode.  If the core was not compiled with support for the Core Comparison
	      feature, then the emulator will exit with an error.

       --core-compare-recv
	      Use the core comparison debugging feature, in data receiving mode.  If the core was not compiled with support for the Core  Compari-
	      son feature, then the emulator will exit with an error.

       --set param-spec
	      Set  the	value of a Mupen64Plus configuration parameter.  This option may be used multiple times.  The format of param-spec is Sec-
	      tion-Name[Param-Name]=Value

       --saveoptions
	      Save the given command-line options into the mupen64plus configuration file to use as defaults in the  future.   Since  the  console
	      front-end needs to load the core library before reading the configuration file, the --corelib option cannot be saved.

       --verbose
	      Print lots of information. Useful for debugging but unnecessary for normal use.

plugin-spec
       (plugin-name)
	      Filename (without path) of plugin to use.  Application will search through several directories to look for a matching plugin name.

       (plugin-path)
	      Full directory path and filename of plugin.

       'dummy'
	      Use the dummy plugin.

cheat-spec
       'list' Show all of the available cheat codes.

       'all'  Enable all of the available cheat codes.

       (codelist)
	      A comma separated list of cheat code numbers to enable.

KEY COMMANDS

       The  following  shortcut  keys  can be used during emulation.  These are the default key values; nearly all of them may be set to different
       keys by editing the mupen64plus configuration file.

       Escape Quit the emulator.

       0-9    Select virtual 'slot' for save/load state.

       F5     Save emulator state to current slot.

       F7     Load emulator state from current slot.

       F9     Reset emulator.

       F10    Slow down emulator speed by 5 percent.

       F11    Speed up emulator speed by 5 percent.

       F12    Take screenshot.

       Alt-Enter
	      Toggle fullscreen mode.  This is not supported on Windows.

       p or P Pause/continue emulation.

       m or M Mute/unmute sound.

       f or F Fast Forward (playback at 250% normal speed as long as key is pressed)

       g or G Press GameShark button (if cheats are enabled).

       / or ? Advance one frame if paused.

       [      Decrease volume.

       ]      Increase volume.

FILES

       The default location for the Mupen64plus configuration file is ~/.config/mupen64plus/.  The default location of the  saved  screenshots	is
       ~/.local/share/mupen64plus/screenshot/.	The default location of the save states is ~/.local/share/mupen64plus/save/.

BUGS

       To report bugs or make feature requests, use the issue tracker on the Mupen64Plus project site:

       http://code.google.com/p/mupen64plus/issues/list

AUTHORS

       Mupen64Plus was originally started by Richard42 and nmn, and is based on Mupen64 (originally written by Hacktarux).

       This man page was written by ebenblues, and updated by Richard42.

COPYRIGHT

       Mupen64Plus is (C) 2008-2010 The Mupen64Plus Team License GPLv2+: GNU GPL version 2 or later <http://gnu.org/licenses/gpl.html>

       This is free software: you are free to change and redistribute it.  There is NO WARRANTY, to the extent permitted by law.

																    mupen64plus(6)