MediaWiki:Sitenotice:
2024-03-02: The wiki ran out of disk space, so things were not working. This has been resolved by adding another 5GB of quota ;-) Thanks to Tim Lindner for reporting the issues.
2020-05-17: If a page gives you an error about some revision not being found, just EDIT the page and the old page should appear in the editor. If it does, just SAVE that and the page should be restored. OS-9 Al (talk) 12:22, 17 May 2020 (CDT)
Using XRoar
| WELCOME |
|---|
| Looking for CoCo help? If you are trying to do something with your old Color Computer, read this quick reference. Want to contribute to this wiki? Be sure to read this first. This CoCo wiki project was started on October 29, 2004. --OS-9 Al |
See Recent Changes. | About this site. | Join the E-Mail List or Facebook Group. | Contact me with updates/questions.
This page was last updated on 12/29/2014. Total Pages: 744. Total Files: 994.
Home / Emulators - Using XRoar
XRoar is a cross-platform Dragon/Color Computer emulator. It will emulate everything from a 1980 4K CoCo to a 64K CoCo 2. It does not emulate a CoCo 3. It runs on Windows, Mac OS X, and Linux. It has also been ported to Android, Commodore Amiga, Playstation 3 (PS3), PlayStation Portable (PSP), and various other systems.
Downloading
The latest version can be downloaded from: http://www.6809.org.uk/xroar/
ROMS
You will need to download .rom files for each system you plan to emulate. You can find them at The Dragon Archive: http://archive.worldofdragon.org/archive/index.php?dir=Roms/
In the CoCo section, look for files like "Color Basic v1.X (198X)(Tandy).zip", "Extended Color Basic v1.X (198X)(Tandy).zip" or "Disk Extended Color Basic v1.x (198X)(Tandy).zip". You will need to unzip these files to get to the .rom files inside.
Windows
For Windows, you will download a .zip file and extract it in to a directory. Inside you will see "xroar.exe". Copy the .rom files in to this folder, then double-click the xroar.exe to start emulation. Choose the CoCo you want to emulate from the Machine pull down menu and you are set.
Mac OS X
For Mac, you will download a .dmg disk image. Double-click that to open it, then copy the files to a folder on your hard drive (for instance, Applications/XRoar, or even on your Desktop). You will need to make an XRoar folder inside your home folder's Library folder. Copy the ROMs there. (~/Library/XRoar).
Linux
Anyone want to document that for me? I wll update this when I try it out on my Raspberry Pi - OS-9 Al (talk) 08:27, 29 December 2014 (CST)
Configuring XRoar
Depending on the .rom files you have installed, XRoar will start up as some default system (which one?). If you only have "bas10.rom" installed (the original 1980 Color BASIC), it will default to a Color Basic 1.0 machine with 32K memory (maybe 64K?). If you have other .roms installed, it will default to larger systems.
You can use the "Machine" pull-down menu to select the CoCo you wish to emulate. If you wish to create a custom machine, such as an original 1980 4K CoCo, you can either use command-line options when you run the .exe file (or Mac/Linux binary), or create a configuration file (suggested).
Create a plain TEXT file called "xroar.conf" in the same location where you put the .rom files (.exe directory on Windows, ~Library/XRoar on Mac OS X). You can view the xroar.pdf documentation file for details, but here is a short example of the file for a 4K CoCo:
default-machine coco4k machine coco4k machine-desc Tandy CoCo 4K machine-arch coco ram 4 bas bas10 noextbas nodos tv-type ntsc
There are other config options you can add to force it to default to an NTSC (America) machine, or a PAL machine. If you create this file, then run the XRoar program, it will boot up to a 4K CoCo (assuming you have bas10.rom). You will see a "Tandy CoCo 4K" entry in the Machine pull-down menu.
More to come...