Navigation
XRoar is a Dragon and Tandy CoCo emulator for Linux, Unix, Mac OS X, GP32, Nintendo DS and Windows32.
See the README for more complete documentation.
XRoar is Free Software, distributed under the terms of the GNU General Public License.
The latest source code release is version 0.21, released 2008-04-24.
Binary packages may be linked against SDL and/or libsndfile, each of which are distributed under the terms of the GNU Lesser General Public License.
The i386 architecture within the Mac OS X fat binary package is currently untested.
The GP32 and NDS packages are built from a version of the source code patched for speed, at the expense of some accuracy. This affects: cross-colour rendering, mid-instruction synchronisation, rare usage of sound hardware. The NDS version supports DLDI patching, so should be able to work with any flash cartridge.
zx81 has ported XRoar 0.19 to the Sony PSP handheld. The port is called PSPDragon, and it's available here!
For more information, see the ChangeLog.
A common problem is that the emulator starts up but just displays a screen full of inverse '@' symbols. This is almost always a ROM problem: check the section in the README about what the firmware ROM images should be called, and be aware that the default machine XRoar tries to emulate is the Dragon 64.
If you don't have any firmware images, you might like to try this one. It doesn't do anything beyond trying to boot OS9 (Dragon version), and only a few cartridge images work with it (mostly CoCo software - Dragon carts seem to always contain many more direct jumps into ROM). If you do have images, but want to try this one anyway, save it out and use "-extbas FILENAME" to load it instead of the normal Dragon 64 image.
All versions except the GP32 and NDS builds require SDL for video, audio, keyboard and joystick support. The build process for all versions requires both SDL and SDL_image. Under Mac OS X, building SDL from source is preferable to installing one of the packages, as then the 'sdl-config' script is available.
Binary packages include the SDL library where appropriate.
XRoar can optionally utilise libsndfile to provide support for using audio files for cassette input.
Binary packages include the libsndfile library where appropriate.
Building for Linux/Unix requires GTK+ to provide a file requester.
Firmware ROM images are required for normal use, and XRoar will search for them in standard locations depending on architecture:
| Linux/Unix/Mac OS X |
Current working directory ~/.xroar/roms/ ~/Library/XRoar/Roms/ /usr/local/share/xroar/roms/ |
|---|---|
| GP32 | gp:/gpmm/dragon/ |
| NDS | fat:/dragon/roms/ |
| Windows32 | Current working directory |
A Darcs repository, usually reflecting the current development state, is provided:
$ darcs get http://www.6809.org.uk/repos/xroar
Note that the repository contains a 'configure' script that you may have to give execute permission to in order to run it (alternatively, call it as an argument to /bin/sh).
Updated 29 Apr 2008
