ARAnyM is Atari ST/TT/Falcon+clones compatible and improved virtual machine (like a VirtualBox for a PC)
C C++ Perl Objective-C M4 Common Lisp Other
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.appveyor Some MinGW dlls could be missed when creating the archives, Feb 6, 2018
.travis Add SDL2 versions to the macOS project. Feb 23, 2018
android Add disassembler support for arm Sep 17, 2017
appimage Remove workaround for *.AppImage.zsync; has been fixed upstream Sep 9, 2017
atari Avoid some conflicts with windows headers Mar 18, 2018
contrib Move installation of *.desktop and icons to Makefile Sep 7, 2017
data Convert logo.png to bmp, and use builtin function from SDL Jun 25, 2017
doc Update links in documentation files to point to new wiki location Feb 8, 2018
m4 Simplify building on cygwin, by adding the necessary Jan 27, 2018
src Fix some corner-cases of flags handling in JIT compiled rotate instru… May 24, 2018
tools nfosmesa: update to OpenGL 4.6, adding 119 functions Feb 9, 2018
.appveyor.yml Add scripts for automated cygwin builds via AppVeyor Feb 4, 2018
.cvsignore .DS_Store added (created by Finder) May 17, 2012
.gitignore Small fixes for compilation on Haiku Feb 23, 2018
.travis.yml Automated builds are now also done for MacOSX Aug 27, 2017
AUTHORS Add HOSTEXEC native feature. Proposed by Miro Kropáček <miro.kropacek… Mar 17, 2018
BUGS - nfcdrom_win32.{cpp,h}: New, implementing NatFeat CDROM for win32 May 20, 2014
COPYING postal address corrected Sep 22, 2006
ChangeLog Fix some corner-cases of flags handling in JIT compiled rotate instru… May 24, 2018
FAQ parallel: do not flush output to file, plus fixes Jan 26, 2005
INSTALL Simplify building on cygwin, by adding the necessary Jan 27, 2018
Makefile.am Add a "Build status" indicator to the README Feb 3, 2018
NEWS Add HOSTEXEC native feature. Proposed by Miro Kropáček <miro.kropacek… Mar 17, 2018
README Update links in documentation files to point to new wiki location Feb 8, 2018
README-cygwin.in Update links in documentation files to point to new wiki location Feb 8, 2018
README.md Add a link to repology.org in README Feb 24, 2018
TODO Remove some obsolete items from the TODO list Sep 6, 2017
aranym.spec Update links in documentation files to point to new wiki location Feb 8, 2018
autogen.sh autogen.sh: automake must run after autoheader in freshly cloned Sep 19, 2015
config.guess Replace config.{sub,guess} by newer versions Feb 23, 2018
config.sub Replace config.{sub,guess} by newer versions Feb 23, 2018
configure.ac Remove long obsolete tests for 33bit adressing from configure Apr 16, 2018
install-sh Update autotools scripts to a more recent version that supports Haiku Nov 26, 2010

README.md

Build Status Build status

Latest snapshot: Download Latest release: Download

  ARAnyM (Atari Running on Any Machine)
  version 1.0.2 released on 2014/10/17

License

ARAnyM is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

ARAnyM is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with ARAnyM; if not, write to the Free Software
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA

What is this?

ARAnyM is a multiplatform virtual machine (a software layer, or an emulator) for running Atari ST/TT/Falcon operating systems and applications on almost any hardware with many host operating systems. The reason for writing ARAnyM is to provide Atari power users with faster and better machines. The ultimate goal is to create a new platform where TOS/GEM applications could continue to live forever.

Features:

  • 68040 CPU (including MMU040)
  • 68040 and 68881/2 FPU
  • 14 MB ST-RAM and up to 3824 MB (configurable) of FastRAM
  • VIDEL, Blitter, MFP, SCC, ACIA, IKBD for highest possible compatibility
  • Sound (compatible with Atari Falcon DMA Sound)
  • Atari floppy DD/HD for connecting floppy image or real floppy drive
  • two IDE channels for connecting disk images, harddrives or CD-ROMs
  • extended keyboard and mouse support (including mouse wheel)
  • direct access to host file system via BetaDOS and MiNT xfs drivers
  • networking using ethernet emulation with a driver for MiNT-Net
  • TOS 4.04, EmuTOS, MagiC or Linux-m68k as the boot operating system
  • runs with FreeMiNT, MagiC, and any other operating system that runs also on real Atari computer.
  • Native CD-ROM access (under Linux, other OS: audio CD only), without scsi/ide/whatsoever emulation
  • USB and PCI NatFeat support for developing Atari drivers on ARAnyM

Important: ARAnyM is not finished. Consider this to be a beta version and a work-in-progress. Sorry for incomplete and confusing documentation. Any help with programming/documentation/porting is very welcome!

Installing

See INSTALL file and https://github.com/aranym/aranym/wiki

You can also visit https://repology.org/metapackage/aranym/versions to check wether your distribution already has a pre-compiled version.

Configuring and running

See https://github.com/aranym/aranym/wiki

Keyboard shortcuts

Keys not found on a PC keyboard:

  • Atari Help key - mapped on the F11
  • Atari Undo key - mapped on the F12

Keys not found on Atari keyboard:

  • Page Up key - mapped as Shift+Arrow Up (usual combination in GEM apps)
  • Page Down key - mapped as Shift+Arrow Down (usual combo in GEM apps)

Special keys (most can be re-defined in the SETUP):

  • Pause/Break - invoke SETUP GUI (ARAnyM on-the-fly configuration)

  • Shift+Pause - QUIT ARAnyM

  • Ctrl+Pause - REBOOT ARAnyM

  • Alt+Pause - enter integrated debugger (only if started with "-D")

  • PrintScreen - create a screenshot in actual directory

  • Alt+Ctrl+Shift+Esc - release the keyboard/mouse input focus so you can use your keyboard and mouse in other host applications. Can be changed to other key combo in the Settings. Middle mouse does the same job.

  • Scroll Lock - switch between windowed and fullscreen mode

Troubleshooting

If your Microsoft IntelliMouse doesn't work correctly on Linux framebuffer console you may want to set the SDL_MOUSEDEV_IMPS2 environment variable to 1.

Example for bash: export SDL_MOUSEDEV_IMPS2=1; aranym

More information

Read the NEWS file for user visible changes.

Read ChangeLog for internal changes. Look at TODO if you want to help us.

Join our mailing list for ARAnyM users - the WEB interface for the list is at https://groups.google.com/forum/#!forum/aranym

Visit https://github.com/aranym/ for latest information and source code.

Help us improve the Wiki documentation at https://github.com/aranym/aranym/wiki

The "Power Without The Price" is back!