
Contents:
- Hatari and EmuTOS
- What is EmuTOS
- EmuTOS usage
- EmuTOS compatibility notes
- Debugging issues with EmuTOS
  - EmuTOS debug symbols
  - EmuTOS debug output
  - Other EmuTOS debug output options
  - Debugging OS calls, Line-A usage and panics
  - Debugging freezes
- EmuTOS free/shareware compatibility lists
  - Working Atari ST demos and games
    - Color ST demos and games
    - GEM / monochrome ST demos and games
  - Broken Atari ST demos and games
    - Broken (floppy) demo classics
    - ST games with broken input handling
  - Atari ST applications (including commercial)
  - Atari STE programs
    - Working STE programs
    - Non-working STE programs
  - Atari TT programs
  - Falcon programs
    - Falcon demos
    - Falcon games
    - Falcon applications


Hatari and EmuTOS
=================

To run the emulator, a TOS ROM image is needed.  EmuTOS, a free
implementation of TOS, is shipped with the official binary releases
of Hatari.

This tos.img ROM image is identical to the official binary package of
EmuTOS, which is available at the SourceForge website of EmuTOS.  For
downloading other versions or the source code of EmuTOS, please visit
the EmuTOS website.

The tos.img file included with the latest Hatari releases is
the etos1024k.img[1] from a preceding EmuTOS release:
- Hatari v2.5.0:
  https://sourceforge.net/projects/emutos/files/emutos/1.3/

The tos.img file included with earlier Hatari releases is
the etos512k.img[1] from a preceding EmuTOS release:
- Hatari v2.4.0, v2.4.1:
  https://sourceforge.net/projects/emutos/files/emutos/1.1.1/
- Hatari v2.3.0, v2.3.1:
  https://sourceforge.net/projects/emutos/files/emutos/1.0/
- Hatari v2.2.0, v2.2.1:
  https://sourceforge.net/projects/emutos/files/emutos/0.9.10/
- Hatari v2.1.0:
  https://sourceforge.net/projects/emutos/files/emutos/0.9.9.1/
- Hatari v2.0.0:
  http://sourceforge.net/projects/emutos/files/emutos/0.9.6/
- Hatari v1.9.0:
  http://sourceforge.net/projects/emutos/files/emutos/0.9.4/
- Hatari v1.8.0:
  http://sourceforge.net/projects/emutos/files/emutos/0.9.3/
- Hatari v1.7.0:
  http://sourceforge.net/projects/emutos/files/emutos/0.9.0/
- Hatari v1.6.2:
  http://sourceforge.net/projects/emutos/files/emutos/0.8.7/
- Hatari v1.6.0:
  http://sourceforge.net/projects/emutos/files/emutos/0.8.6/
- Hatari v1.4.0, v1.5.0:
  http://sourceforge.net/projects/emutos/files/emutos/0.8.5/
- Hatari v1.1.0, v1.2.0, v1.3.0, v1.3.1:
  http://sourceforge.net/projects/emutos/files/emutos/0.8.4/
- Hatari v1.0.0, v1.0.1:
  http://sourceforge.net/projects/emutos/files/emutos/0.8.3/
- Hatari v0.95:
  http://sourceforge.net/projects/emutos/files/emutos/0.8.2/

[1] This is the "all languages" version, intended mainly for TT & Falcon:

    While 192k and 256k EmuTOS variants work better for ST and STE
    programs in some cases, only the larger image variants contain
    support for all the hardware.  Older 512k EmuTOS variants support
    also all the EmuTOS languages, but nowadays only the new EmuTOS
    1024k variant does (has space for all of them).

Notes for older EmuTOS versions:

* EmuTOS <= v0.9.6:

  EmuTOS changed its INF file format in v0.9.7.  Hatari's Atari
  program autostarting and TOS resolution setting functionality
  supports only EmuTOS >= v0.9.7 INF file format

* EmuTOS <= v0.8.5 with Hatari <= v2.0:

  In order to work with Hatari, EmuTOS v0.8.5 and earlier require
  the FastBoot option to be enabled. This is used to skip some memory
  tests (that Hatari v2.0 and earlier do not support) when EmuTOS
  tries to determine the available RAM size.


What is EmuTOS
==============

EmuTOS is a single-user single-tasking operating system for the 32-bit
Atari computers and emulators.  It can be used as a replacement for
the TOS images needed for using the emulators, and its latest versions
support also wide variety of real hardware.  All the source code is
open and free, licensed under the GNU General Public License (GPL).
A copy of the GNU GPL can be found in the gpl.txt file.

EmuTOS project has home page at SourceForge:
	https://emutos.sourceforge.io/
With sources at GitHub:
	https://github.com/emutos/emutos


EmuTOS usage
============

There are various reasons for using EmuTOS instead of the original
TOS ROM images:

* Legal.  Users who don't have Atari HW or other legal means to obtain
  the original Atari TOS ROMs (for all of the Hatari supported Atari
  versions: ST/STE/TT/Falcon), but would like to try out Hatari and
  see what kind of software the Atari machines had.  EmuTOS gives
  them a legal way to test Hatari with free demos, games etc.

* Performance.  EmuTOS boots faster to desktop than Atari TOS versions.

* Convenience.  EmuTOS does not need a HD driver to access hard disk
  images, and same 1024k (or 512k) image supports all the hardware that
  different Atari TOS versions support.

* Continuity.  Users who want to continue using Atari compatible
  operating systems and need an open source replacement of TOS for
  modifications. Beside EmuTOS, they typically also use FreeMiNT,
  XaAES and fVDI as operating system replacements/improvements.

  This includes users of Atari FPGA clones, such as MiST & MiSTer:
	https://github.com/mist-devel/mist-board/wiki
	https://github.com/MiSTer-devel/Main_MiSTer/wiki
  users of new "Atari" machines, like Atari ColdFire Project:
	http://acp.atari.org/
  and even Amiga (WinUAE) emulator and real Amiga hardware.


EmuTOS compatibility notes
==========================

These comments apply to EmuTOS v1.x.

Many commercial games (e.g. Bombjack, Nebulus, Oids, Super Hang-On,
Turrican, Xenon...) and almost all ST/STe/TT applications work fine
with EmuTOS.

Because (even 192k variant of) EmuTOS uses a bit more memory than
normal TOS, badly written (typically floppy-only) games & demos may
blindly overwrite EmuTOS memory. They also often rely on (undocumented)
TOS internal variables & functions being at specific memory locations,
and will crash when they call these bogus addresses, use bogus values,
or call OS functions which internal state they had overwritten with
garbage. For example (older) Omikron Basic and many programs done with
it have this problem.

As a special case of this problem, input (e.g. joystick) does not work
in unpatched STOS Basic games as they access it through other means
than XBIOS function Kbdvbase() or by hooking into the IKBD interrupt
vector. They use unofficial system variables which location depends on
the TOS version.

However, ST/STE games that work from HD and/or have been fixed to work
with newer TOS versions, should usually be fine.

Support for Falcon 16-bit resolution is still missing from EmuTOS v1.3
AES/VDI, and Falcon DSP support was added only after EmuTOS v1.0
release.

Additionally, very old EmuTOS versions (up to v0.9.1) lacked support
for the (deprecated) line-A graphics functions which are used in many
free/shareware games (ones done with GFA basic etc).  This isn't an
issue with newer EmuTOS versions.

Lists of known issues and incompatible applications are listed in
incompatible.txt file coming with EmuTOS:
https://raw.githubusercontent.com/emutos/emutos/master/doc/incompatible.txt


Debugging issues with EmuTOS
============================

EmuTOS debug symbols
--------------------

After loading EmuTOS debug symbols from the file coming with the 1024k
(or 512k) EmuTOS image, using debugger "symbols etos1024k.sym" command,
you can ask debugger to "trace cpu_symbols", to get trace of all the
(non-static) function calls EmuTOS does.

For smaller EmuTOS variants, there's a script[1] you can use to convert
the emutos2.map file (produced during EmuTOS build) to a format you
can load to Hatari debugger with its "symbols" command[2].

[1] http://sourceforge.net/mailarchive/message.php?msg_id=29381777
[2] https://www.hatari-emu.org/doc/debugger.html#Debug_symbols

After loading the symbols to the Hatari debugger, disassembling the
problematic address should provide more clues for the problem.  Or you
can just look up the program counter value given in the EmuTOS panic
message from the map file.


EmuTOS debug output
-------------------

Start Hatari with "--natfeats on --trace os_base" options to get
EmuTOS debug output (with 512k or 1024k images), and to redirect
EmuTOS panic output and other console messages to Hatari's console.

For extra debug output and to add your own debug statements, you
need to uncomment following line from suitable EmuTOS source file(s):
	#define ENABLE_KDEBUG 1

And recompile EmuTOS image. Note that you can't do that for whole
EmuTOS as resulting image would be too large.


Other EmuTOS debug output options
---------------------------------

There are debug output options for different HW in EmuTOS "config.h"
header file, but they aren't necessary with NatFeats and console
output redirection.

If you want to test them anyway, below is listed each of them with
Hatari command line options to save their output (to "debug.txt"), and
shortcomings of each option are following:

* MIDI_DEBUG_PRINT: "--midi-in /dev/null --midi-out debug.txt"
  - Hatari needs to be compiled with PortMidi support disabled,
    as PortMidi interprets only real MIDI events

* RS232_DEBUG_PRINT: "--rs232-in /dev/null --rs232-out debug.txt"

* SCC_DEBUG_PRINT: "--scc-b-out debug.txt"
  - SCC port is available only on MegaSTE/TT/Falcon


Notes:

* Don't use Hatari stdout/stder ("/dev/stdout", "/dev/stderr") as
  debug output files, unless you absolutely need to get ordering right
  between the extra debug messages and other output, as that results
  in messed up console and output from Hatari

* Both input & output files need to be specified for RS232 & MIDI,
  otherwise Hatari does not enable them


Debugging OS calls, Line-A usage and panics
-------------------------------------------

Ask Hatari debugger to stop when the program is started:
-----------
> b pc=TEXT
CPU condition breakpoint 1 with 1 condition(s) added:
pc = TEXT
> c
Returning to emulation...
-----------
(In above example '>' indicates what you type to debugger.)

Then when the debugger is invoked at program startup, you can ask it to:
- collect CPU instruction history
- break on exceptions that trigger the panic
- load symbols + profile what happens, as these will
  provide EmuTOS callstack when debugger is entered
- trace all OS calls and line-A opcodes leading to the panic
with:
-----------
> history on
> setopt -D
> symbols etos1024k.sym
> profile on
> trace os_all
> b LineAOpcode ! LineAOpcode && lineAopcode ! 0xffff :trace
> c
Returning to emulation...
-----------

With above, when the exception causing the panic triggers the debugger,
you see EmuTOS callstack and the OS calls & line-A opcodes leading to it,
and have a panic message on console from which you can copy & paste
relevant parts.

You can then ask what the register values are at that point and what
are the CPU instructions leading to it with the "r" and "history"
commands. Memory state and addresses accessed by the instructions can
be inspected with the "m" command.

For more info on Hatari debugger usage, see the Hatari manual section
on it: https://www.hatari-emu.org/doc/debugger.html


Debugging freezes
-----------------

Hatari profiling support can be used to debug OS freezes.  If EmuTOS
gets stuck, just profile it for a while and then ask debugger for a
profile that tells where it's looping.  Then disassemble that part
with EmuTOS symbols directly in Hatari.


EmuTOS free/shareware compatibility lists
=========================================

The compatibility lists below cater mainly for users who don't have
Atari HW and therefore won't have (legal) version of commercial Atari
software and most likely lack motivation to investigate applications
very deeply (Linux offers better alternatives nowadays for most of
that). I.e. the lists skip (most) commercial software and concentrate
on EmuTOS compatibility of freely available games and demos (including
commercial games that have been released later on for free
distribution).

Games that are considered good quality & fun, are marked with "*".
All the listed demos are quite OK.

Most demos can be downloaded from:
	http://pouet.net/
	http://demozoo.org/

Many of the other programs can be found from Atari Mania:
	http://www.atarimania.com/atari-st-tt-falcon.html

And the remaining Atari FTP sites.

Below are first listed ST demos, games, graphics & MIDI applications,
then STE demos, games and music applications, then TT programs and
last Falcon demos, games and applications.


Working Atari ST demos and games
--------------------------------

For STs, 192k EmuTOS variant is best as it leaves most RAM free.

If ST has more memory, *and* OS speed is important (i.e. app uses OS
drawing functions), 512k (or 1024k) variant could be used instead, as
that is compiled with higher optimizations than 192k one.

Some old, floppy only games expect certain memory areas occupied by
EmuTOS, to be over-writable without issues.  These need 192k image.
Some of them can be gotten to work by using EmuTOS cartridge image
(it uses less memory than normal EmuTOS), like this:
	hatari --tos etos192uk.img --cartridge etoscart.img floppy.img

Mostly the non-working games "Panic" EmuTOS during their startup,
but it can happen also later on.


Color ST demos and games
........................

Color demos:
- 2011 (by Positivity & Sector One, 4kB intro)
- 3D screen 3.5k (by Overlanders)
- 44 (by Avena, 4KB intro)
- 4getful (by gwEm, 4KB intro)
- 4kker (by Checkpoint, 4KB intro)
- Across the Borders (by Effect)
- Algorift 256b (with MIDI output, by Marquee Design)
- Ambience (by Chaos)
- Anomaly (by MJJ Prod)
- April Fools (by DNT Crew)
- Arsenite (by Dekadence)
- Audiopacdemo (by X-Troll)
- Bad Remix (by Dekadence)
- Beast Scroll (by Joefish)
- Beefect (by Effect)
- Beyond Imagination (by NLC), in GFA basic
- Bread and Circuses (by Effect)
- Breath (by Mystic Bytes)
- Calimer-o-demo (by Oxygene)
- Charts Compilation (by Next)
- Closure (by Sync)
- Coast II Coast (by Sector One, 4kB intro)
- Coolism (music disk, by Effect)
- Crisis (by Joska)
- Cross the Deserts (by Chronicle) - one screen gfx is partly corrupted
- Crowd Teaser (by SMFX)
- Cuddly Demos (by CareBears)
- Darktrip (by Legend) - does not work properly with >2MB of RAM
- Dark Side of the Spoon (by ULM)
- Darwin's Dilemma (by Cerebral Vortex, DHS and SMFX)
- DataSTorm Invite (by Genesis Project)
- Death of the Clock Cycles (by Aggression)
- Delusion (by MJJ Prod)
- Dimensio (by Condemned)
- Done & Dusted (by Genesis Project)
- DragonST (256b intro by atariBDSM)
- Eat my bollocks (by Equinox)
- Execution (by SMFX)
- Fantasia (by Dune & Sector One)
- Flashback (by Carebears)
- Flexiscroll 2021 (64k by Effect)
- Flipo (by Oxygene)
- Frenchies (by Frenchies, 96KB intro)
- Fruit is Great! (256b 50Hz overscan by Effect)
- Glokzilla (by MJJ Prod)
- Going (by Spice Boys)
- Grafik -und Sounddemo (by Eckhard Kruse)
- Hallucinations (by Reservoir Gods)
- Helvetin Hyttysiä (by Spice Boys)
- Hiatus (by SMFX)
- Hatari 2.2 intro (by Mr.Styckx)
- If pigs could fly (by Syndicate)
- Illusion (by Dune)
- In Waves (by Exocet & Tomchi & Tom)
- Infinity/Madstars (by Holocaust)
- Just Jack (by Joker)
- Let Go (by Dekadence)
- Lichthaus (by Newline)
- Lostmax (by Psycho Hacking Force)
- Lots of Dots (by Acid Maker & Friends)
- Make More Short Demos (by Dekadence)
- MMoDA (Mini Museum of Digitized Arts) exhibitions (by Pepe)
- MonaST (by GGN/tln, 256B intro)
- Motus (by SMFX)
- Music Box 128k (by Michael Lunn, in STOS)
- My Galaxy (by Dune & Sector One & MJJ Prod)
- Music Disc 1 (by G. Gaubatz)
- New Year intro 1990 (by The Replicants)
- No Cooper (by 1984)
- No more froggies (by Sector1)
- O-demo (by Oxygene)
- Odd Stuff (by Dune & Sector One)
- Oh no!! more froggies (by Sector One) - does not work with >2MB of RAM
- Old (by Tom & Dubmood)
- Oldskool Rebirth (by MJJ Prod)
- Ooh Crikey (by Lost Boys)
- OVeRclocked Remix (by Overlanders)
- Outline 2008 invite (by DHS)
- Outline 2010 invite (by Checkpoint)
- OutRun Music demo (by FedePede)
- Overdose (by Aggression)
- Overdrive (by Phalanx)
- Pandemonium (by Chaos)
- Panic (Paolo Simoes)
- Paradise (by Dune Design)
- Pause (by Cerebral Vortex / Dekadence / SMFX)
- Phaleon Gigademo (by Next) - select "fast loader"
- Posh (by Checkpoint)
- POV disk 165 (except for EiL 99 invite)
- Prix (by Ephidrena)
- Punish your machine (by Delta Force)
- Recycles (by SMFX)
- Remote Entry #2 - 11110 Edition (by Spice Boys)
- Remote Entry #2 - Delta Quadrant Edition (by Spice Boys)
- Renegade Breakdown - Sommarhack 2021 invitro (by Spkr / SMFX)
- Replay (by SMFX, Sommarhack 2023 winner)
- RGB plasma (by Omega)
- Santa Claus Barbie Was Drunk As A Cochon (by MJJ Prod)
- Save The Earth (by Defence Force)
- Second Reality 2013 (by Checkpoint)
- Serial (by Dekadence)
- Shiraz 256b (with MIDI output, by Marquee Design)
- SillyVenture 2k10 & 2k11 (invitros by Mystic Bytes & Aggression)
- SillyVenture 2020 (invitro by Agenda, Hemoroids & Mystic Bytes)
- Smag-FX 3 (by SMFX)
- SNDH v4.8 update demo (PHF & KUA & DHS)
- Sommar TTRAK (TTRAK v1.00 intro)
- Sommarhack 1991 Best Of (by Pepe)
  - Glitches are intentional, not EmuTOS issue
- Sommarhack 2011 invite (by DHS)
- Sommarhack 2022 reminder (by DHS)
- Soundtracker (by Equinox)
- Sowatt sprite record (rec16e, by Oxygene)
- ST NICCC 2000 (by Oxygene)
- ST NICCC 2015 (by Checkpoint)
- ST soccer (intro by Exceptions)
- Starfield Humppa (by Dekadence)
- Stone tower (by FUN)
- Superstar! (intro by Positivity/Dma-Sc/Ukko)
- Suretrip 49% (by Checkpoint)
- Sweety (by DHS)
- Synergy megademo (by Synergy)
- Syntax Terror (by Delta Force)
- Temptation aka Project "A" (by NoExtra)
- The Puppet Show (by Fantasy & Dune)
- The Rise of Love (by Hemoroids)
- The Snowman 2009 (by Checkpoint)
- The Stupendous Demo (by Pixel Twins) - has couple of STE screen
- The Union demo (by The Union)
- The Truth (by Dekadence)
- The twist (by Team "The twist")
- The World According to Nordlicht
- The XMAS '88 Demo (by Kenrick Productions)
- TomTechTronic (by Effect)
- Transbeauce II (by BushWacKers)
- Tut! (by Wildfire)
- Twelve (by Paulo Simoes)
- TwiSTy (256b intro by Ultra / Cream)
- Two in One (by DHS)
- Unbelievable (by Masters Of Electric City)
- Unextreme (by Masters Of Electric City)
- Unreachable (by MoEC & Sector One)
- Unstatic (by Cyprian, Dma-Sc & bob_er)
- Virtual (by Equinox)
- Visualize (by Checkpoint)
- Vodka demo (by Equinox) - does not work with >1MB of RAM
- We Accidentally Your Oculus (by Sector One)
- We do not rip or recycle anything (by Spice Boys)
- Wedtro (by Avena & Effect & D-Bug)
- X-files (by Martin Cubitt, in STOS)
  - Error #046 => run from desktop instead of auto/-folder
- Xmas 2000 Intro (by Paranoid)
- YmRockerz musicdisks from "Wave upon Wave" to "Seven"

Color toys:
- Fplanet
- Schnapfl

Commercial game demos/previews (many of these are pretty good):
- Baby Jo demo          (floppy only)
- Babel demo
- Beast II demo
- Bloodwych demo        (floppy only)
- Bolo demo             (floppy only)
- Bug-Bash demo
- Cadaver demos 1 & 2
- Captive demo
- Cartoon Capers        (STOS)
- Celica GT4 Rally demo
- Challenge golf demo   (floppy only)
- Chips Challenge demo
- Civilization demo
- Cloud Kingdoms demo
- Conqueror demo
- Defender II demo
- Deflektor             (floppy only, Zero magazine disk)
- Creatures demo
- Fire & Ice demo
- Flimbo's Quest demo
- Flood demo
- Gods demo             (floppy only, ST format disk)
- Golden Ax demo
- GuyFawke demo         (use joy in port 0, floppy only)
- Helter Skelter demo
- Hudson Hawk demo
- Hunter demo
- Interphase demo       (floppy only)
- James Pond demo
- Jupiter's Masterdrive demo
- Killing Game Show demo
- Knightmare demo       (needs <4MB RAM)
- Leander demo
- LLamasoft games
  http://minotaurproject.co.uk/lc-16bit.php
- Lotus III demo        (floppy only, non-interactive)
- Mad Professor demo
- Magicboy demo         (floppy only)
- Manix preview
- Magic Pockets demo
- Megalomania demo
- Microprose Golf preview (floppy only)
- Mig29 Super Fulcrum demo
- Moonshine Racers demo
- Nitro demo
- Oids demo
- Parasol Stars demo
- Photon Storm demo
- Pipemania demo
- Populous II demo
- Pushover demo         (3 playable levels)
- Puzznic demo          (needs floppy in drive A:)
- Rampage demo
- Robin Hood demo
- Robokid demo
- Rolling Ronny demo
- Rotoplex demo
- Space Crusade demo
- Space Harrier         (line-A copy raster & line, in Atari PowerPack)
- Stormball demo
- Super Stario Land demo
- Thunderstrike demo
- Turrican II demo      (bus errors during game)
- Up an' Away / Flip & Magnose demo
- Venus Flytrap         (floppy only, Zero magazine disk)
- Videokid demo         (floppy only, non-interactive)

Free/shareware/PD games:
- 2048            (by Paradize)
- A Day at the Races
- Alterra
- Archon 3.5k     (by Deltaforce)
- Alien Blockade* (quixx)
- Atax
- Bellum*
- Blaster
- Blind labyrinth (line-A bitblits, mouse issues)
- Bodyshop        (line-A bitblits)
- Boinx 3.5k      (by Total Vision Inc)
- Bold            (floppy only)
- Bombs Away
- Bombzai
- Boom
- Bugs*          (line-A bitblits)
- Candyman       (line-A bitblits)
- ChuChu Rocket* (RG's STFM Lite version)
- Clogged Up
- Cops and Robbers Too! (line-A bitblits)
- Crapman*
- Cybernetix
- Dave Munsie games* (shareware released later as freeware)
  http://www.atarimania.com/list_games_atari-st-munsie-dave_team_950_S_G.html
- Donkey         (GWBasic GFA port)
- Donkey Island  (adventure)
- Dot 2 Dots     (for kids)
- Downfall       (2-player)
- Droid          (floppy only, bootsector has 0 for reserved sectors)
- Droid 2*       (floppy only)
- Entombed
  - Does not show title, copyright, hiscore nor help after EmuTOS v0.8.6
  - TOS v2 shows title but not others and sound is wrong
- Flip'em* 4KB   (puzzle)
- Fly Robin Fly
- Fokker         (2-player biplanes, use joystick 0)
- French adaptations of classic games:
  Boulderdash, Demineur, Jewel, Qbert, Sokoban
- Frogger*
- Fuzzball*
- GodPey         (floppy only, by Reservoir Gods)
- Golgafrincham  (mod compile with 2-player minigame)
- Grav*
- Grav2*
- Hackman II*
- Hang About 4KB (mountain climbing, use joystick 0)
- Hangmad        (hangman)
- Happy Worm
- Hardcore preview
- Haywire        (use joystick 0)
- Hector*
- Hero           (RPG)
- Hexmines*
- Iceblox Plus*  (works on all Atari machines)
- In nihilum reverteris (interactive color novel)
- Japlish        (line-A polygon lines)
- Jetpac
- Jitterbugs     (MIDI multiplayer, GFA, slow)
- Killing Spree  (2014 preview by TLB at Atarimania)
- Laserball 2014
- LeMans         (line-A get pixel, draw line, bitblit, show mouse)
- Manic Miner
- Master Breakout
- Maze*
- Mem*           (line-A bitblits)
- Merchant       (works also in mono)
- Midi Maze*     (MIDI multiplayer, works also in mono)
- Midi Maze II   (MIDI multiplayer)
- Midi Maze 3    (MIDI multiplayer)
- MidiWiz 1.1i   (MIDI / RS-232 multiplayer)
  - Requires EmuTOS >= v1.2 to work also on ST
- Missile Alert
- Monkeys and Balloons
- Monopoly
- Nibe 2
- Nova
- Out of this Word* (typing game)
- Panic
- Paradize games (line-A bitblits):
  http://paradize.final-memory.org/games.shtml
- Picross ST*    (floppy only)
- Punt II
- Rayoid*
- Recoil
- Revenge of the mutant camels (shareware)
- Robert in the Fire Factory
- Robotz
- Roc'hell*      (by Dune)
  https://github.com/dune-demogroup/roc-hell/
- Rockfall*
- Santafly
- Sideways
- Sinister development games (shareware)
- Snowball Fight (2-player)
- Spacebar
- Spacewar
- Starball*      (shareware)
- Super Pac-Man* (use joystick 0)
- Superfly       (floppy only)
- Sweeper
- Tanx*
- Terraboink
- Tiles Osmosis
- Time Bandit
- Teserae*
- The errand boy (text adventure)
- The lost world (line-A bitblits)
- Trace
- Unheart
- Video poker    (shareware)
- WalZ           (breakout)
- Warzone
- Whip Snapper's race
- Wolf3d*        (floppy version, Fread()s files opened as write-only)
- Yak 3.5k       (gridrunner by Jeff Minter)
- Xenon 3.5k     (by Michael Bittner)
- Zap
- Zatacka        (multiplayer)

Med-rez games:
- Hangman v2.0
- Poker solitaire


GEM / monochrome ST demos and games
...................................

Monochrome demos:
- Demounstures  (by TOS-Crew, works also in color)
- Halftron      (by Ephidrena)
- Hi Alf        (by Echo Cray)
- Monism        (by Sync, requires 1280x200)
- Monofillah    (by Tom)
- Monomental    (by Senior Dads, crashes at end)
- Monoscreen    (by Dead Braincells)
- Monotheist    (by SMFX)
- No rights     (by Dekadence)
- The Mono Tale (by The Cyclemasters)

GEM games:
- 2048          (by Rajah Lone)
- 4 Gewinnt*    (Connect four)
- Abalone
- AtariGo
- Awele         (use v1.02, it fixes bugs in v1.01)
- Ballerburg*
- Bombs         (minesweeper)
- Centi
- Checkers
- Chess*        (works only from floppy)
- Clicks*       (needs wdialog)
- Corewar
- Daleks*
- Dame
- DBWH
- Drachen
- Flipside      (fs, othello)
- Frix
- Gem_mind
- GEMcell
- Gemamigo*
- Gnuchess
- Gobang*
- Halma
- Invers
- Isola
- Kensington
- Magic Stones* (m_stones: tetris, 2x tetris, columns)
- Mars          (corewars)
- Mathmaze
- Megaroid*
- Minds*        (minesweeper)
- Mines*
- Mosaik
- Nanjing
- Nethack*
- Never Mind
- Orb
- Pacman
- Patience*     (card solitaire, use latest v2.25)
- Risky*        (Risk board game)
- Shanghai
- Ship Combat   (battleships, line-A calls)
- Sixteen       (puzzle)
- Sliders
- Snake
- Sokoban*      (http://peterlane.info/sokoban.html)
- Solitair*
- Spiegel       ("mirrormagic")
- Stello*
- ST Concentration*
- Sudoku*
- Tartan*       (chess)
- Thor          (Othello, unstable)
- Thrust
- Tricky yahoo
- Verrueck      (labyrinth)
- WindowBall    (breakout)
- Wormania
- Yams          (minesweeper)
- Yukon*        (card solitaire)
- zSudoku

Monochrome games:
- Backgammon    (line-A bitblits under GEM menu)
- Big Blow      (line-A bitblit)
- Balloons
- Bolo          (demo levels, floppy only)
- Bouncing boubles
- Columns*
- Criss Cross
- CW Puzzle     (line-A bitblit + line & point draw in start)
- Delta patrol
- Diamond miner
- Domino	(line-A bitblit)
- Emperor       (v1.0 & v1.5)
- Fun Face      (playable demo)
- Gluckrad      (line-A bitblit)
- Go UP
- HASCS
- Lasermon      (laser "chess", there's also color version)
- Lokomotive	(line-A bitblit)
- MacPan*	(line-A draw/clear sprite)
- MineFeld	(line-A draw/clear sprite)
- Minigolf*     (line-A draw/clear sprite)
- Monkey Business
- Mr Dash
- Pacballs      (line-A bitblit)
- Pipeline*	(line-A line and filled rectangle, works also in color)
- Pling II	(line-A bitblit, draw/clear sprite and filled rectangle)
- Poolmono*
- Punssi
- Puzzlepuzzle
- Qix
- Roll X	(line-A bitblit and set/get pixel)
- Super breakout* (by Mark Overmars)
- Sherlock*     (texts overlap slightly)
- Skull diggery
- Slither       (line-A draw/clear sprite, works also in color)
- Space war     (bug: score missing)
- Take2*        (line-A bitblit)
- Wallball
- Whack a Virus (Sommarhack 2020)

Text games:
- Advent        (Colossal Cave)
- Eliza
- Hack
- Larn
- Omega
- Quix

Mono/GEM toys:
- Biglife*
- Fishes        (line-A line and filled rectangle, works also in color)
- Mandala
- Planet        (celectial body calculations)
- Pyro
- Robugs*       (GEM UI, line-A fillrect + sprite draw)
- ST life
- ST tour       (from Atari corp, works also in color)
- Wator         (slow)
- Worm farm


Broken Atari ST demos and games
-------------------------------

Below are listed demos and games known not to work with EmuTOS. EmuTOS
documents issues with a subset of them in more detail in:
https://raw.githubusercontent.com/emutos/emutos/master/doc/incompatible.txt


Broken (floppy) demo classics
.............................

- Amiga demo (by Exceptions)
  - bus errors before *any* OS calls
- B.I.G demo (by Exceptions)
  - bus errors before *any* OS calls
- Froggies over the Fence (by Legacy, ST Connexion, Overlanders)
  - Line-F panic, earlier bus error at $400000 after first OS call:
    Rwabs(0,0x30000,8,1,0)
  - with high-RAM etos512k, complains about 1/2 MB RAM
- Place to be (by EKO)
  - with 192k, black screen / panic at start
  - with cart, bus errors after intro screens
- Things not to do (by Inner Circle)
  - NULL pointer access at 0x7d80a
  - Floprd(0x7d800, 252, 2, 0, 0, 9)
- SoWatt (by CareBears)
  - constant bus errors at same PC address
  - Worked before EmuTOS v0.9.10 commit 5981ef6, which puts EmuTOS
    default disk buffer at a low memory location ($1004)
  - Floprd(0x70000, 0, 1, 81, 1, 6)
- Swedish New Year (by CareBears)
  - panic at 0x7006 after first OS call
  - Floprd(0x7000, 0, 1, 79, 0, 9)
- WhattaHeck (by CareBears)
  - panic at 0x7000 after first OS call
  - Floprd(0x7000, 0, 2, 0, 0, 1)


ST games with broken input handling
...................................

As expected, STOS games which use STOS routines for input do not work
as STOS does that in TOS binary version specific manner (see EmuTOS
incompatible.txt).

Floppy-only (color) STOS games:
- Diamond Ice       (joystick input doesn't work)
- Islandstrike      (mouse input doesn't work)
- Ozone             (fire at start doesn't work)
- Vidigrid v2       (mouse input doesn't work)

Note that their AUTO-folder starter programs need to be moved to
floppy root and started from there, see EmuTOS incompatible.txt.

GEMDOS HD supporting (color) STOS games:
- Balls Up          (mouse input doesn't work)
- Color Clash*      (fire at start doesn't work)
- Dice II           (mouse doesn't work)
- Heartland         (fire at start doesn't work)
- Mr Dice*          (gets spurious joy input)
- Nostram           (input doesn't work)
- Orbit             (mouse input doesn't work)
- Phantom           (joystick input doesn't work)
- Pipetris          (spurious joystick left input)
- Prehistorik3 demo (spurious joystick left input)
- Reflection*       (keys work, mouse doesn't)
- Roadkill 2        (joystick input doesn't work)
- Skatetribe        (fire at start doesn't work)
- Smash hit         (input doesn't work)
- Sudoku Universe*  (mouse input doesn't work)
- The Rollercoaster Experience (fire at start doesn't work)
- Trackball         (mouse doesn't work)

Even some commercial games use TOS version specific input handling
(see EmuTOS incompatible.txt):
- Brain Blasters / The Teller demo  (input doesn't work)
- Super Cauldron demo  (fire doesn't start game)
- Striker soccer demo  (fire doesn't start game)

Free/shareware color games (more input issues):
- Douglas Rockmoor  (see EmuTOS incompatible.txt)
- Space invaders    (see EmuTOS incompatible.txt)

Mono games (more input issues):
- Crystal Cave*     (line-A bitblit & draw/clear sprite, see EmuTOS incompatible.txt)
- Macro War         (line-A bitblit, see EmuTOS incompatible.txt)
- Ramses*           (panic, see EmuTOS incompatible.txt)

GEM games (more input issues):
- Anduril           (see EmuTOS incompatible.txt)
- Invaders*         (see EmuTOS incompatible.txt)


Atari ST applications (including commercial)
--------------------------------------------

Working debuggers (support also e.g. TT):
- Adebug reloaded (68000-68030 debugger)
- Peacebug v1.19 (supports remote control over MIDI)
- Peacebug v1.30
- Templmon 2.01

Working drawing / image viewing programs:
- Degas Elite, see http://www.youtube.com/watch?v=G4st-x4-BJg (at 16:30)
- Iffcnv, IFF converter/viewer
- ImCon v1.1, image converter/viewer
- Neochrome master (line-A bitblit, text, line)
- Photochrome v4 (all buttons don't work)
- Speed of Light v3.8
- Spslide, Spec512 viewer

Not working:
- Spectrum512 (see EmuTOS incompatible.txt)

Not working video / HD access programs:
- STVidPlay (see EmuTOS incompatible.txt)

Working MIDI programs:
- A.C.T (EmuTOS >= 1.2 for screen update fixes)
- AlterTune
- Dave's Fabulous MIDI Music Box
- Dr T's KCS v4 (EmuTOS >= 1.2 for menu / WF_FIRSTXYWH fix)
- Dr T's Tiger Cub 2.0
- EditTrack
- EZ-Score Plus
- FinalCut Pro demo (needs <4MB RAM)
- Fractal Music
- Fractal Music Composer 2
- FretCalc
- G.I.S.T (sound synthesis with MIDI input)
- Henry Cosh's Accompanist
- Largo (MIDI playlist manager)
- Ludwig
- M
- Mandala
- MIDI Master Drummer 2.5
- MIDI Square
- Miditree (floppy/color only, press "P" to play Xmas carrols)
- MiniMoo
- MusicEditDemo 8.001 (tries to use GDOS + HighWire)
- Music Mouse (uses line-A hline for cursor)
- Notator 3.0
- Pro Midi Player 8.0
- Realtime 1.25
- Sequencer One
- SMF-PLAYer 1.1
- Sweet 16

(Almost all work in monochrome, about half also on TT / mono.)

Not working:
- Cubase 2.x / lite (see EmuTOS incompatible.txt)
- ST versions of Hypnosis / Quaderno (see EmuTOS incompatible.txt)

MIDI programs are available from Tim's MIDI world:
	http://tamw.atari-users.net/

Most of the non-GEM ST tracker & chip music composer programs work
also with EmuTOS, most even with the 512k/1024k EmuTOS variants.
See STE notes for more info on them.


Atari STE programs
------------------

There are not that many STE specific (or even STE enhanced) programs
(see the "STE software compatibility list" section in compatibility.html),
so this tries to cover status for all the games, and many of the demos.

Note: STE emulation needs 256k variant of EmuTOS.  With US i.e. 60Hz
image (etos256us.img), you may get screen flicker and music playback
issues with demos and games.  Full STE support requires EmuTOS
v0.9.4+.


Working STE programs
....................

Following STE specific & enhanced demos, games and apps work fine with
EmuTOS.

Color demos:
- 1st Step (by Tobe/MJJ Prod)
- 20 years megademo (by Atari scene collective)
- 20 years Atari STE megademo (by Paradox)
  - "NoExtra" screen exits immediately
- 21 bobs (by Anima, needs 50Hz)
- 32768 colors showdown (by Tronic of Effect)
- 3D full (by Oxygene)
- 96 Shades of Gray (by Paradox, >1MB, panics at end/exit)
- Again (by Paradox)
- AltParty 2008 intro (by Paradox)
- Ambermoon Music demo (by Psycho Hacking Force)
- Amiga Demo 2 (by Oxygene), music disk
- Antiques (by Dune & Sector One)
- An Cool on STE
- Another kid story (MJJ prod 2009)
- Appendix (by DHS)
- Armada is dead (by Aggression)
- ATM 10 Years (by Checkpoint)
- Azed/Jungle demo (by Atari)
- BallsHmd (D-Bug intro + fixed Hemoroids "Square V2" demo)
- Beat Demo (by Frontline)
- Bird Mad Girl Show (by Fraggle's)
- Birdie (by Zeal)
- Blitzwav v1 (by Cybernetics)
- Blue Period (by Paradox)
- BoingSTE
- CD-player (by Light)
- Cernit Trandafir (by DHS)
- Chipo Django 1 (by Rabenauge)
- Circus BackSTage (by BlaBLa)
- City Frames (by DHS)
- Core Flakes (by New Core)
- Devotion (by Excellence in Art)
- Dynamite (by Unit 17)
- E605 (by Light)
- Ecstasy part A (by Inner Circuit Explorers)
- Ecstasy part B (by Inner Circuit Explorers)
- Fluffy Clouds (by Genesis Project)
- French Kiss (by DHS)
- Gobi Toons (by Dune)
- Grimey (by Reservoir Gods)
- Hatari 1.9 intro (by Mr. Styckx)
- Hatari 2.1 intro (by Mr. Styckx)
- Hatari 2.3 intro (by Evil/DHS, spkr/SMFX and Mr.Styckx)
- Heal Old Geek (by Hemoroids, only endpart.prg needs STE)
- High Fidelity Dreams (by Aura)
- HighResMode 1 & 2 (by Paradox)
- I got invited to Psycho Hack (by Modula)
- Illusion (by Next)
- It's A Girl (by Paradox)
- It's A Girl 2 (by Paradox)
- Jam-Cols (by ICE)
- Just Musix 2 (by DHS)
- Just another Blitter demo (by Anima)
- Kick my ass'embler (cpp_edit by Paradize & Cerebral Vortex)
- Lavalamp (by Tobe)
- Little Blitter Benchmark Demo (by Frank B)
- LovelYM (by KÜA & SMFX)
- Lovetro (by Paradize & Sector One)
- Madness (by Cream)
- Massacre (by DHS)
- Mathematica (by Aura)
- Maxymizer compo 2006 (by gwEm)
- Meshake (by Spice Boys)
- Mind Rewind (by Reservoir Gods)
- Monogatari (monochrome, by Cerebral Vortex)
- More or Less Zero (by DHS)
- MovieSTE (by Tony Barker)
- MPC in Dalarna (by DHS + SMFX)
- Muda (by Live!)
- Necrosys (by Hemoroids)
- New Year -94 Intro (by Extream)
- No Monkey (by Tomchi)
- No Signal (ADPCM musicdisk by DHS)
- Pacemaker (by Paradox), end part works only from floppy image
- Paracon 6 & 7 remindtros (by Paradox)
- Parallax Distorter 2 (by Solomon)
- Power Rise (by Light)
- Realtime (by MJJ Prod)
- Reanimation (by Syntax)
- Revise and Revisit (by DHS)
- Rise of the blackstorm (by Mystic Bytes)
- Riverside (by DHS)
- RGBeast (by Aggression)
- RGB Splitter (by Paradox)
- SaboTagE (by Paradox)
- Satan stole my Atari (by Lamers)
- Save the Earth (by Defence Force)
- Scene? Ay Mamba! (by Spice Boys)
- Sinfull Sinuses (by Chronicle)
- Sierpinski overdose 4K (by GGN), med-rez+blitter only
- Sommarhack 2010 invite (by DHS)
- Songs Of The Unexpected (by OUCH)
- Speechless (by The Estate)
- Steroid (Metroid remake demo)
- STE slideshow (by DHS)
- STE Wars (by Tony Barker)
- STePS (by XiA/CPT)
- STrange RoboTS (by Blabla)
- STresSTeST by (Cream)
- Summer Delights (by DHS)
- Sventure intro (by Paradox)
- Takeover (by Lamers)
- TalkTalk2 (by XiA)
- Techno drugs (by NLC)
- The Art of Profanity (by SMFX & DHS)
- The Star Wars Demo (by The Arctic Land)
- Tribute to Rainbow TOS (by 505 & Tobe)
- Tyranny (by DHS)
- UFO (by Dune & Sector1)
- Unbeatable (by Masters of Electric City)
- Vision (by POV)
- Vulgar Display of Power (by Extream)
- We Accidentally Released (by SMFX & KÜA)
- We Were @ STNICCC 2015 (by Oxygene)
  - Reset screen scroll text colors are wrong
- Wonderful World (by Paradox)
- XiTEC Presentation (by Omega)
- Xmas 2004 (by Paradox)
- Yanartas (by Checkpoint)
  - ST demo that works only on STE

Monochrome demos:
- Bad Apple!! (by Fenerinarsa)
- MonogAtari  (by Cerebral Vortex)
- Time Slices (by Defence Force)
- Unbeatable  (by MEC)

Color games:
- 4K Pacman
- Adam is Me
- Aerial Combat 3
- Alien Blast (demo)
- Alien Thing preview
- Atari Scene Card Battle (line-A bitblit)
- Astrodia
- Battletris+
- BeGEMeD* (line-A bitblits)
- Blat (line-A bitblit)
- Bombaman
- Boom (screen flashes during scrolling messages)
- Breakdance (scene game, STOS)
- Catch Me If You Can*
- ChuChu Rocket* (RG's full version)
- Crash Time Plumber
- Dread* (playable Wolf3D clone demo v1905)
- Droid STE rewrite
- Dynabusters+*
- Exchange Puzzle (SV20 edition, optional STe palette support)
- Frantick
- Frogs (optional STE audio/blitter support, MIDI multiplayer)
- Giana Sisters STE rewrite:
  http://atari-forum.com/viewtopic.php?f=3&t=26360
- H Mec 2 (line-A bitblit)
- Metal Slug STE (mission 1)
- Micromachines preview (by .tscc)
- Mr Boomer (line-A bitblit)
- No Limit II (shareware pinball)
- Obsession* (demo of commercial pinball)
- Operation Garfield
- Pacman on E
- Pacmania* STE/overscan rewrite:
  http://atari-forum.com/viewtopic.php?f=3&t=24635
- Pole Position (arcade conversion)
  http://atari-forum.com/viewtopic.php?f=3&t=26068
- Power Up
- R0x (line-A bitblit)
- R0x Zero (line-A bitblit, overscan screen needs 50Hz version of Emutos)
- Randomazer 1.x & SV2020 editions
- Roger (line-A bitblit)
- R-Type Deluxe (arcade conversion)
  http://atari-forum.com/viewtopic.php?f=28&t=29047
- Sardonic
  http://atari-forum.com/viewtopic.php?f=3&t=38121
- ScummST (STE enhanced)
  http://www.happydaze.se/scummvm-lite-atari/
- Skulls (shareware "minesweeper")
- Sporny's Wrecking Ball
- Spy 4k
- Stardust* (tunnel sequence demo)
- STEtris (STOS)
- STrEet Fighter II (incomplete)
- Stupid balloon game (joysticks swapped?)
- Substation* (demo)
- Supa Zazai Da
- The chronicles of Omega
- Tomtar
- Trapped II (DMA audio, line-A functions 1, 2, 3, 5, 7, 9)
- Treasure in Cave (by Freedom)
- Ultimate Arena v1.3 light (slow with EmuTOS)
- Utopos* (demo)
- Wolfenstein3D v0.8a* (a bit unstable)
- Zaptastic
- Zero-5 (demo)
- Zool (demo)

Additionally, also all nice STe enhanced Paradize games work
(AttackWave, Kolmik, MangaPuzzle, NWDump, Pairs, Penta,
PokerSquare, Pooz, Znax, SpaceBattle), and they all use
line-A bitblits:
	http://paradize.final-memory.org/games.shtml


STE drawing programs:
- Art for Kids / demo

STE (enhanced) video players:
- MP_STE

STE (enhanced) music applications:
- Blipp Blopper
- E.P.S.S (both v0.54b demo & v1.0.1 full version)
- DeskTracker MT
- Hextracker
- MaxYMizer
- MusicPlayer
- Octalyzer
- Paula
- Protracker 2 STE
- Sirius Player


Non-working STE programs
........................

Some non-working demos:
- Original Beat Maker (OG.PRG, SV2019, by CrazyQ)
  - STE recognization fails with TOS 2.x / EmuTOS -> bus error
- VGA slideshow (by Light)

Non-working games and music programs:
- Newer Audio Sculpture versions (v1.5beta doesn't handle
  disk access properly, v1.4 has broken crack, v1.1 works)
- Cameleon (see EmuTOS incompatible.txt)
- Hero (STOS, see EmuTOS incompatible.txt)
- Protracker v2 STE, Equinox version (see EmuTOS incompatible.txt)
  - http://www.pouet.net/prod.php?which=13381


Atari TT programs
-----------------

TT emulation requires 512k (or 1024k) variant of EmuTOS (the one
shipped with Hatari).  TT-low (256-color) mode and sound support
requires EmuTOS v0.9.6+.

(If program supports features common to both TT and Falcon, but
has no specific Falcon support, it's listed for TT.)

Working applications:
- Calamus SL demo (1991 demo version)
- Calamus SL/L/LE 20xx lite versions
  - Need either GDOS or older EmuTOS v0.9.5 - v0.9.12
- Mandelbrot playtime (fracplay, uses FPU)
- M_PLAYER v4.02
  - https://gtello.pagesperso-orange.fr/mplayere.htm
- PixArt4
  - http://www.1632systems.co.uk/www/html/Product/pixart.htm
- Vision v4.9 (works also in ST, but is much nicer in TT low/med)
  - http://jlusetti.free.fr/visione.htm
- ZXR v0.1m (ZX Spectrum emulator for 020+ machines)
  - https://www.atari-forum.com/viewtopic.php?t=34048

Working demos:
- 256mbrot, Bragg, Glasstro, Orion-B, Yabt (TT/Falcon intros by ray//.tSCc)
- 4getful (by gwEm, 4KB intro TT-version)
- Adebug 3DTT demo (by Brainstorm)
- Cube 256 (030 ST-low 256b intro by Thadoss / Dune)
- CrY image viewer (by .tSCc)
- Elegant Machinery (by Evolution)
- Led Blur (by Miro)
  - Much faster on Falcon/16-bit
- Mandelbrot explorer (by .tSCc)
- Monscape (by Escape)
- TC fish (by .tSCc)
- TT highres slideshow (by .tSCc)
- Shiny Bubbles TT (by Xanth FX)
- Spear of Destiny (port by Gildor)
- XiTEC demos (by Omega)
  - On exiting Swing, EmuTOS panics with privilege violation
    (TOS bombs and continues)
- Yeti3D (port by Gildor)

Working games:
- Capy (by YesCREW)
- DGEM v0.16 (Dungeon Master GEM version)
  - Start from TT-med (or use 640x400@16 VDI mode on ST/e)
- GEM Breakout
- GEM Klikomania
- GEM Landmine
- GEM Magnetic v0.8 (Magnetic Scrolls game runner)
  - Crashes on resolutions smaller than game window. Setup game colors
    to black and white, disable graphics and use TT mono monitor
    (or use 672x672@1 VDI mode on ST/e)
- GEM Manga Puzzle (needs 256 color mode)
- GEM Milanopoly
- GEM NetHack v3.4.3
- GEM Santarun
- GEM Slashem v3.3.1
- OpenDUNE
- OpenTTD (start from TT-low with 256MBs of TT-RAM)
- Oxyd (Falcon version)
- PM Doom, Heretic & Hexen v0.55 (ports by Patrice Mandin)
- ScummVM 2.8 (lite build by Miro)
 - Official upstream version (35 engines, 280+ game variants recognized)
- The Ultimate Minesweeper (GEM)

Most of above GEM games run even on ST, but only TT (and Falcon) have
large enough resolution with enough colors for them to be properly
playable.


Falcon programs
---------------

Falcon emulation requires 512k (or 1024k) variant of EmuTOS (the one
shipped with Hatari).  Programs using DSP require EmuTOS v1.1.1+,
programs using TrueColor (TC) mode, require EmuTOS v1.3+.

Following Falcon only demos, games and apps work (mostly) fine though.


Falcon demos
............

Working demos (comments are for EmuTOS v1.0 or older):
- 1600x600 (by Archangel)
- 256Water (256b intro by Extream)
- 30l coke, needs DSP
- 4getful (4k intro by gwEm, Falcon version)
  - Has way too low volume
- 4orce (4k intro by DHS)
- A Rh Positive 4k (by tSCc), needs DSP
- Ascii (by Reservoir Gods), disable DSP
- Ath/0 (by Dekadence)
- ATS (by DHS)
- Autowachen Verboten (by Lazer)
- Binliner (preview by Avena)
- Birdshow
- Blue 4k (by New Beat)
  - Ikbdws() stack usage was issue in v0.8.7-v0.9.3
- Bugs from outer space (by Impulse)
  - Bad sound
- Cebit 93 (by Respectables)
- Chipo Django 1 (by Rabenauge)
- Chrome Dragon (by Opium)
- Cooler than ever (by ICE)
  - Bad sound
- DBA Magazine 14 intro (by Lazer)
- Earth (by Gaston)
- Falcon Flight (by Opium)
- Firestarter (by Shadows)
- Flu 4k (by New Beat), needs FPU
- Fungle beats (by FUN)
- Game of Life 4k (by Aggression)
- Geotech (by Cybernetics)
- Gourand triangles demos (by ray//.tSCc)
  - These have asm sources!
- Gurkensalat (by Lazer)
- Illusion 64 (by Paranoia)
  - Plasma screen has garbage on right side,
    end screen at top & bottom
- ImPerfect (by XI / Satantronic)
- The Keff Demo (by An Cool)
- More (by New Beat)
- Mouse (animation + music)
- Oergs (by Lazer, pic + music)
- Old Stuff (by Extream)
- Payback 2015 (by Dekadence)
  - 060+FPU demo
- Prepare (by Extream)
- RGB Reine (by New Beat)
- Rock Solid (by Paranoia)
- Schlumpf invtro (by Lazer)
  - Horizontal scrolling is bad with some EmuTOS versions
- Six Sievert (by tSCc)
- Snowstorm (by Reservoir Gods), disable DSP
- Sonolumineszenz (by Avena)
  - works before v0.9.1, but without sounds
- STrEet figher II (by Patrice Mandin)
- Terrorize Your Soul (by tSCc)
  - Fonts and colors are not right on all screens
- Tiny Things (no music as it's on DSP)
- Videl visions slideshow
- Virtual City, needs DSP
  - Freezes at exit
- Warum (by Lazer)
- Weltchmerz (by Avena)
- Why (by Extream)
- ZygyFem6 (by Extream)
- ZZ 9 Plural Z Alpha (by tSCc)

Demos working under EmuTOS >= v1.1 (with DSP support):
- 4kbtro (by Wilfire)
- 96ktro (by Cruor)
- Aggressive Party 2 4k (NoCrew)
- Agony (by DNT crew)
- At Night They Come (by Bohemian Grove)
- Beams (by .tscc)
- Bird to be alive (by Dune etc)
- Bound 3, Bound 5 (by Crac)
- Bound 42 (by MMJ Prod)
- Built-in Obsolescence (by Digital Chaos)
- Chaos A.D. (by DNT crew)
- Chiaroscuro (060, by Evolution)
- Circuitry of Desire (060, by DHS)
- Codein (060, by DHS)
- Cycedelic knockout (by Mugwumps)
- Dan's Lustiges Kinderfest (by Lazer)
- Derealization (060, by DHS)
- Doomino (by STAX)
  - Startup text broken, need TC terminal output
- Enraged (by Avena)
- Ex Illusion (by Aura)
- F22.0 (060, by Lamers)
- FOG-intro (by Psychosis)
- Hex Pistols (060, by Fit)
- Hmmm... (by Escape)
- I want you to remember (by KÜA Software & Pixel Twins)
  - Monochrome, with DSP music
- Illness (by Escape)
- It's that time of the year again (by New Beat)
  - Works also with v1.0, but MP2 DSP music requires >v1.0
- JESTERday (by POV), musicdemo
- Joy (by New Beat)
  - Works also with v1.0, but MP2 DSP music requires >v1.0
- Lamer than Lamers (060, by Lamers)
- Laser Days E.P. (by .tSCc)
  - Works also with v1.0, but MP2 DSP music requires >v1.0
- Lockup (by Mystic Bytes)
- Motion (unfinished demo by Aggression)
- No Signal (MP2 musicdisk by DHS)
- Papa was a Blade Runner (by EKO)
- Revertant 1.2 (by Cobra / Mystic Bytes)
  - Works also with v1.0, but MP2 DSP music requires >v1.0
- ROT3DBMP
- Shades of Circuits (v1.1 musicdisk by Dry Bone Records)
  - Works also with v1.0, but startup texts look bad
- She danced to Tainted Love (musicdisk by tSCc)
  - Works also with v1.0, but MP2 DSP music requires >v1.0
- Sidetracked (by Collapze)
- Silly Venture 2k14 invitro (by Dune / Sector One)
- Silly Venture 2k16 invitro (by Dune / Mystic Bytes)
- Silly Venture 2k19 invitro (by Mystic Bytes)
- Stercus Accidit (060, by Fit)
- Stocasto (by NoCrew)
  - Works also with v1.0, but then DSP 3D objects are missing
- Tere Ra'I (by Cerebral Vortex / Dune / Sector One)
- The mountains flight (by Cruor)
- The Ultimate Seduction (Sommarhack 2020 invite)
- Too Silly 2 (by Lamers)
  - Works also with v1.0, but MP2 DSP music requires >v1.0
- Tron2001 (by ICE)
- Unexpected Fun (by Orion_)
- Voxel (by DrTypo)
- We Reached Stars (by Orion_)
  - 060+FPU demo
- Whirlpool 128k (by Extream)
- Why (by Extream)
- X-tasie (by Trio, requires MMU)
- Xmas 1997 (by DHS)
- Yepyha (by Toons)
- Zero Three Zero (by The Pixel Twins)

Demos working under EmuTOS >= v1.2:
- LCF (by Lamers)
  - 060+FPU+VGA demo

Demos working under EmuTOS >= v1.3 (XBios TC support):
- Multitech (by Cybernetics)
  - Part of Geotech demo, needs DSP + TC mode

Demos working under EmuTOS Git version (TC terminal output):
- Bound & Bound2 (Crac)
- Doomino (STAX)

Demos working partly under EmuTOS >= v1.3:
- 124 beers later (by Trio)
  - Works also with 1.0, but fighter screen DSP textures need v1.1
  - Ground texture missing in last screen
- Bound 4 (by Crac)
  - Startup text renders correctly only if started from TC mode

Broken demos (with EmuTOS v1.3):
- GEM demo (by DHS & AssemSoft):
  - Needs to be started from HiColor mode
- mengerMarcherFC (256b intro by atariBDSM)
  - Needs to be started from 320x200 HiColor mode
- Spin176 (256b intro by MKM / Lamers)
  - Needs FPU & started from 320x200 HiColor mode
- Who Okayed This?
  - Both the new and (fixed) old intros (epidemic.prg) do work,
    (fixed) music disk (zikdisk.prg) panics to bus error at -1

Hatari issues (happen also under TOS4):
- '_' (by Escape)
  - Crashes after first few screens
- Symposium'96 (by Hydroxid)
  - Cannot run to end
- X-perience (by Abstract)
  - NULL pointer bus error after while / demo freezes


Falcon games
............

Games working under EmuTOS >= v1.0:
- Aces High (preview)
- Addsub
- BeGEMeD* (Falcon version)
- Block Blizzard preview (line-A bitblit + hide cursor / show mouse)
- Blum
- Cavemania (demo version)
- Chorensha (old, non-DSP version)
- Columns by Deadheart* (Atarimania / 1st demo version)
- Corsair
- DB 4K
- Dry Egg (needs >4MB RAM)
- FalcTron
- Galaga 88
- Ganymed (start with F1)
- Grenzüberschreitung
- Heretic (very slow)
- Hexogan (use number pad)
- Impulse* (Breakout clone)
- Jeu de Poker (VGA only)
  - Needs 640x480@256 mode
- King Solitaire
- Kniff (VGA only, Omikron Basic v3.60)
  - needs 640x480@256 mode
- Lamemine
- L'Abbaye Des Morts
- Let's play Shanghai
  - Needs 640x400@256 mode
- LlamaZap (free version)
  - Requires joypad, not joystick
- Madtris
- Masters of Chaos (multiplayer "dungeon master")
- Nibe
- Offworld Security
- Pac Them*
- Pacmania X68000
- Pingo 98 (classic version)
- Running* (demo version)
- Radical* Race (demo)
- Raiden
- Risk 030 demo (VGA only)
  - Needs 640x480@16 mode
- Spice* (Defender clone)
- Spout
- Steinbruch
- Sweety Things
- Switch
- Tank Blaster
- Tautology (by Reservoir Gods)
- Tautology II* (by Reservoir Gods)
- Toy Man
- Ultimate Arena Falcon edition (demo):
  - Does not recognize it's on Falcon -> select "Test"
- Vertical Mayhem(+)* (Columns clone)
- Vroom 030 (too fast)
- Willie's Adventure (preview1)
 - Disable DSP
- Willie's Adventure* (preview2)
- X-moon preview* (music with DSP)
- Zodiax (Falcon "R-type")
  - Start from 640x400@16

Games working under EmuTOS >= v1.1.1 (DSP support + fixes):
- Aazohm Krypth
- Bad Mood (90's demo)
- Bad Mood* (v0.37 game from 2017)
- Beats of Rage* (by Thadoss/Dune)
- Boom preview
- Chainz (VGA only):
  - For v1.0, press space at start to disable DSP music
- Chorensha (DSP version)
- Conquest of Elysium II (preview)
- Crown of Creation (preview)
- Des Lazers & des Hommes
- Double Bobble 2000* (by Reservoir Gods)
  - For v1.0, disable DSP from Hatari
- Epi-Lepsie (by PARX)
- Gold island (demo, VGA only, Omikron Basic v3.5x)
- H2O* (by EKO)
- Jewelz (VGA only)
  - For v1.0, select hatari mode (F2) to disable DSP music
- Kwiks* (by Digital Nightmares)
- Les Dinosaures (v1.02 demo by PARX)
- Men at War
- Multibriques (by PARX)
- Ninja Torappu (by Cerebral Vortex)
  - Some sounds missing with EmuTOS v1.0
- NoMess (GEM, requires color icon support)
- OpenJazz (060 Atari port)
- OpenTyrian (060 Atari port)
- Pong 2000 demo (use joypad)
- Push It
- Racer (by Thadoss/Dune)
- Racer 2* (by Thadoss/Dune)
- Running* (shareware version)
- Slippery Sam
- Static (Patience by Reservoir Gods)
  - For v1.0, disable DSP from Hatari
- TsccTron
- TeknoBalls (Arkanoid clone)
- The 8 runes of Aerillion (demo version)
- Towers II
- Trionoids* (Columns clone)
- Worms* (Team17 game 060 Atari port)
- Wotanoid (Asteroids clone)

Games working under EmuTOS >= v1.2:
- Tetrhex (1.41)

Games working under EmuTOS >= 1.3 (XBios TC support):
- Confusion demo 1 & 2
- Gravon (demo + full version)
- Moonspeeder (preview 2)
- Rave*
- Conquest of Elysium II v2.0 & 2.3 (uses VDI calls)
- Tron 2 (VGA only)

Games working with extra hacks:
- Bugger, Bunion, SkyFall, Sworm games by Resorvoir Gods:
  - use an undocumented TOS4 vector for keyboard input instead of accessing
    kbdvec correctly which use causes EmuTOS to panic.  This can be worked
    around with the following hack.prg:
    http://sourceforge.net/mailarchive/message.php?msg_id=26841274
  - with EmuTOS <=1.0, enabling DSP freezes the games right at startup
    (with normal TOS4, DSP is used for background music)

Partly working games:
- Bomb Squad
  - Game is 4x slower than with TOS4 (see EmuTOS incompatible.txt)
- Color Runner
  - Game cannot be started from main menu (same as with TOS v4)
- Painium
  - Fire button works only until game itself starts
  - Works only with 8MB RAM

Broken games (with EmuTOS v1.3):
- Boulder Smash Falcon (Omikron Basic)
  - Needs to be started from large TC mode
- Columns by Deadheart* (demo, 2nd version)
  - Broken graphics, does not use Vsetmode() for OS version <= $0402
- Downfall
  - Dialog complains "Error while loading BLACKWHT.BGR".
    It is already open, so issue may be Setscreen() following it
- It's Great (start from st-med rez)
  - Mouse doesn't work
- "K" preview* (by EXA)
  - When actual game would start, bus error panic with 4MB, freeze with 14MB
- Moongame
  - Bus error panic at start after pressing Joypad button 3
- Mouse trap
  - TC mode game main menu freezes, uses VDI calls
- Neurobot
  - Both intro & game just exit immediately
- Pous-Pous
  - GEM, needs to be started from TC mode
- Q-Blue (VGA only, Omikron Basic)
   Needs to be started from 320x240 TC mode
- Reeking Rubber
  - Broken graphics & freeze on game start, uses VDI draw calls
- SBM v0.8 & v1.03* (Bomberman clone)
  - Bus error panic on reading $400000
- Sokoban By FUN (VGA only)
  - Screen updates work only partially
  - Uses VDI draw functions + line-A area blit (7)
- Watership (VGA only)
  - Bus error reading $fffffffe on startup -> panic

Seem to work except for Hatari issues (happen also with TOS4):
- Killing Impact
  - Gfx broken, Hatari Videl emulation is incomplete
- Ufo War
  - Gfx broken, Hatari Videl emulation is incomplete


Falcon applications
...................

Applications working under EmuTOS >= v1.0:
- Aniplayer v2.22
  - Can decode data faster with DSP
- BIQ codec / player (by .tscc, has sources)
- Cecile hard disk (image) driver
- Godpaint (by Reservoir Gods)
- ICDraw, .ICO and .IB3 GEM viewer
- Kronos v1.91 benchmark
- Rainbow 2 multimedia, needs MMU
- Smurf (GEM image viewer)
- Videlity v1.00r (resolution enhancer)

Applications working under EmuTOS >= v1.1 (with DSP support):
- AceMidi demo (v1.01)
- AceTracker v1 & v2
- AFM (audio fun machine)
  - UI needs color mode
- Atari800 v4.2 emulator
- Centurbo benchmark
  - DSP speed 2x, and bogus speeds for FPU & CPU as with normal TOS
- Delmpaint (GFA)
   - Due to program bugs, start from 320x200@256 resolution
- DSPDebug (by Brainstorm)
- DSPdit (by .tscc)
- Falcon Sound CPX
- FlaySID
- Flextracker (use VGA)
- Fractals v2.2b (030 + DSP)
- GemGT2 v1.1, GemMOD v0.85, and GemPLAY v1.95
  - http://yescrew.atari.org/eng/products.htm
- Graoumf Tracker (v0.8890)
  - Start from 16-color >=640x200 resolution
- MegaPlayer v1.15 (MegaTracker Player v1.1)
- Iphigenie v1.4b (sound system monitor and manager / DSP LOD loader)
- Voxx (vocoder), demo and free version
  - GUI looks OK, does not yet fully work with Hatari to test rest
  - Needs at minimum 640x480x16 color VGA resolution
- Whip! (virtual light machine)
- WinRec (direct to disk GEM audio recorder/effects)
  - Oscilloscope & spectralizer show only in VGA resolution,
    although they work fine also in RBG with TOS v4

Applications working under EmuTOS >= v1.2:
- Escape paint (GEM, requires color icons support)
  - EmuTOS v1.2 provides correct window management
- FalcAMP (GEM, requires DSP & color icons support)
  - 3D look in icons & text in some dialogs
- MP2AUDIO player
  - 3D look in icons
  - Needs to be started from 640x400 or larger resolution, otherwise it
    positions itself completely outside the screen (also with TOS v4)
- Quaderno
  - Falcon version, expects 640x400@256
  - EmuTOS v1.2 provides TOS v4 compatibility for doing wind_set()
    for a window that's created, but not yet opened
- Videl Inside (v1.2)
  - EmuTOS v1.2 provides Srealloc() support needed to avoid desktop
    crash with modes larger than earlier static screen alloc
- M_PLAYER v4.x
  - Sound did not work with EmuTOS v1.1
  - https://gtello.pagesperso-orange.fr/mplayere.htm

Applications working under EmuTOS >= v1.3 (XBios TC support):
- Apex Alpha (demo)
  - Requires MMU + FPU, works both under VGA & RGB
- Apex Animator 2.41
  - Both the app itself and separate viewers
- Apex Media v2.41
  - Both the app itself and all viewer TTPs work
- ScummVm for Falcon + clones
  - Older TC-only versions from OL & Miro
- ScummVM 2.8 (full build by Miro)
  - Official upstream version (54 engines, 370+ game variants recognized)
- Centview (GEM image viewer)
  - After showing an image, GUI is not always refreshed

Applications working with extra hacks:
- Fractal Playground, Godleness, GodBoyX by Reservoir Gods
  - Like RG games, these require "hack.prg", otherwise
    pressing any key crashes them

Partly working applications:
- Animator v0.20.4
  - Works as well as with TOS v4 (refuses to run with many videos
    or crashes on exit leaving desktop with broken graphics)
- AVI030
  - Works as well as with TOS v4 (= has issues)

Broken applications (with EmuTOS v1.3):
- Indypaint
  - Cursor moves, but co-ordinate display and menus from F1-F5 keys
    look broken
  - Needs HiColor + line-A (init, hide/show mouse)


	- Eero
