Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
The MiST firmware has a few configuration options available, which can be set by adding a "mist.ini" file to the root of the SD card.
Overall the file should contain a "mist" tag at the top:
[mist] keyrah_mode=0 scandoubler_disable=0 mouse_boot_mode=0 joystick_ignore_hat=0 joystick_ignore_osd=0 joystick_disable_shortcuts=0 joystick0_prefer_db9=0 key_menu_as_rgui=0 reset_combo=0 ypbpr=0 keep_video_mode=0 led_animation=0 key_remap=04,05 key_remap=05,04 hid_button_remap= joystick_remap= joy_key_map=
Comments can be added after each setting by using ; e.g.:
[mist] scandoubler_disable=0 ; leave at 0 if not sure ...
If set to 1, some cores will disable their scandoubler to produce a 15khz video signal. This works better for upscalers and arcade displays. Also if you want to use a VGA-to-SCART cable with MiST, you need to set this option to 1.
Support is core specific; currently it is used by the ST, Amiga, Colecovision, Vic20 and Astrocade and several other cores. Cores not supporting this will ignore the setting.
For more details see Scart cable.
If set to 1, it disables joystick0 reordering. Default value is 0. Joystick reordering is used when one or more USB joystick devices are detected, and it moves any DB9 - connected devices to joystick numbers 3, 4, etc. When this setting is enabled, it allows use of a real Amiga DB9 mouse even if USB devices are present.
If set to 1, the four LEDs on the bottom side of the MIST V1.3+ boards (some sold in clear cases) show some knight rider like animation.
If set to 1, some cores will enable component (YPbPr) video output. For more details see YPbPr/RGsB cable.
If set to 1, YPbPr and/or Scandoubler modes will be preserved between cores till reset button is pressed (either on MiST board, or hard reset key combination).
Choose key combination for reset:
0 - LCtrl-LAlt-RAlt 1 - LCtrl-LGui-RGui (Ctrl-LAmiga-RAmiga) 2 - LCtrl-LAlt-Delete
If set to 0 then keyrah v2 converter will have special tweaks for convenient usage in Minimig and other cores. Please note it requires ISO US/UK type of keyboard (with two blank keys). For ANSI and localized keyboards set this option to 1 to disable all keyrah tweaks.
Set to 1 to revert back to an old mouse handler which may solve compatibility issues with some mice (the default handler is much more compatible with keyboard/mouse wireless devices, though).
If set to 1, the firmware will revert to old behavior of using analog axes instead of the digital direction pad, which is the default behaviour for newer firmwares (since firmware_150524).
This allows you to remap USB HID keycodes reported to the cores. For example, if you want to exchange the keys 'a' and 'b' on your keyboard you'd want to have the USB HID keycodes 04 (the USB Usage ID of the key labeled 'a') and 05 to be exchanged the mist.ini would look like:
[mist] key_remap=04,05 key_remap=05,04
This makes key 04 to be reported as key 05 and vice versa.
Per core settings override
Each core may need some different settings like key remap or scandoubler enable/disable. Any option from "mist" section can be overridden for specific core. Just add another section with core name and new value for desired setting. Hardcoded names for specific cores: MINIMIG, ST, PACE, ARCHIE. For 8bit cores use names you see on main page of OSD on the left vertical stripe.
"mist" section should be the first section in INI!