Manual: Setup

From OpenMPT Wiki
Jump to: navigation, search
Setup icon

When you run OpenMPT for the first time, the Options dialog can be reached immediately from the Welcome dialog, but you can dismiss this if you want to just dive right in. You can also open this dialog box any time by clicking on the Setup icon in the Main toolbar or opening the View menu in the Main menubar and selecting “Setup”. It is also possible to set a keyboard shortcut in the Keyboard page of this dialog window, by default it is set to Ctrl+F1.

Setup dialog

Structure of the Setup dialog[edit]

Behaviour and display preferences can be accessed by clicking on the tabs the top of the setup dialog. To save the preferences, click on Apply or OK (which will also close the window). The following setup pages are available. Click on any of the list items to read more about the corresponding section.

  • General - Miscellaneous options.
  • Soundcard - For setting up the device that shall be used to output sound.
  • Mixer - For setting up sample interpolation, polyphony and other mixer-related settings.
  • DSP - For setting up player effects and the global equalizer.
  • Samples - Default settings for the sample and instrument editor.
  • Keyboard - For keyboard behaviour and shortcut configuration.
  • Display - For configuring the looks of the editor.
  • MIDI - For setting up MIDI recording / importing.
  • Paths / Auto Save - For setting up default directories and the creation of periodic backups.
  • Update - For configuring the automatic update check.
  • Advanced - A list of almost all configuration variables for advanced usage.
  • Wine - For Wine-specific options (not available on Windows systems).

Technical information[edit]

Most of the preferences that are set in the Options page are stored in the file mptrack.ini and can be edited in a simple text editor if necessary. Generally, however, you want to make these changes within OpenMPT so you can tell what you are doing. Besides the mptrack.ini file, there is the Keybindings.mkb file (which saves the keyboard shortcuts), the plugin.cache file (which caches information about previously loaded plugins to speed up the loading process of the program) and optionally there are .tun files (which store custom tunings). These files are kept in the folder "%APPDATA%\OpenMPT". However, when using OpenMPT in portable mode (such as on a removable device), all of these external files are kept in the root directory of the ModPlug Tracker application. In either case, you can use Show Settings Folder from the Help menu to open the folder containing all configuration files.