mirror of
https://github.com/mamedev/mame.git
synced 2024-11-16 07:48:32 +01:00
66 lines
2.5 KiB
ReStructuredText
66 lines
2.5 KiB
ReStructuredText
Configuring MAME
|
|
================
|
|
|
|
.. contents:: :local:
|
|
|
|
Getting Started: A Quick Preface
|
|
--------------------------------
|
|
|
|
Once you have MAME installed, the next step is to configure it. There are
|
|
several ways to do this, and each will be covered in turn.
|
|
|
|
If you are on Windows, the MAME executable will be called ``mame.exe``.
|
|
|
|
If you are on Linux or MacOS, the MAME executable will be called ``mame``.
|
|
|
|
|
|
Initial Setup: Creating mame.ini From Command Line on Windows
|
|
-------------------------------------------------------------
|
|
|
|
First, you will need to *cd* to the directory where you installed MAME into.
|
|
If, for instance, you have MAME installed in ``C:\Users\Public\MAME`` you will
|
|
need to type ``cd C:\Users\Public\MAME`` into the command prompt.
|
|
|
|
Then you have MAME create the config file by typing ``mame
|
|
-createconfig``. MAME will then create the ``mame.ini`` file in the
|
|
MAME installation folder. This file contains the default
|
|
configuration settings for a new MAME installation.
|
|
|
|
|
|
Initial Setup: Creating mame.ini From Command Line on Linux or MacOS
|
|
--------------------------------------------------------------------
|
|
|
|
The steps for Linux and MacOS are similar to those of Windows. If you
|
|
installed MAME using the package manager that came from a Linux distro, you will
|
|
type ``mame -createconfig`` into your terminal of choice.
|
|
|
|
If you have compiled from source or downloaded a binary package of MAME,
|
|
you will ``cd`` into the directory you put the MAME files into.
|
|
|
|
For instance, ``cd /home/myusername/mame``
|
|
|
|
Then you will type ``./mame -createconfig`` into
|
|
your terminal of choice.
|
|
|
|
You can then need to edit the ``mame.ini`` file in your favorite text editor,
|
|
e.g. *Notepad* on Windows or *vi* on Linux/MacOS, or you can change settings
|
|
from inside of MAME.
|
|
|
|
|
|
Initial Setup: Graphical Setup
|
|
------------------------------
|
|
|
|
This is the easiest way to get started. Start MAME by opening the MAME
|
|
icon in the location where you installed it. This will be ``mame.exe``
|
|
on Windows, ``mame`` on Linux and macOS.
|
|
|
|
Once MAME has started, you can either use your mouse to click on the
|
|
**Configure Options** menu selection at the bottom center of your screen,
|
|
or you can switch panes to the bottom one (default key is Tab), then press
|
|
the menu accept button (default key is Return/Enter) to go into the
|
|
Configuration menu.
|
|
|
|
Choose **Save Configuration** to create the ``mame.ini`` file with default
|
|
settings. From here, you can either continue to configure things from the
|
|
graphical user interface or edit the ``mame.ini`` file in your favorite
|
|
text editor.
|