ARAnyM on Macs

MacAranym

MacAranym is the name of ARAnyM ported to Mac OS X based systems. You can find more information about ARAnyM on the official website.

On this page you can download a nonofficial release of MacAranym, which I'm building myself from the latest sources. The files you download here do not necessarily contain a full setup with configuration file and documentation. Please download the official release of MacAranym from the official website!

If not specified differently, the binaries are built with the following configure options:

MacAranym.app: --with-classicconfig --enable-ctrlkey=ctrl --enable-bpf-ethernet --enable-fpe=uae --disable-fullmmu
MacAranym MMU.app: --with-classicconfig --enable-ctrlkey=ctrl --enable-bpf-ethernet --enable-fpe=uae --enable-fullmmu --enable-lilo
MacAranym JIT.app: --with-classicconfig --enable-ctrlkey=ctrl --enable-bpf-ethernet --enable-fpe=ieee --enable-jit-compiler --enable-jit-fpu
MacAranym MMU+MPFR.app: --with-classicconfig --enable-ctrlkey=ctrl --enable-bpf-ethernet --enable-fpe=mpfr --enable-fullmmu --enable-lilo

Latest MacAranym testing binaries

Latest MacAranym binaries can be found in the following sections. They are generally based on the latest sourcecode available from the source repository, but can also include some experimental changes/improvements from my side.
Those binaries are for your convenience and to allow you test new features already before the next release is made public.

Please give feedback!

MacAranym 1.1.0+git-change-keymapping (17/07/2023)
MacAranym binary compiled and compatible with Intel 64-Bit and Apple M1 based Macs.
Automatically built using GitHub Action on macOS 12.6.7 and Xcode 14.2 using external dependencies from Dependencies-2023-07-02.zip.
This build is signed with my private Apple Developer certificate and notarized by Apple for worry-free installation on recent systems.
Please be aware MacAranym JIT is not working on Apple M1!

ARAnyM 1.1.0 2023/07/17 (git:74262fc) SDL (linked) : 2.28.1 OpenGL support : enabled Native features : audio bootstrap xhdi ethernet hostfs cdrom(no) osmesa jpeg vdi(opengl,sw) exec config clipboard

The code changes (compared to my current main branch) can be seen in this GitHub pull request.
The changes consist of additional scancode based mappings and support for keymap file.

A keymap file (as defined by the previously unused ARANYMKEYMAP constant in the source) contains mappings from SDL2 scancodes to Atari scancodes. It can be used to map missing keys like Help, Undo and Insert to keys which are available on your system (like F13, F14 or F15). The keymap file must be placed beside the config file in your Aranym_files directory.
```
# Each entry consists of two values separated by a comma
#      <SDL scancode>,<Atari scancode>
# Values can be decimal or hexadecimal (with '0x' prefix)
# Everything behind a hash # or a semi-colon ; is treated as a comment and ignored

0x46,0x52 ; Printscreen / F13 to Insert
0x47,0x62 ; Scroll lock / F14 to Help
0x48,0x61 ; Pause / F15       to Undo
107,0x62  ; F16               to Help
```
MacAranym 1.1.0+git (01/07/2023)
MacAranym binary compiled and compatible with Intel 64-Bit and Apple M1 based Macs.

Built on an Apple M1 based Mac with macOS 13.4.1 and Xcode 14.3.1 using SDL2 (2.26.2) and libjpeg from homebrew.
Changes to build & notarize this version can be found in my aranym fork on GitHub, ready to be tested by somebody else. Dependencies to build this can be downloaded here.
To allow seamless installation on any mac (?) I've used Apples notarization service.
Please be aware MacAranym JIT is not working on Apple M1!

ARAnyM 1.1.0 2023/07/01 (git:68d324a7) Native features : audio bootstrap xhdi ethernet hostfs cdrom(no) osmesa jpeg vdi(opengl,sw) exec config clipboard
MacAranym 1.1.0+git (03/10/2022)
MacAranym binary compiled and compatible with Intel 64-Bit and Apple M1 based Macs.

Built on an Apple M1 based Mac with macOS Monterey (12.6) and Xcode 14.0 using custom built SDL2 (2.0.20) and libjpeg from homebrew.
Changes to build & notarize this version can be found in my aranym fork on GitHub, ready to be tested by somebody else. Dependencies to build this can be downloaded here.
To allow seamless installation on any mac (?) I've used Apples notarization service.
Please be aware MacAranym JIT is not working on Apple M1!

ARAnyM 1.1.0 2022/10/03 (git:e3f82365) Native features : audio bootstrap xhdi ethernet hostfs cdrom(no) osmesa jpeg vdi(opengl,sw) exec config clipboard
MacAranym 1.1.0+git (11/01/2022)
MacAranym binary compiled and compatible with Intel 64-Bit and Apple M1 based Macs.

Built on an Apple M1 based Mac with macOS Monterey (12.1) and Xcode 13.2 using custom built SDL2 (2.0.20) and libjpeg from homebrew.
Changes to build for Apple M1 based Macs can be found in my GitHub aranym-fork, ready to be tested by somebody else. Dependencies to build this can be downloaded here.
MacAranym JIT will not run natively on Apple M1 and will use Rosetta 2.

ARAnyM 1.1.0 2022/01/11 (git:b84bac8b) Native features : audio bootstrap xhdi ethernet hostfs cdrom(no) osmesa jpeg vdi(opengl,sw) exec config clipboard
MacAranym 1.1.0+git (10/04/2021)
MacAranym binary compiled and compatible with Intel 64-Bit and Apple M1 based Macs.

Built on an M1 based Mac with macOS BigSur (11.2) and Xcode 12.4 using custom built SDL2 (2.0.14), SDL2_image (2.0.5.) and libjpeg from homebrew.
Dependencies to build this can be downloaded here.
MacAranym JIT will not run natively on Apple M1 and will use Rosetta 2.

ARAnyM 1.1.0 2021/04/07 (git:0f432755) Native features : audio bootstrap xhdi ethernet hostfs cdrom(no) osmesa jpeg vdi(opengl,sw) exec config clipboard
MacAranym 1.1.0+git (10/04/2021)
MacAranym binary compiled and compatible only with Intel (32-bit or 64-bit) based Macs.
Will not run on Mac OS X 10.5 and below.
Built on an Intel based Mac with macOS High Sierra (10.13) and Xcode 8.3 using SDL 1.2 and SDL 2.
MacAranym applications without SDL2 are note running on macOS 10.15 (Catalina) and above! Use those with SDL2 in the name.

ARAnyM 1.1.0 2021/04/07 (git:0f432755) Native features : audio bootstrap xhdi ethernet hostfs cdrom(no) osmesa jpeg vdi(opengl,sw) exec config clipboard
MacAranym 1.0.2+git (14/09/2015)
MacAranym binary compiled and compatible only with Intel based Macs.
Will not run on Mac OS X 10.5 and below.
Built on an Intel based Mac with Mac OS X Yosemite (10.10) and Xcode 6.4 using a custom patched SDL 2.1.15 and SDL_image 1.2.12.

Experimental additions to CVS:

14/09/2015:
Rebuild a fresh version. NFOSMESA and sound should work.

29/04/2013:
Special shortcuts for Atari keys (similar to MagiCMac): Apple + U = UNDO, Apple + H = HELP, Apple + D = DEL, Apple + I = INS

ARAnyM 1.0.2+git 2015/09/14 Native features: audio bootstrap xhdi ethernet hostfs cdrom(sdl) osmesa jpeg vdi(opengl,sw) clipboard
MacAranym MMU MPFR (19/04/2013)
MacAranym binary compiled and compatible only with Intel based Macs.
MPFR build: containing the new MPFR FPU emulation (which should be more accurate than the UAE and IEEE FPU emulation which is used in the standard build (above).

Built on an Intel based Mac with OS X 10.8 with a custom patched SDL 2.1.15 and SDL_image 1.2.12.
MacAranym 0.9.15+CVS Universal Binary Package (05/05/2013)
Compiled for and compatible with 32 bit Intel and PowerPC based Macs running on Mac OS X 10.5 and 10.6
Built on an PowerPC based Mac with Mac OS X Leopard (10.5) and Xcode 3.1.4 using a custom build Universal SDL 2.1.15 and SDL_image 1.2.12.

Experimental additions to CVS:

29/04/2013:
Special shortcuts for Atari keys (similar to MagiCMac): Apple + U = UNDO, Apple + H = HELP, Apple + D = DEL, Apple + I = INS

Known issue: Fullscreen broken for Mac OS 10.7. Please do not use this build on Mac OS 10.7 and above.

MacAranym BPF Ethernet example configuration

[ETH0]
Type = bridge
Tunnel = en1
HostIP = 192.168.0.1
AtariIP = 192.168.0.40
MAC = 00:41:45:54:48:30

Type: Use bridge to enable ethernet (any other value will disable Ethernet!).
Add debug to enable debugging. Use the Console application to see the messages sent/received by MacAranym.
Tunnel: Connected network device of your Mac: en0 for Ethernet/wired connection, en1 for Wireless/AirPort connection
HostIP: Router giving access to the internet. Check your network settings if you are unsure about it.
AtariIP: Any free IP address which will then be used by MacAranym for sending/receiving IP packets.
MAC: MAC address used for MacAranym.

If you encounter issues in WLAN environment, try using the MAC address of your Airport WLAN card (see System Preferences application) as the MAC address for Aranym. To ensure that the Atari side is not flooded with packets it did not request, make sure to set also the ip filtering mode.
I have seen cases where setting the same MAC address resolved the connection issue.

Atari/MiNT setup

Download the latest AFROS setup.
Edit config and adjust the ETH0 configuration part according to the example/description above.
Edit the file in drive_c/etc/resolv.conf. You should set a valid DNS server (which is required for resolving e.g. google.com to its IP address). If you are unsure, try setting the same address as HostIP.