
Contents:
- Hatari and EmuTOS
- What is EmuTOS
- EmuTOS usage
- EmuTOS compatibility notes
- Debugging issues with EmuTOS
  - EmuTOS debug output and debug symbols
  - Debugging OS calls, Line-A usage and panics
  - Debugging freezes
- EmuTOS free/shareware compatibility lists
  - Working Atari ST demos and games
  - Non-working Atari ST games
  - Atari ST applications (including commercial)
  - Working Atari STE programs
  - Non-working Atari 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 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 etos512k.img[1] from a preceding EmuTOS release:
- 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/

Earlier Hatari binary releases have included one of the smaller
EmuTOS image files.

[1] the "all languages" version intended mainly for TT & Falcon.
    While the 192k and 256k version on some cases work better
    for ST and STE programs, only the 512k image contains
    support for all the hardware and languages.

Note for Hatari <= v2.0 with EmuTOS <= v0.8.5:
  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:
	http://emutos.sourceforge.net/
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.

* Convenience.  EmuTOS boots faster, doesn't need HD driver to access
  hard disk images (with DOS MBR), and same image supports wider
  variety of hardware than real Atari TOS versions.

* 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:
	http://code.google.com/p/mist-board/
  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 v0.9.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 version of) EmuTOS uses a bit more memory than
normal TOS, badly written (typically floppy-only) games may blindly
overwrite EmuTOS memory. They also often rely on (undocumented) TOS
internal variables & functions being at specific memory location. They
will crash when they they call these bogus addresses, use bogus
values, or call OS functions which internal state they had overwritten
with garbage.  Whereas ST/STE games that work from HD and/or with
newer TOS versions, should be fine.

Input (e.g. joystick) doesn't work in original (STOS) games that
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.  Try fixed
version of STOS games.

Support for some TT HW features and for DSP XBios functions &
Falcon 16-bit resolution are also missing.

Additionally, older 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 new EmuTOS versions.

Lists of known issues and incompatible applications are listed in
bugs.txt & incompatible.txt files coming with EmuTOS.


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

EmuTOS debug output and debug symbols
-------------------------------------

To get extra debug output from EmuTOS, or to add your own debug
statements, you need to recompile it from the source, after enabling
the MIDI debug output in its config.h header file. Then start Hatari
with the "--midi-out /dev/stderr" option and you will see EmuTOS debug
output on Hatari's standard error (such as calls to missing Falcon
XBios functions).

Some debug output can be gotten also from the pre-built 512k
EmuTOS images by using Hatari "--natfeats on" option.

By loading the etos512k.sym EmuTOS debug symbols file coming with the
512k EmuTOS image, you can also ask debugger to "trace cpu_symbols",
to get trace of all the function calls EmuTOS does.

For smaller EmuTOS versions, 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] http://hg.tuxfamily.org/mercurialroot/hatari/hatari/raw-file/tip/doc/manual.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.


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

When debugging EmuTOS panics, the best option is to start Hatari with
"--natfeats on --trace os_base" (to get extra debug output and redirect
EmuTOS panic etc messages to console) and then 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
Exception debugging enabled.
> symbols etos512k.sym
> profile on
> trace os_all
> b LineAOpcode ! LineAOpcode :trace
CPU condition breakpoint 2 with 1 condition(s) added:
LineAOpcode ! LineAOpcode
-> Track value changes, show value(s) when matched.
-> Trace instead of breaking, but show still hits.
> 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:
http://hg.tuxfamily.org/mercurialroot/hatari/hatari/raw-file/tip/doc/manual.html#The_debugger


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/

First are 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
--------------------------------

Floppy-only games and programs using Line-A need EmuTOS v0.9.5 or
newer.  For STs with less RAM, 192kB 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 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.  Some of them may (by
blind luck) work with 512k EmuTOS instead of 192k EmuTOS, or 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

(Above is issue mainly in EmuTOS v0.9.5 and older. In v0.9.6, EmuTOS
internals were re-ordered so that more important areas for such
programs are less likely to be overwritten.)

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


Demos:
- 2011 (by Positivity & Sector One, 4kB intro)
- 4getful (by gwEm, 4KB intro)
- 4kker (by Checkpoint, 4KB intro)
- Ambience (by Chaos)
- Anomaly (by MMJ Prod)
- April Fools (by DNT Crew)
- Arsenite (by Dekadence)
- Audiopacdemo (by X-Troll)
- Beast Scroll (by Joefish)
- Beyond Imagination (by NLC), in GFA basic
- Breath (by Mystic Bytes)
- Calimer-o-demo (by Oxygene)
- Charts Compilation (by Next)
- 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
- Cuddly Demos (by CareBears)
- Darktrip (by Legend), doesn't work with >2MB of RAM
- Dark Side of the Spoon (by ULM)
- DataSTorm Invite (by Genesis Project)
- Death of the Clock Cycles (by Aggression)
- Dimensio (by Condemned)
- Eat my bollocks (by Equinox)
- Fantasia (by Dune & Sector One)
- Flashback (by Carebears)
- Flipo (by Oxygene)
- Frenchies (by Frenchies, 96KB intro)
- Grafik -und Sounddemo (by Eckhard Kruse), font issues
- Hallucinations (by Reservoir Gods)
- If pigs could fly (by Syndicate)
- Illusion (by Dune)
- Lots of Dots (by Acid Maker & Friends)
- Music Disc 1 (by G. Gaubatz)
- No Cooper (by 1984)
- No more froggies (by Sector1), needs EmuTOS 2016-04-17
- O-demo (by Oxygene)
- Odd Stuff (by Dune & Sector One)
- Oh no!! more froggies (by Sector One, needs <4MB RAM)
- Ooh Crikey (by Lost Boys)
- 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)
- Phaleon Gigademo (by Next), select "fast loader"
- Posh (by Checkpoint)
- POV disk 165 (except for EiL 99 invite)
- Punish your machine (by Delta Force)
- Rebirth (by MMJ Prod)
- Remote Entry #2 - 11110 Edition (by Spice Boys)
- RGB plasma (by Omega, panic at return to desktop)
- Santa Claus Barbie Was Drunk As A Cochon (by MJJ Prod)
- Save The Earth (by Defence Force)
- Second Reality 2013 (by Checkpoint, crash at end)
- SillyVenture 2k10 & 2k11 (invitros by Mystic Bytes & Aggression)
- Sommarhack 2011 (invite by DHS)
- Soundtracker (by Equinox)
- SoWatt (by CareBears)
- Sowatt sprite record (rec16e, by Oxygene)
- ST NICCC 2000 (by Oxygene)
- ST NICCC 2015 (by Checkpoint)
- ST soccer (intro by Exceptions)
- Stone tower (by FUN)
- Superstar! (intro by Positivity/Dma-Sc/Ukko)
- Suretrip (by Checkpoint, works until overscan screen)
- Sweety (by DHS)
- Synergy megademo (by Synergy)
- Syntax Terror (by Delta Force)
- Temptation aka Project "A" (by NoExtra)
- The Stupendous Demo (by Pixel Twins, has couple of STE screen)
- The Union demo
- The World According to Nordlicht (needs EmuTOS 2016-04-17)
- Transbeauce II (by BushWacKers)
- Tut! (by Wildfire)
- Twelve (by Paulo Simoes)
- Two in One (by DHS)
- Virtual (by Equinox)
- Visualize (by Checkpoint)
- Vodka demo (by Equinox)
- We do not rip or recycle anything (by Spice Boys)
- Yanartas (by Checkpoint)
- YmRockerz musicdisks from "Wave upon Wave" to "Seven"
- Xmas2000 (by Paranoid)

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
- Celica GT4 Rally demo (needs EmuTOS >v0.9.3)
- Challenge golf demo (floppy only)
- Chips Challenge demo
- Civilization demo
- Cloud Kingdoms demo
- Conqueror demo
- Defender II demo (needs EmuTOS >v0.9.3)
- Creatures demo
- Fire & Ice demo
- Flimbo's Quest demo
- Flood demo
- Golden Ax demo
- 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
- Mad Professor demo
- Magicboy demo (floppy only)
- Manix preview (needs EmuTOS >v0.9.3)
- Magic Pockets demo
- Megalomania demo
- 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, needs EmuTOS >v0.9.3)
- 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
- Videokid demo (floppy only)

Free/shareware/PD games:
- 2048 (by Paradize)
- Alterra
- Archon 4KB
- Alien Blockade* (quixx)
- Atax (minor gfx issues)
- Bellum*
- Blaster
- Blind labyrinth (line-A bitblits, mouse issues, needs EmuTOS >v0.9.3)
- Bodyshop (line-A bitblits)
- Bold (floppy only)
- Bombs Away
- Bombzai
- Boom
- Bugs* (line-A bitblits)
- Candyman (line-A bitblits)
- Catch Me If You Can* (+ STE support)
- ChuChu Rocket* (Lite version for STFM)
- 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 Island (adventure)
- Dot 2 Dots (for kids)
- Droid (floppy only, bootsector has 0 for reserved sectors)
- Droid 2 (floppy only)*
- Entombed (doesn't show title, copyright, hiscore nor help after v0.8.6)
  - TOS v2 shows title but not others and sound is wrong
- Flip'em* (4KB puzzle)
- French adaptations of classic games:
  Boulderdash, Demineur, Jewel, Qbert, Sokoban
- 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)
- Happy Worm
- Hardcore preview
- Haywire (use joystick 0)
- Hector*
- Hero (RPG)
- Hexmines*
- Jetpac
- Killing Spree (2014 preview by TLB at Atarimania)
- Laserball 2014
- LeMans (line-A get pixel, draw line, bitblit, show mouse)
- Master Breakout
- Maze*
- Mem* (line-A bitblits)
- 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
- Rockfall*
- Santafly
- Sideways
- Sinister development games (shareware)
- Snowball Fight
- Spacewar
- Starball* (shareware)
- Super Pac-Man* (use joystick 0)
- Superfly (floppy only)
- Sweeper
- Tanx*
- Terraboink
- Tiles Osmosis
- Time Bandit
- Teserae*
- 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 (4KB gridrunner)
- Xenon (4KB shooter)
- Zap

Med-rez games:
- Poker solitaire

GEM games:
- 2048 (by Rajah Lone)
- 4 Gewinnt* (Connect four)
- Awele (use v1.02, it fixes bugs in v1.01)
- Centi
- 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*
- Mines*
- Mosaik
- Nanjing
- Nethack*
- Never Mind
- Orb
- Pacman
- 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
- zSudoku

GEM games needing EmuTOS >v0.9.5 (for mouse clicks to work):
- Abalone
- Ballerburg*
- Bombs     (minesweeper, needs EmuTOS >v0.9.8)
- Minds*    (minesweeper)
- Patience* (card solitaire, use latest v2.25)
- Risky*    (Risk board game)
- Checkers  (needs EmuTOS >v0.9.8)
- Yams      (minesweeper)
- Yukon*    (card solitaire)

Monochrome games:
- Backgammon    (line-A bitblits under GEM menu)
- Big Blow      (line-A bitblit)
- Balloons
- Bolo          (demo levels, floppy only)
- Bouncing boubles
- Columns*      (text input positioning issue)
- 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, needs EmuTOS >=v0.9.6)
- Monkey Business
- Mr Dash
- Pacballs      (line-A bitblit, needs EmuTOS >v0.9.5)
- 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

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
- Wator (slow)
- Worm farm


Non-working color/mono/GEM Atari ST games
-----------------------------------------

These are all games that work with normal TOS from Hatari GEMDOS HD
emulated drive, i.e. aren't hardcoded to run from a floppy.  Floppy
only games aren't listed as main reason why some of them don't work
is them overwriting TOS (or their own) memory.

Non-working color STOS games (as expected):
- Balls Up          (mouse input doesn't work)
- Color Clash*      (fire doesn't work)
- Dice II           (mouse doesn't work)
- Mr Dice*          (gets spurious joy input)
- Nostram           (input doesn't work)
- Orbit             (mouse input doesn't work)
- Pipetris          (gets spurious joy input)
- Prehistorik3 demo (input doesn't work)
- Reflection*       (key input doesn't work)
- Skatetribe        (input doesn't work)
- Smash hit         (input doesn't work)
- Sudoku Universe*  (mouse input doesn't work)
- Trackball         (mouse doesn't work)

Commercial color game demos:
- Brain Blaster / The Teller demo (input doesn't work)
- Cauldron demo     (input doesn't work, fire doesn't start game)
- Gods demo
  - works properly only from floppy
  - requires "high-RAM" EmuTOS build, otherwise overwrites itself:
    make 512 UNIQUE=uk DEF="-DSTATIC_ALT_RAM_ADDRESS=0x00080000 -DCONF_WITH_FRB=0"
- Striker demo      (input doesn't work)

Free/shareware color games:
- Douglas Rockmoor  (joystick input doesn't work)
- Downfall          (fire doesn't work)
- Fokker            (input doesn't work)
- Japlish           (line-A polygon lines, joystick input doesn't work)
- Space invaders    (up works as fire, no other input works)

Mono games:
- Crystal Caves*    (line-A bitblit and draw/clear sprite, input doesn't work)
- Macrowar          (line-A bitblit, joystick doesn't work)
- Midimaze*         (joystick doesn't work)
- Ramses*           (panic, see EmuTOS incompatible.txt)

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


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

Working drawing / image viewing programs:
- Degas Elite, see http://www.youtube.com/watch?v=G4st-x4-BJg (at 16:30)
- Iffcnv, IFF convertor/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 (address error on XBios Kbdvbase() return value handling)

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

Working MIDI programs:
- Dr T's KCS v4
- Dr T's Tiger Cub v2.0
- EditTrack
- EZ-Score
- FinalCut Pro demo (needs <4MB RAM)
- Henry Cosh's Accompanist
- Ludwig
- Miditree (floppy only, press "P" to play Xmas carrols)
- Music Mouse (uses line-A hline for cursor)
- Sequencer One

Not working:
- Cubase lite (see EmuTOS incompatible.txt)

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


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

There are not that many STE specific (or even STE enhanced) programs:
    http://atari-ste.anvil-soft.com/html/archivapps.htm

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

Note: STE emulation needs 256kB variant of EmuTOS.  If you use 60Hz
EmuTOS version (etos256us.img), you may get screen flicker and music
playback issues with demos and games.  You should use EmuTOS version
0.9.4 or newer.

Demos:
- 1st Step (by Tobe/MJJ Prod)
- 21 bobs (by Anima) - needs 50Hz
- 32768 colors showdown (by Tronic of Effect)
- 3D full (by Oxygene)
- Again (by Paradox)
- AltParty 2008 intro (by Paradox)
- Amiga Demo 2 (by Oxygene), music disk
- Antiques (by Dune & Sector Oen)
- An Cool on STE
- Another kid story (MMJ prod 2009)
- Appendix (by DHS)
- Armada is dead (by Aggression)
- ATM 10 Years (by Checkpoint)
- Azed/Jungle demo (by Atari)
- Beat Demo (by Frontline)
- Bird Mad Girl Show (by Fraggle's)
- Birdie (by Zeal)
- Blue Period (by Paradox)
- BoingSTE
- CD-player (by Light)
- Cernit Trandafir (by DHS)
- Circus BackSTage (by BlaBLa)
- 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)
- French Kiss (by DHS)
- Gobi Toons (by Dune)
- Grimey (by Reservoir Gods)
- Hatari 1.9 (by Mr. Styckx)
- High Fidelity Dreams (by Aura)
- HighResMode (by Paradox)
- Illusion (by Next)
- 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)
- 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)
- Muda (by Live!)
- Necrosys (by Hemoroids)
- New Year -94 Intro (by Extream)
- No Monkey (by Tomchi)
- Pacemaker (by Paradox), end part works only from floppy image
- Paracon 6 & 7 remindtros (by Paradox)
- Power Rise (by Light)
- Reanimation (by Syntax)
- Realtime (by MJJ Prod)
- Riverside (by DHS)
- RGBeast (by Aggression)
- SaboTagE (by Paradox)
- Save the Earth (by Defence Force)
- Sinfull Sinuses (by Chronicle)
- Sierpinski overdose 4K (by GGN), med-rez+blitter only
- Sommarhack (by DHS)
- Songs Of The Unexpected (by OUCH)
- 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)
- Time Slices (by Defence Force)
- Tribute to Rainbow TOS
- Tyranny (by DHS)
- UFO (by Dune & Sector1)
- Unbeatable (by Masters of Electric City)
- Vision (by POV)
- We Were @ STNICCC 2015 (by Oxygene)
  - Reset screen colors are wrong and scrolltext skewed
- XiTEC Presentation (by Omega)

Color games:
- 4K Pacman
- 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)
- Boom (screen flashes during scrolling messages)
- Breakdance (scene game, STOS, needs EmuTOS >v0.9.3)
- ChuChu Rocket* (full version, needs EmuTOS >0.9.7)
- Crash Time Plumber
- Droid STE rewrite (WIP)
- Dynabusters+*
- Frantick
- Giana Sisters STE rewrite: (needs EmuTOS >v0.9.3)
  http://atari-forum.com/viewtopic.php?f=3&t=26360
- H Mec 2 (line-A bitblit)
- 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: (needs EmuTOS >v0.9.3)
  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)
- Roger (line-A bitblit)
- R-Type Deluxe (arcade conversion)
  http://atari-forum.com/viewtopic.php?f=28&t=29047
- Skulls (shareware "minesweeper")
- Spy 4k
- Stardust* (tunnel sequence demo)
- STEtris
- STrEet Fighter II (incomplete)
- Stupid balloon game (joysticks swapped?)
- Substation* (demo)
- The chronicles of Omega
- Tomtar
- Trapped II (DMA audio, line-A functions 1, 2, 3, 5, 7, 9)
- Ultimate Arena v1.3 light (slow with EmuTOS)
- Utopos* (demo)
- Wolfenstein3D v0.8a* (a bit unstable)
- 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 (enhanced) music applications:
- Blipp Blopper
- EPSS
- DeskTracker MT
- Hextracker
- MaxYMizer
- MusicPlayer
- Octalyzer
- Paula
- Protracker 2 STE
- Sirius Player

Most of the non-GEM ST tracker & chip music composer programs work
also with EmuTOS too (not just STe ones), most even with the 512kB
EmuTOS version.


Non-working Atari STE programs
------------------------------

Partially working STE demos (old info, maybe 0.8.x?):
- 20 years megademo (by Atari scene collective)
  - issues in some screens that are for STE
- 20 years Atari STE megademo (by Paradox)
  - some screen don't work

Non-working games and music programs:
- Art for Kids demo (Bus error at $6, after vro_cpyfm)
  - with 512k image, bus errors already at startup
- Bombaman (joystick input doesn't work in game itself):
  http://homepage.ntlworld.com/kevcallahan/bombaman/
- Cameleon (see EmuTOS incompatible.txt)
- Hero (STOS, see EmuTOS incompatible.txt)
- Protracker v2 STE, Equinox version
  - http://www.pouet.net/prod.php?which=13381
  - see EmuTOS incompatible.txt
- Zaptastic (input doesn't work at startup screen)


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

TT emulation requires 512kB version of EmuTOS (the one shipped with
Hatari).  TT-low (256-color) mode and sound support requires EmuTOS
v0.9.6 or newer.

Working applications:
- Mandelbrot playtime (fracplay, uses FPU)
- PixArt4 (requires EmuTOS >v0.9.8)
  - http://www.1632systems.co.uk/www/html/Product/pixart.htm

Working demos:
- 256mbrot, Bragg, Glasstro, Orion-B, Yabt (TT/Falcon intros by ray//.tSCc)
- 4getful (by gwEm, 4KB intro TT-version)
  - Use either EmuTOS <v0.9, or less accurate Hatari oldUAE CPU core
- Adebug 3DTT demo (by Brainstorm)
- CrY image viewer (by .tSCc)
- Mandelbrot explorer (by .tSCc)
- TC fish (by .tSCc)
- TT highres slideshow (by .tSCc)
- Shiny Bubbles TT (by Xanth FX)
- XiTEC demos (by Omega)
  - On exiting Swing EmuTOS panics with privilege violation
    (TOS bombs and continues)

Working games:
- Capy (by YesCREW)
- GEM NetHack v3.4.3
- GEM Slashem v3.3.1
- Oxyd (Falcon version)

Broken programs:
- OpenTTD:
  - Needs hundreds of MBs of TT-RAM
  - Needs to be started from TT-low resolution
 (- works also on Falcon with FPU, DSP can be disabled for speed)


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

Falcon emulation requires 512kB version of EmuTOS
(the one shipped with Hatari).

Latest EmuTOS missing:
- HiColor support
- XBios functions for DSP

probably explains partly why graphics in many of the demos & games
look broken, their sound or music doesn't work, or why they freeze at
startup.

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


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

Working demos:
- 1600x600
- 30l coke, needs DSP
- 4getful (by gwEm, 4KB intro Falcon version)
  - Has way too low volume
- A Rh Positive 4k (by tSCc), needs DSP
- Ascii (by Reservoir Gods), disable DSP
- ATS (by DHS)
- Autowachen Verboten (by Lazer)
- Binliner (preview by Avena)
- Birdshow
- Bugs from outer space (by Impulse)
  - bad sound
- Cebit 93 (by Respectables)
  - needs WinUAE CPU core
- 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)
  - needs WinUAE CPU core
- Game of Life 4k (by Aggression)
- Gourand triangles demos (by ray//.tSCc)
  - these have asm sources!
- Illusion 64 (by Paranoia)
  - plasma screen has garbage on right side,
    end screen at top & bottom
- Mouse (animation + music)
- Old Stuff (by Extream)
- Prepare (by Extream)
- RGB Reine (by New Beat)
- Rock Solid (by Paranoia)
- Six Sievert (by tSCc)
- Snowstorm (by Reservoir Gods), disable DSP
- Sonolumineszenz (by Avena)
  - works before v0.9.1, but without sounds
- Terrorize Your Soul (by tSCc)
  - fonts and colors aren't 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)
- ZZ 9 Plural Z Alpha (by tSCc)

Demos regressed in EmuTOS v0.8.7, working again in EmuTOS >0.9.3:
- Blue 4k (by New Beat)
  - Ikbdws() stack usage compared to TOS4 was issue

Partly working demos:
- Agony (by DNT crew)
  - freezes after a while
    XBIOS 109 (Dsp_ExecProg)
    Bus error bget at 00400000
- Built-in Obsolescence (by Digital Chaos)
  - requires WinUAE core
  - Eventually dies to Dsp Stack Over/underflow  
- Motion (unfinished demo by Aggression)
  - only writer screens work
- Gurkensalat (by Lazer)
  - freezes after a while
- Illness (by Escape)
  - freezes after a while to
    Bus error lget at 4e700cb9
- I want you to remember (by KÜA Software & Pixel Twins)
  - No music as it needs DSP
- Jesterday (by POV)
  - Music demo, but no music as it needs DSP
- Oergs (by Lazer)
  - Music is bad
- Schlumpf invtro (by Lazer)
  - Music is bad
  - Colors are wrong
  - Input doesn't work to advance next screen
- Yepyha (by Toons)
  - Music is missing (needs DSP?)

Demos that with normal TOS work without DSP HW,
but don't work with EmuTOS at all:
- GEM demo (by DHS & AssemSoft):
  - needs HiColor mode
- Beams (by .tscc):
  panic with bus error:
  M68000 Bus Error reading at address $3b4.
- Tere Ra'I (by Cerebral Vortex / Dune / Sector One)
- Silly Venture 2k16 invitro (by Dune / Mystic Bytes)
- Unexpected Fun (by Orion_)
  - these exit as Dsp_Lock() fails


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

Games regressed in EmuTOS v0.8.x (not working anymore):
- Columns by Deadheart* (demo)
  -  colors/graphics are wrong
    (in v0.8.7 screen was just black with music on background)
- Rave*
  - colors/graphics are wrong
    (in v0.8.6, only at actual game lower half)
- SBM v0.8 (Bomberman clone)*
  - Bus error wget at 00400000

Games working in EmuTOS >=v0.9.0:
- Aces High (preview)
- BeGEMeD* (Falcon version)
- Blum
- Cavemania (demo version)
- Corsair
- DB 4K
- Double Bobble 2000* (by Reservoir Gods), disable DSP
- Dry Egg (needs >4MB RAM)
- FalcTron
- Ganymed (start with F1)
- Heretic (very slow)
- Hexogan (use number pad)
- Impulse (Breakout clone)*
- Lamemine
- Les Dinosaures (demo)
- LlamaZap free version (requires joypad, not joystick)
- Madtris
- Nibe
- Running (demo)*
- Radical Race (demo)*
- Spice (Defender clone)*
- Static (Patience by Reservoir Gods), disable DSP
- Steinbruch
- Switch
- Tank Blaster
- Tautology (by Reservoir Gods)
- Tautology II* (by Reservoir Gods)
- Toy Man
- Willie's Adventure (preview1), disable DSP
- Willie's Adventure* (preview2)

Games working in EmuTOS >v0.9.0:
- Jeu de Poker
  - needs 640x480@256 VGA mode
- Landmine (GEM minesweeper)
- Let's play Shanghai
  - needs 640x400@256 mode
- Manga Puzzle
  - needs 256 color mode
- Pac Them*
- Santarun (GEM, slowish)
- Vertical Mayhem(+) (Columns clone)*
- Zodiax (Falcon "R-type")
  - Sound requires EmuTOS >v0.9.5 (for sound matrix default values)

Games working in EmuTOS >v0.9.3:
- Chainz:
  - vga, press space at start to disable DSP use
- Jewelz
  - vga, select hatari mode (F2)
- King Solitaire
- Risk 030 demo
  - Needs 640x480@16 VGA mode
- Sweety Things
- Ultimate Arena Falcon edition:
  - doesn't recognize it's on Falcon -> select "Test"
  - crashes sometimes

Chainz, Jewels, Sweety and Poker games need to be started from 640x480
mode, otherwise EmuTOS constrains mouse movements to too small area.

Games working in EmuTOS >v0.9.5:
- GEM breakout
- The Ultimate Minesweeper (16-color GEM game)
(Earlier EmuTOS versions have problems with mouse clicks)

Games working in EmuTOS >0.9.6:
- Chorensha (old, non-DSP version)
- Block Blizzard preview (line-A bitblit + hide cursor / show mouse)
- Masters of Chaos (multiplayer "dungeon master")

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, enabling DSP freezes the games right at startup
    (with normal TOS4, DSP is used for background music)

Games that might be possible to get working (they show something
and/or don't use DSP XBios calls or DSP sound matrix):
- Bomb Squad: graphics look wrong (HiColor?)
- Confusion (demos 1 & 2): title screen doesn't come up
- Conquest of Elysium: screen with garbage
- Gold island (demo, vga only), parts of blits are missing
- Des Lazers & des Hommes, game area graphics are missing (they're rendered with DSP)
- It's Great (start from st-med rez): mouse doesn't work
- Men at War: freezes at startup (uses sound matrix)
- Multibriques: colors are wrong
- Neurobot: just exits
- Painium: exception 15 panic when pressing fire in game itself
- Tetrhex: bus error panic after trying to set 256 color mode
- Tron 2: illegal instruction panic on startup
- TsccTron: bus error reading at address $0 at startup


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

Working applications:
- Aniplayer v2.22
- BIQ codec / player (by .tscc, has sources)
- Cecile hard disk (image) driver
- DSP-debug debugger
- Godpaint (by Reservoir Gods)
- ICDraw, .ICO and .IB3 GEM viewer
- Kronos v1.91 benchmark
- Rainbow 2 multimedia, needs WinUAE CPU core for MMU
- Smurf (GEM image viewer)

Partly working applications:
- Centurbo benchmark:
  - DSP speed 0, with normal TOS the correct 32Mhz
   (bogus speed values for FPU & CPU as with normal TOS)
- Delmpaint (GFA)
   - some draw operations do black on black
   - file selector in wrong size if program is started
     from some other resolution than 320x200@256
- Escape paint (GEM)
  - Icons don't show in image operations window, and their
    places are inverted on mouse-over, image names show in
    image list window only on highlight, some UI elements
    flicker
- Fractal Playground
  - DSP needs to be disabled, keyboard input doesn't work
- Whip! (virtual light machine)
  - Cursor is frozen unless DSP is disabled
  - Non-DSP effects work
- Winrec (direct to disk GEM audio recorder/effects)
  - Starts fine and GUI works, but I didn't try recording,
    may actually work fine

Broken applications:
- AceMidi demo (softsynth sounds need DSP)
  - freezes after loading sound bank
- AceTracker:
  - exits after starting
- Centview (GEM image viewer)
  - For JPG images, requires running jpegd.prg first
  - Says "Ce fichier n'a pu etre ouvert"
- DSPdit (by .tscc)
  - panic with bus error
- FalcAMP (GEM)
  - buttons aren't drawn in window 
  - complains about DSP
- FlaySID
  - says "cannot connect with DSP matrix" when playing
    (has no sound with Hatari even with real TOS)
- Flextracker
  - black screen after pressing space at startup at Dsp_LoadProg()
  - Needs WinUAE Hatari CPU core (with normal TOS)
- Gemplay v1.49, v1.92 and v1.95
  - Says "needs Falcon 030 to run"
- Indypaint
  - cursor moves, but screen is black, F1-F4 keys don't work
  - needs HiColor mode
- MP2 player:
  - Says that DSP and audio subsystem are already in use
  - When playing is forced, there's no sound
  - Time runs in large jumps


	- Eero
