This site is being upgraded. There might be temporary layout issues. If you encounter errors, please try again later.

FS-UAE Amiga Emulator

Documentation

Keyboard shorcuts

The following keyboard shortcuts are available by default. Mod means Cmd on OS X and Alt on other platforms, but it can be re-configured as another key. See the "modifier key" section for more information.

Note: The shortcuts are mapped against keys on a English keyboard, so on international keyboards, the key (symbol) you have to press may in some cases be different (but same physical key).

  • Use F12 to enter the FS-UAE on-screen menu.
  • Use Mod+F or Mod+Return to toggle full-screen mode.
  • Use Mod+Z or F11 to cycle through zoom modes.
  • Use Mod+B to toggle extra visible border.
  • Use Mod+S or Print Scrn to save a screenshot of the current Amiga frame to the desktop (or chosen screenshots location).
  • Use Mod+Q or Mod+F4 to quit.
  • Use Mod+D to activate (console) debugger.

Input control:

  • Use Mod+G to release or acquire the input grab. You can also use the middle mouse button, or enter the menu.
  • Use Mod+K to enable full keyboard emulation. This disables the modifier key to make it usable in emulation. In order to disable full keyboard emulation you need to press AltMod+K. This will usually be F12+K. Please see the "alternative modifier keys" section.
  • Use Mod+Up when you need to press Amiga cursor up and joystick emulation is enabled. Similar for Mod+Down, Mod+Left and Mod+Right.

Emulation control:

  • Use Mod+W to toggle warp mode (no frame limit, no audio). This does not affect the emulation accuracy, it only removes the pauses between generating frames.
  • Use Mod+R to perform a soft reset.
  • Use Mod+T to perform a hard reset.
  • Use Mod+P or Pause to toggle pause mode.
  • Use Mod+C to activate cartridge (Action Replay, ...).

Volume control:

  • Use Mod+, to decrease FS-UAE volume.
  • Use Mod+. to increase FS-UAE volume.
  • Use Mod+M to mute FS-UAE (press again to unmute).
  • Use Mod+N to mute floppy sounds (press again to unmute).

Disk swapper:

  • Use Prev (multimedia key) to go backward through the swap list.
  • Use Next (multimedia key) to go forward through the swap list.
  • Use Play (multimedia key) to insert the currently selected swap list entry into DF0.

RTG graphics control (shortcuts are subject to change)

  • Use Mod+F9 to toggle chipset/RTG display. ~~* Use Mod+1 to switch to chipset display.~~ ~~* Use Mod+2 to switch to RTG display (if any).~~

FIXME:

  • Tab – toggle chat function.
  • Ctrl+F10 – Toggle performance graphs / FPS display (There are two FPS numbers shown, SYS: actual video output frame rate. EMU: emulated video frame rate).
  • Alt+Tab (or Cmd+Tab) – Switch to another window / release input grab.

Note: It is possible to customize the keyboard shortcuts. See input mapping.

Modifier Key

The modifier key is the key used to trigger special keyboard shortcuts. The default modifier key is Cmd on OS X and Alt on all other operating systems. From now on, we will refer to the modifier key as Mod.

Note: You can specify another key with the modifier_key option.

Since Mod is used to trigger special actions, this key is not directly usable for Amiga emulation. This means that -- unless you have overridden the modifier key -- you will not be able to use this key alone to trigger the Amiga "Left Alt" key. The solution to this is to enable full keyboard emulation when you need it by pressing Mod+K.

Note: On OS X you'll have problems with the "Left Amiga" key instead.

Alternative modifier keys

The F12 and F11 are always available as modifier keys. This is useful when full keyboard emulation is enabled since the normal modifier keys is then disabled. The Amiga does not have either F11 or F12, so this does not interfere with the emulation.

Note: On many laptops the function keys can only be used while pressing Fn. If this is the case on your keyboard, you need to hold this key as well when you are asked to use a function key.

Function keys in OS X

On OS X, using a function key (if necessary in combination with Fn) may trigger a desktop function such as the "Dashboard" instead. So in order to be able to use for example F12 you may need to add another modifier key such as Cmd into the mix so OS X will not recognize the key combination. For example Cmd+F12 will not trigger the "Dashboard", but will still open the FS-UAE menu, since FS-UAE allows F12 to be used with any modifier.

Depending on your keyboard setup, you may even have to press Fn+Cmd+F12. This is getting a bit ridiculous, so what you can do instead is one or more of the following:

  • Avoid the use of function keys where possible. You can use Cmd-based shortcuts instead for most purposes.
  • Alter OS X keyboard settings so function keys can be used without Fn.
  • Alter OS X preferences and disable the desktop shortcut for the function key you want to use, for example F12.
  • Use a gamepad to open/close the FS-UAE menu.
  • If you do not want to alter OS X settings, but still want to be able to open/close the FS-UAE menu using a single key press, you can use input mapping to assign action_menu to a keyboard key. You should choose a key which you do not need to use for Amiga emulation.