Video Options

These options do not affect the Amiga emulation itself, but will affect how the Amiga output is displayed on your computer. These options may affect how well FS-UAE performs.

Display Settings


Open the emulator in fullscreen or windowed mode (1 = fullscreen, 0 = window). The default is windowed mode at 960×540.

 fullscreen = 0


Since 1.1.8. You can set this option to fullscreen-window instead if you want to use the fake fullscreen support (a borderless window the size of the current display will be created instead of switching to real fullscreen).

fullscreen_mode = fullscreen


Since 1.1.8. Use to override fullscreen mode width. Normally this is not necessary, as FS-UAE uses the current desktop resolution by default (recommended), but can be useful in some circumstances (multi-monitor setups on nVIDIA/Linux).

fullscreen_width = 1024


Since 1.1.8. Use to override fullscreen mode height.

fullscreen_height = 768


Specify the width of the FS-UAE window to create on start-up.

window_width = 960


Specify the height of the FS-UAE window to create on start-up.

window_height = 540


Set to 0 to make the window non-resizable.

window_resizable = 1


Set to , 4 or 8 to enable full-scene anti-aliasing (reduces jagged edges in menu-mode). Specify 2 for 2x, 4 for 4x, etc. This may negatively impact rendering performance, depending on your GPU.

fsaa = 0


If keep_aspect is set to 1, the amiga video output will be scaled with the aspect ratio intact, otherwise it will be stretched to fill the screen. The default is 0.

keep_aspect = 0

Filters, Shaders and Scaling

scanlines = 0

Enable scanlines by setting scanlines to 1. The default is 0. When scanlines are enabled, you will see aliasing effects if your resolution is low (and in window mode). Use fullscreen mode with sufficient resolution and the scanlines effect should look good. There will also be a visible moire pattern when entering menu mode (this is normal). Scanline rendering is done on the CPU, and this may negatively impact emulation speed if you do not have a sufficiently fast CPU.

rtg_scanlines = 0

Since 1.1.3. By default, when enabling scanlines, they are not shown when the Amiga opens a RTG screen (“Picasso96”). You must also set rtg_scanlines = 1 if you want to render scanlines on these screens.

scanlines_dark = 10

Intensity of scanlines, in percent. The default, when scanlines are enabled, is 10 (percent) black.

scanlines_light = 5

To prevent an overall darker image, you can lighten the “other” lines. The default, when scanlines are enabled, is 5 (percent).

shader = curvature

Since 1.3.0. The option shader be either the name of a bundled shader, or path to a shader in XML Shader Format 1.1. The bundled shaders are:

  • curvature
low_resolution = 0

Since 1.3.2

line_doubling = 1

Since 1.3.2

scale_x = -1.0

Since 1.3.0

scale_y = -1.0

Since 1.3.0

align_x = 0.5

Since 1.3.0

align_y = 0.5

Since 1.3.0

zoom = 640x512+border

Since 1.3.2. This setting controls the initial mode for the F11 zoom key, which defaults to auto. Valid values are (with or without +border):

  • auto – viewport settings are only used in auto mode
  • full – which is full frame, not full zoom
  • 640×400
  • 640×480
  • 640×512

The zoom settings has no effect while in RTG graphics mode (“Picasso 96”).


Since 1.3.8. FS-UAE by default renders the Amiga display as a texture with texture filter set to GL_LINEAR. You can use the following option to force GL_NEAREST filter:

texture_filter = nearest

Video Synchronization

The following option can be used to override the automatic configuration of video synchronization.

video_sync = auto

Video sync behaviour can be configured with the “video_sync” option. The default setting is auto. The available values are:

  • off – video and emulation will not be synced to the display
  • vblank – video buffer swap (but not emulation) will be synced to vblank to remove tearing
  • full – emulation and video will be synchronized to the display. This will give perfect scrolling if the display refresh rate matches the game’s refresh rate.
  • auto – this sets video sync to “full” if the refresh rate matches the game’s refresh rate, and “vblank” if not.

It is generally recommended to leave this option at auto. If you change your desktop to a 50Hz screen mode, full synchronization and smooth scrolling will be enabled automatically.

video_sync_method = finish-sleep-swap-finish

Since 1.1.9. Choose the method used to ensure video synchronization with the display. Valid values are:

  • swap – Most basic method, but will probably not mantain emulation perfectly in sync on many  GPUs due to pipelining and the swap buffers command returning before  it is completed.
  • swap-finish – This method should force the emulation to be in sync with the display, but glFinish may use a busy-loop and cause high CPU usage.
  • finish-swap-finish – Execute a glFinish also before swapping buffers. May work better with some OpenGL drivers. Otherwise same as swap-finish (High CPU usage with many drivers).
  • finish-sleep-swap-finish – Same as above, but sleep before executing the swap command. The sleep time is based on the (estimated) time left to the next vblank. This should reduce the CPU usage a lot, but on some systems/drivers, the display will not be synchronized properly.
  • sleep-swap-finish – Same as above, but do not issue a glFinish before starting the sleep. This should use less CPU than the above option, but some drivers seem to need the finish before the sleep to achieve proper sync.
  • swap-fence – Set a fence after swapping buffers and poll periodically (with sleeps)   for completion of swap. This seems to work very well on Linux with recent nVIDIA drivers.
  • swap-sleep-fence – Same as above, but sleep a while (based on estimated time to next vblank) before starting to pool the fence, (in case the test-fence method blocks with high CPU usage, problem seen on nVIDIA/Windows).

The default value is:

  • for Windows and Mac OS X: finish-sleep-swap-finish
  • for Linux: finish-swap-finish

Video and Texture Buffer Formats

Changing the video and texture buffer formats may improve texture upload speed on your computer. The default values are the most efficient options for most computers.


Since 1.1.4. This option allows you to configure whether video data is stored in RGBA or BGRA byte order in the internal video buffers. This setting (together with texture_format) may affect texture upload performance. The option should not be shared between computers, since appropriate values may differ for other operating system or OpenGL GPU vendors. Valid values are:

  • bgra – This is the default setting as it has been verified to provide best performance with most OpenGL drivers.
  • rgba – Depending on your system, this may give better performance.
video_format = bgra


Since 1.1.4. This option allows you to configure the internal texture format used by OpenGL for displaying the Amiga video frames. This setting (together with video_format) may affect texture upload performance. The option should not be shared between computers, since appropriate values may differ for other operating system or OpenGL GPU vendors. Valid values are:

  • rgb
  • rgb8
  • rgba
  • rgba8
texture_format = rgb

65 thoughts on “Video Options

  1. Hi, is there any way to get the display like MAME cocktail mode at all please? I have a cocktail cabinet and want to play 2 player games on it, but the joysticks are at either end of the cabinet.

  2. Yes, I confirm this. It is definitely not an emulation problem or a display/graphics-driver problem as I first thought. There must be different versions of the game. I also tested another version of Monkey Island (in english, Skid Row) with FS-UAE and the sprite colors are fine there. – My conclusion: The emulator works perfectly. Thank you for taking the trouble to help me.

  3. I have installed FS-UAE on a Raspberry Pi 4B with the newest version of the Raspberry Pi OS (current version of FS-UAE in the package manager is 2.84).

    I have tested a bunch of games and they work really good (except for a bit of tearing at the very top of the screen but I can live with it). The only game I see a little problem with is “Monkey Island 1”: The characters’ faces seem way too dark. They are usually light pink on a real Amiga but in FS-UAE they look more dark red or purple.

    What irritates me is that I don’t see any problems with the colors in other games and even with Monkey Island everything seems to be fine except the colors of the faces. The game itself runs fine, even from hard drive.

    Do you have any idea what could be causing these wrong colors? Or what could I try to correct it?

      • I have sent an e-mail to you with the subject “Raspberry Pi: Monkey Island color problem”. I would be happy if you could take a look at it and tell me what you think.

        • Hi, I got your email with screenshot. I does indeed look incorrect, but it does not really look like a color problem to me. Instead, it looks like the character sprites are from the DOS EGA version… (?)

          Exactly what version of Monkey Island are you using? If unsure, you can send the disk images to me.

          • Yes. This is exactly what I thought. The colors look like the PC/EGA version.
            But how could this be? As far as I know there’s only one Amiga version.
            I have sent you an e-mail with my version of the game.

          • It really looks like the PC/EGA version. But how can this be? Are there different versions of the Amiga version? I have sent an e-mail with the disk images to you.

          • Yes, it looks like there are different versions. I confirmed the “problem” with your version, and tested several others:

            “Correct” colors:
            ADF, v1.2, cr SR
            ADF, v1.0, FR, cr Defjam
            ADF, v1.0, ES, cr

            “EGA” colors:
            ADF, v1.1, DE, cr QTX
            ADF, v1.0, IT, cr

            So it does not look like an emulation problem at least (I haven’t tested on a real Amiga yet, but I’m quite sure) 🙂

  4. When I run this in windowed mode, I cannot drag the window around without it jumping to another location until you cannot even see the window. It never pushes totally off the screen, because I can usually see the top bar so I can kill the program. I did change the setting for the mouse to not grab input on click and that lets me move the window around, but when I click into the window to use the Amiga, the mouse follows the MacOS mouse and the Amiga is pretty much unusable…




    • Sounds like the mouse isn’t ungrabbed properly. I’m not sure how you “free” the mouse cursor in the first case to be able to drag the window? Perhaps some macOS key combination to switch to another window?

      The point is that when using the Amiga, the mouse should be locked to the FS-UAE window. You can click the middle mouse button (if you have that), or Cmd+G to toggle the mouse grab! So, Cmd+G to allow you to move the window around, and Cmd+G again to hide the cursor and use the mouse inside FS-UAE.

    • What it says in the parentheses; “a borderless window the size of the current display will be created instead of switching to real fullscreen”. This might be handled differently from a window in proper fullscreen mode depending on the operating system.

  5. Hi
    I am using 4:3 lcd multisync monitor 1600×1200.

    I have added to video driver 1600×1200 50 hz mode, specifically for FS UAE to play in fullcreen with smooth scrolling. It works fine, but only if I switch manually desktop resolution from 1600×1200 60 hz (default) to 1600×1200 50 hz.
    Is there any option to force FS UAE to go fullscreen 1600×1200 in 50 hz, while staying 1600×1200 60 hz with my default desktop resolution when not in FS UAE?

    I tried to:
    add assume_refresh_rate = 50

    But it doesn’t switch it

    • Hi, no, FS-UAE doesn’t have this capability, might appear in the next development series.

      (assume_refresh_rate just let’s you insist on what the refresh rate is, in case FS-UAE does not detect it properly, it doesn’t change anything)

  6. hi,
    how can i change video resolution on fullscreen mode?
    i add this on “~/Documenti/FS-UAE/Data/Settings.ini” but doesn’t work.

    fullscreen_height = 480
    fullscreen_width = 640

    • Hi, FS-UAE can currently not change fullscreen resolution. There are no fullscreen_width/height options. It will only use the current desktop video mode.

  7. Problem with the fullscreen mode in FS-UAE Arcade. Version 2.8.0, Mac OS Sierra.

    Whenever I launch FS-UAE Arcade it leaves the Mac Menu Bar on the top and the Dock at the bottom. It is not _completly_ fullscreen. When I start a game it wents to complete fullscreen mode. As this is a new behavior I want to know if this can be fixed or if it is a feature?

    • Hi, this is by design, well, actually, only the menu bar was supposed to be visible, so I need to check that out. The reason is to avoid problems happening sometimes when starting one fullscreen app from another.

      There is an option to start FS-UAE Arcade in fullscreen though, check FS-UAE Launcher -> Settings -> FS-UAE Arcade!

      • Thank you! I’ve changed the settings. Now I have fullscreen. But even when I switch back to Standard mode both will still be visible: dock and menu bar.

  8. Hi, it’s great that some GLSL shaders are already implemented, for example shader = crt looks good — but it’s too curved for my tastes. I’d like to adjust the overscan, distance and curvature radius in crt.shader.

    How can I apply the new shader after editing the “FS-UAE” file ?
    Just editing the file doesn’t seem to do anything, I’ve tried restarting FS-UAE but that doesn’t help…

    I’m on Mac OS X.

    Cheers 🙂

    • Hi, you should copy the shader file to some other location of your choice (but preferably outside of the .app so any app upgrade won’t delete your customization). Then use the shader option to point to the full path of the shader file.

  9. Any idea why WinUAE offers more UAE display modes?

    There is nothing between 1344×1080 and 2560×1440 in FS-UAE. In WinUAE I can chose 1600×900 and many other modes. I have copied over a harddisk file from my Amiga Forever installation and both emulators are set to UAEGFX Zorror III. In AF I don’t have the PAL modes either.

    • Hi, I believe WinUAE adds all “native” resolutions supported by the host system (Windows). FS-UAE never changes screenmode, and only uses the native/full desktop resolution and scales the UAEGFX display, so I felt it didn’t make sense to add all the host resolutions.

      Is there any specific resolution you are missing, which would be useful to you? If so, could you tell me why? I could perhaps add an option to allow users to add a custom UAEGFX resolution…

    • I will not be writing shaders myself, but I have created shader support (GLSL) for FS-UAE, and some CRT emulation shaders already work. For example shader = crt (in advanced settings).

  10. The pixels look slightly blurred when using a 1080p resolution. I have confirmed this by taking screenshots and loading them in photoshop. I have fullscreen set to 1 and keep aspect set to 1. There is no bluriness when using at lower resolutions like 1680 x 1050. I am using the latest dev version although I have also experienced this on earlier versions.

    • Hi, blurred pixels are unavoidable when scaling up the Amiga display to non-integer sizes (not strictly true, the alternative is uneven pixels which are sharp, but uneven pixels looks worse). What you need to do to get sharp pixels is to ensure that the display is scaled by integer (“whole number”) factors, such as 2x or 3x.

      Since you use 1920×1080, one good alternative is to use a new zoom in the recent development version: 704×540. 1080 / 540 = 2, so this will get sharp pixels in the vertical direction. If you then also use the keep_aspect option, the pixels will be scaled by the same factor horizontally so you’ll end up with a sharp 1408×1080 output centered on your 1920×1080 screen.

      TL;DR: a good choice for 1080P: zoom = 704x540, keep_aspect = 1

      • Thanks for your help, it is a big improvement but still ever so slightly blurry. But as you say, seems to be unavoidable at 1080P.

        • No, I didn’t mean to say you couldn’t get a sharp result. You can! I forgot to mention that for a complete sharp result, you also need to change from the “bi-linear” filter to “nearest”. Video -> Advanced in FS-UAE Launcher, set texture filter to GL_NEAREST.

          This will always give a sharp result, but as I mentioned in my previous reply, it only gives a “good” result when scaling is 2x, 3x, 4x (etc) as the previous options I mentioned ensures.

          So, here’s an updated list of options which gives 100% sharp pixels of 4x size for 1080P:
          zoom = 704x540, keep_aspect = 1, texture_filter = GL_NEAREST

          Enjoy 🙂

          • Thanks for your reply, I have tried those settings and am getting some bluriness still. I have uploaded the ‘real’ screenshot here:
            The settings I am using are:
            fullscreen = 1
            keep_aspect = 1
            zoom = 704×540
            texture_filter = GL_NEAREST

            My monitor resolution in Windows is 1920×1080.

          • Sorry, wrote one of the configuration values incorrectly. It should be texture_filter = nearest.

          • texture_filter = nearest did the trick thanks. Pixels are now crisp with no blur.

  11. Hi, I run Win7 and have a 1920×1200 monitor as my primary display and a 1920×1080 TV as a secondary display that I use to play emulated games. Could anyone please advise how to display FS-UAE in full screen mode on my second screen?

  12. Hi. Is there some command or launcher setting to control which display the Arcade and the emulation window, in a two display setup? I want them both fullscreen on secondary display. A workaround is to use a script that switches primary/secondary before starting the Arcade (and the resets on close). But it would be handy to have that built in.

    BTW I read here that a FS Game Center is in the works. That was last May – any news? That post says there are builds available. Any chance one can test drive it? The Arcade is a great frontend! The autoimport of game configs is only icing on the cake. A Game Center with manual config creation for all non-Amiga games would still be very useful.

    • Hi, with recent development versions of FS-UAE, you can finally specify which monitor to use in a multi-monitor environment (it’s in Launcher Settings) 🙂

  13. Hej Frode,
    I am running a version of the old e-uae on an arcade cabinet, together with MAME and VICE. e-uae is able to render to SDL/framebuffer, without the need for UNITY or any other Desktop environment…. thus, I can select a game via my own interface and launch the apropriate emulator (be it Arcade, C64 or Amiga). However, e-uae is old and difficult, so I would like to use a newer version…. but FS-UAE is not able to run without a Desktop Environment, is that right? I have not been able to find a way to get it to render to SDL without an Environment….. is that correct? Will it ever be?

    • FS-UAE on Linux/Unix requires SDL(2) and OpenGL. It kind of implicitly requires X11 (no desktop environment needed) since the GL drivers usually runs via X/GLX.

      Support for running directly on the framebuffer isn’t planned. There’s a EGL/GLES port of FS-UAE on github which may run on Linux without X on some systems.

  14. Apologises if this has been asked before but once a game loads up how do i get that in full screen and not just a little window in the middle of the screen. I have a macbook.
    Amazing program you’ve set up! reliving my childhood once again!

    • Before you use the start button in FS-UAE Launcher, there’s a button to the left of it which toggles fullscreen/window mode. When FS-UAE is running, you can use a keyboard shortcut to toggle fullscreen/window mode.

      • Thanks Frode! Could you also tell me, are the mouse and joystick set ups different for every game?

        • I’m not sure what you are asking. If the question is related to the online game database, then yes, the game entries can specify different input settings for different games.

  15. Is there any easy way to record video out from FS-UAE? Other than using some sort of Screen Recorder? I’m on a Mac. Wanting to record video animation. Wondering if there would be a easy way to out to the new Syphon Recorder project. Amazing app, records full screen resolution without killing your processor. Records from video mixer apps like Modul8 and Arena right now.


  16. Hi Frode, only a brief question. Thre’s any option to rotate the screen 90, 270 degrees for example. I’ve a pinball cabinet and my screen is in vertical position.

    Is really dificult to find emulators with this option like MAME or MESS have.

    Regards from Spain (sorry for my english).

    • No, there’s no feature to rotate the screen (though due to flexible shader support, anyone could in theory write an OpenGL shader to perform the rotation without changes to FS-UAE itself…). But many display drivers allow for rotating the screen in the driver itself, wouldn’t this be better? Then all software would work fine on your screen…

  17. Hey Frode. I find that the themes are set to fit a 16:9 aspect screen. I have a Mac Display which is 16:10 aspect. As such, the theme stretches to fill the extra space on my screen and so too does the Amiga display. Is there a way to stop the theme from stretching to fill my monitor screen?

  18. If you find that FS-UAE crashes when you try to use the full screen option, try to add values for fullscreen_height and fullscreen_width.

  19. Run the good old DOC DEMO (with demons moving around in patterns). (It is a really old demo.) The whole screen keeps resizing as the emulator tries to adjust everything to fit inside the screen. Everything jumps up and down. It you turn “Keep Aspect Ratio” on it gets even worse. Everything wobbles and there is no way to turn off this auto-fit-to-screen thing to run the demo normally.

    • The default autoscaling feature will get confused with some games/demos. You can use F11 to cycle through some fixed zoom levels. You can also set this option in preferences in FS-UAE Launcher.

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.