English Amiga Board - View Single Post - FS-UAE 3.1-stable

FrodeSolheim · 02 November 2021, 15:04

While I'm primarily working on FS-UAE & Launcher 4, I've seen the need to do some updates to version 3 as well. Especially for macOS users where 3.0.5 is not working very well on the latest macOS releases. But it has useful fixes for other platforms as well, including a fix for using

.lha

archives on Windows and a compatibility fix for using QEMU-UAE on recent Linux distros. I haven't announced version 3.1 on fs-uae.net yet, among other things because I don't have installers prepared yet, and I also haven't had time to make sure that FS-UAE Arcade runs correctly. Apologies for not having a more smooth upgrade path, but I simply haven't had time.

Please consider subscribing to this thread to get information about updates. - And please let me know if these instructions are unclear!

EDIT: A new download page for FS-UAE 3.1 is now up at https://fs-uae.net/download. Please go there instead of using the links below, there are slighly newer versions on the official download page now.

Windows

You'll need to have an archiver with support for
```
.tar.xz
```
for now. I recommend https://www.7-zip.org/.
Download the
```
.tar.xz
```
archives for your operating system and extract the contained
```
FS-UAE
```
and
```
FS-UAE-Launcher
```
folders to wherever you like.
You must keep these folders stored alongside each other.
The
```
fs-uae-launcher.exe
```
executable is found within
```
FS-UAE-Launcher/Windows/x86-64
```
. You can make a shortcut to this of course to make starting it easier.

FS-UAE_3.1.43_Windows_x86-64.tar.xz
FS-UAE-Launcher_3.1.32_Windows_x86-64.tar.xz

Go to https://fs-uae.net/download instead.

Linux

Download the
```
.tar.xz
```
archives for your operating system and extract the contained
```
FS-UAE
```
and
```
FS-UAE-Launcher
```
directories to wherever you like.
You must keep these directories stored alongside each other.
The
```
fs-uae-launcher
```
executable is found within
```
FS-UAE-Launcher/Linux/x86-64
```
. You can make a shortcut to this of course to make starting it easier.

FS-UAE_3.1.43_Linux_x86-64.tar.xz
FS-UAE-Launcher_3.1.32_Linux_x86-64.tar.xz

Go to https://fs-uae.net/download instead.

macOS

Download the
```
.dmg
```
images for both FS-UAE Launcher and FS-UAE, and copy the apps within to
```
/Applications
```
or wherever you like.
You must keep the two apps stored alongside each other.
Choose the correct versions for your machine. the ARM64 version is for Apple Silicon (M1 Macs), and x86-64 is for Intel hardware. If you are unsure, just go with x86-64 which should work on all recent macOS systems.
The ARM64 version will run faster on M1 Macs, but does not support JIT compilation. You should be able to run the x86-64 on M1 Macs (with JIT) though of course performance will be affected somewhat by emulating both 68K and x86-64 on ARM64 hardware.

FS-UAE_3.1.43_macOS_x86-64.dmg
FS-UAE-Launcher_3.1.32_macOS_x86-64.dmg
FS-UAE_3.1.43_macOS_ARM64.dmg
FS-UAE-Launcher_3.1.32_macOS_ARM64.dmg

Go to https://fs-uae.net/download instead.

If you have an older macOS version which is not supported by FS-UAE Launcher, you can download a version for macOS10.9+ instead.

Plugins

You should get new and updated plugins for CAPSImg (

.ipf

file support) and QEMU-UAE (PPC support) if you use these. The plugins should be installed into

Documents/FS-UAE/System

. So, for example, the

CAPSImg

directory should be extracted as

Documents/FS-UAE/System/CAPSImg

.

CAPSImg_5.1.2_Windows_x86-64.tar.xz
QEMU-UAE_3.8.6_Windows_x86-64.tar.xz
CAPSImg_5.1.2_Linux_x86-64.tar.xz
QEMU-UAE_3.8.6_Linux_x86-64.tar.xz
CAPSImg_5.1.2_macOS_x86-64.tar.xz
QEMU-UAE_3.8.6_macOS_x86-64.tar.xz
CAPSImg_5.1.2_macOS_ARM64.tar.xz
QEMU-UAE_3.8.6_macOS_ARM64.tar.xz

Go to https://fs-uae.net/download instead.

Note for macOS users: When extracting, please use the built-in unarchiver in macOS. If you use a third-party app, the plugins might be extracted incorrectly (with wrong file permissions).

Portable version

If you want to convert

Documents/FS-UAE

to a portable directory which you can move wherever you want, just follow these simple steps:

Make sure

FS-UAE

&

FS-UAE-Launcher

is stored inside

Documents/FS-UAE

. I recommend storing them as

Documents/FS-UAE/System/FS-UAE-Launcher

and

Documents/FS-UAE/System/FS-UAE

.

Make sure a file called
```
Documents/FS-UAE/Portable.ini
```
exists (it can be empty). On Windows, it is important to make sure you create the file name correctly, and that it's not being called
```
Portable.ini.txt
```
(which can happen if try to create this via Notepad or similar).

You can now move Documents/FS-UAE to any location, and this should work for all operating systems

ChangeLog

Fix device helper for xinput devices with recent SDL2 versions.
Support for multiple mice disabled by default on macOS due to security warning. Use option multiple_mice = 1 to enable.
Disable expect_version option (no longer synchronized with launcher).
Added support for more physical keys (when using rawinput).
Compilation fixes for Apple M1 hardware.
Netplay desync fixes related to file system (directory hard drives).
Better virtual memory reservation algorithm.
Option to automatically pause on menu screen [mrsilver76].
Use RTLD_DEEPBIND with dlopen on Linux when loading plugins.
Changes to how plugins are looked up.
Ide patch.
SCP floppy image doesn't wrap to revolution #0 cleanly [keirf].
Fixed crash in nname_to_aname [PowderedToastMan].

02 November 2021, 15:04	#1
FrodeSolheim FS-UAE Developer Join Date: Dec 2011 Location: Førde, Norway Age: 43 Posts: 4,043	FS-UAE 3.1-stable While I'm primarily working on FS-UAE & Launcher 4, I've seen the need to do some updates to version 3 as well. Especially for macOS users where 3.0.5 is not working very well on the latest macOS releases. But it has useful fixes for other platforms as well, including a fix for using .lha archives on Windows and a compatibility fix for using QEMU-UAE on recent Linux distros. I haven't announced version 3.1 on fs-uae.net yet, among other things because I don't have installers prepared yet, and I also haven't had time to make sure that FS-UAE Arcade runs correctly. Apologies for not having a more smooth upgrade path, but I simply haven't had time. Please consider subscribing to this thread to get information about updates. - And please let me know if these instructions are unclear! EDIT: A new download page for FS-UAE 3.1 is now up at https://fs-uae.net/download. Please go there instead of using the links below, there are slighly newer versions on the official download page now. Windows You'll need to have an archiver with support for .tar.xz for now. I recommend https://www.7-zip.org/. Download the .tar.xz archives for your operating system and extract the contained FS-UAE and FS-UAE-Launcher folders to wherever you like. You must keep these folders stored alongside each other. The fs-uae-launcher.exe executable is found within FS-UAE-Launcher/Windows/x86-64 . You can make a shortcut to this of course to make starting it easier. FS-UAE_3.1.43_Windows_x86-64.tar.xz FS-UAE-Launcher_3.1.32_Windows_x86-64.tar.xz Go to https://fs-uae.net/download instead. Linux Download the .tar.xz archives for your operating system and extract the contained FS-UAE and FS-UAE-Launcher directories to wherever you like. You must keep these directories stored alongside each other. The fs-uae-launcher executable is found within FS-UAE-Launcher/Linux/x86-64 . You can make a shortcut to this of course to make starting it easier. FS-UAE_3.1.43_Linux_x86-64.tar.xz FS-UAE-Launcher_3.1.32_Linux_x86-64.tar.xz Go to https://fs-uae.net/download instead. macOS Download the .dmg images for both FS-UAE Launcher and FS-UAE, and copy the apps within to /Applications or wherever you like. You must keep the two apps stored alongside each other. Choose the correct versions for your machine. the ARM64 version is for Apple Silicon (M1 Macs), and x86-64 is for Intel hardware. If you are unsure, just go with x86-64 which should work on all recent macOS systems. The ARM64 version will run faster on M1 Macs, but does not support JIT compilation. You should be able to run the x86-64 on M1 Macs (with JIT) though of course performance will be affected somewhat by emulating both 68K and x86-64 on ARM64 hardware. FS-UAE_3.1.43_macOS_x86-64.dmg FS-UAE-Launcher_3.1.32_macOS_x86-64.dmg FS-UAE_3.1.43_macOS_ARM64.dmg FS-UAE-Launcher_3.1.32_macOS_ARM64.dmg Go to https://fs-uae.net/download instead. If you have an older macOS version which is not supported by FS-UAE Launcher, you can download a version for macOS10.9+ instead. Plugins You should get new and updated plugins for CAPSImg ( .ipf file support) and QEMU-UAE (PPC support) if you use these. The plugins should be installed into Documents/FS-UAE/System . So, for example, the CAPSImg directory should be extracted as Documents/FS-UAE/System/CAPSImg . CAPSImg_5.1.2_Windows_x86-64.tar.xz QEMU-UAE_3.8.6_Windows_x86-64.tar.xz CAPSImg_5.1.2_Linux_x86-64.tar.xz QEMU-UAE_3.8.6_Linux_x86-64.tar.xz CAPSImg_5.1.2_macOS_x86-64.tar.xz QEMU-UAE_3.8.6_macOS_x86-64.tar.xz CAPSImg_5.1.2_macOS_ARM64.tar.xz QEMU-UAE_3.8.6_macOS_ARM64.tar.xz Go to https://fs-uae.net/download instead. Note for macOS users: When extracting, please use the built-in unarchiver in macOS. If you use a third-party app, the plugins might be extracted incorrectly (with wrong file permissions). Portable version If you want to convert Documents/FS-UAE to a portable directory which you can move wherever you want, just follow these simple steps: Make sure FS-UAE & FS-UAE-Launcher is stored inside Documents/FS-UAE . I recommend storing them as Documents/FS-UAE/System/FS-UAE-Launcher and Documents/FS-UAE/System/FS-UAE . Make sure a file called Documents/FS-UAE/Portable.ini exists (it can be empty). On Windows, it is important to make sure you create the file name correctly, and that it's not being called Portable.ini.txt (which can happen if try to create this via Notepad or similar). You can now move Documents/FS-UAE to any location, and this should work for all operating systems ChangeLog Fix device helper for xinput devices with recent SDL2 versions. Support for multiple mice disabled by default on macOS due to security warning. Use option multiple_mice = 1 to enable. Disable expect_version option (no longer synchronized with launcher). Added support for more physical keys (when using rawinput). Compilation fixes for Apple M1 hardware. Netplay desync fixes related to file system (directory hard drives). Better virtual memory reservation algorithm. Option to automatically pause on menu screen [mrsilver76]. Use RTLD_DEEPBIND with dlopen on Linux when loading plugins. Changes to how plugins are looked up. Ide patch. SCP floppy image doesn't wrap to revolution #0 cleanly [keirf]. Fixed crash in nname_to_aname [PowderedToastMan]. Last edited by FrodeSolheim; 19 December 2021 at 17:18.