Using XRoar - Revision history

AllenHuffman: /* Configuring XRoar */

2023-02-19T04:50:52Z

Configuring XRoar

← Older revision		Revision as of 00:50, 19 February 2023
Line 11:		Line 11:

	The "Machines" pull-down menu has several configurations you can select for various CoCos and Dragon machines, but if you want to do anything beyond that, you have to use command line options, or modify the xroar.conf to add new entries to the Machines pull-down.		The "Machines" pull-down menu has several configurations you can select for various CoCos and Dragon machines, but if you want to do anything beyond that, you have to use command line options, or modify the xroar.conf to add new entries to the Machines pull-down.


	* [[xroar.conf]] - add useful config entries to this page.		* [[xroar.conf]] - add useful config entries to this page.

AllenHuffman: /* Configuring XRoar */

2023-02-19T04:50:37Z

Configuring XRoar

← Older revision		Revision as of 00:50, 19 February 2023
Line 12:		Line 12:
	The "Machines" pull-down menu has several configurations you can select for various CoCos and Dragon machines, but if you want to do anything beyond that, you have to use command line options, or modify the xroar.conf to add new entries to the Machines pull-down.		The "Machines" pull-down menu has several configurations you can select for various CoCos and Dragon machines, but if you want to do anything beyond that, you have to use command line options, or modify the xroar.conf to add new entries to the Machines pull-down.

	~~Here are some examples of making XRoar run as a 1980 4K Color Computer (4K RAM, Color BASIC 1~~.0).
			* [[xroar.conf]] - add useful config entries to this page.

	== Creating a Windows shortcut for a 4K CoCo ==		== Creating a Windows shortcut for a 4K CoCo ==

AllenHuffman: adding download notes

2015-01-04T00:32:01Z

adding download notes

← Older revision		Revision as of 20:32, 3 January 2015
Line 1:		Line 1:
	{{NavEmulators}}		{{NavEmulators}}
			= Download XRoar =
			The XRoar CoCo 1/2/Dragon emulator may be downloaded here:

			http://www.6809.org.uk/xroar/

			It is available for Windows, Mac OS X, Linux and various other platforms. You will also need to download the ROM files for the computer (CoCo, Dragon, Color or Extended BASIC, Disk BASIC, etc.).

	= Configuring XRoar =		= 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.		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.

AllenHuffman: /* Configuring XRoar */

2015-01-02T16:12:53Z

Configuring XRoar

← Older revision		Revision as of 12:12, 2 January 2015
Line 2:		Line 2:
	= Configuring XRoar =		= 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.		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.

			The "Machines" pull-down menu has several configurations you can select for various CoCos and Dragon machines, but if you want to do anything beyond that, you have to use command line options, or modify the xroar.conf to add new entries to the Machines pull-down.

			Here are some examples of making XRoar run as a 1980 4K Color Computer (4K RAM, Color BASIC 1.0).

	== Creating a Windows shortcut for a 4K CoCo ==		== Creating a Windows shortcut for a 4K CoCo ==

AllenHuffman at 16:10, 2 January 2015

2015-01-02T16:10:44Z

← Older revision		Revision as of 12:10, 2 January 2015
Line 1:		Line 1:
			{{NavEmulators}}
	= Configuring XRoar =		= 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.		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.

AllenHuffman at 16:05, 2 January 2015

2015-01-02T16:05:41Z

← Older revision		Revision as of 12:05, 2 January 2015
Line 1:		Line 1:
	~~{{NavEmulators}}~~		= Configuring 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.		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.

	= ~~Downloading~~ =		== Creating a Windows shortcut for a 4K CoCo ==
	~~The latest version~~ can ~~be downloaded from: http://www.6809~~.~~org~~.~~uk/xroar/~~		If you have placed the .rom files in the same directory as xroar.exe, you can make a Windows shortcut that will launch it with specific options (see the list in the xroar.pdf documentation).

	~~== ROMS ==~~		1. In Windows Explorer, browse to where you have the xroar.exe.
	~~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.		[[File:XRoar_win_properties.PNG]]

	~~'''NOTE:''' It appears the bas10~~.~~rom you find there is corrupt~~. ~~There is another directory on that site with a fixed ROM,~~ and I will ~~post updates to this wiki entry when I know where it is~~.		2. Right-click on xroar.exe and select "Create Shortcut". This will make a new file called "xroar.exe - Shortcut"

	~~== Windows ==~~		3. Right-Click on "xroar.exe - Shortcut" and select "Properties". A new window comes up. In the "Target:" box is the path to the .exe file. Edit that by adding to the END of the .exe line the following command line options:
	~~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~~.		-ram 4 -bas bas10 -noextbas -nodos

	~~== Mac OS X ==~~		[[File:XRoar_win_shortcut.PNG]]
	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 ==~~		4. Click "OK" to save this shortcut. Now you can rename the shortcut to whatever you like, such as "4K CoCo", and move the shortcut anywhere you like (such as the Desktop) and when you double-click it, it should open XRoar with those options as a 4K CoCo.
	~~Anyone want~~ to ~~document that for me? I wll update~~ this ~~when I try it out on my Raspberry Pi - [[User:AllenHuffman\|OS-9 Al]] ([[User talk:AllenHuffman\|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~~.

			== Adding a 4K entry to the Machine pull-down menu ==
	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).		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).

AllenHuffman: /* ROMS */ note about corrupt bas10

2015-01-02T15:13:25Z

ROMS: note about corrupt bas10

← Older revision		Revision as of 11:13, 2 January 2015
Line 9:		Line 9:

	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.		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.

			'''NOTE:''' It appears the bas10.rom you find there is corrupt. There is another directory on that site with a fixed ROM, and I will post updates to this wiki entry when I know where it is.

	== Windows ==		== Windows ==

AllenHuffman: /* Configuring XRoar */

2014-12-29T14:30:10Z

Configuring XRoar

← Older revision		Revision as of 10:30, 29 December 2014
Line 34:		Line 34:
	noextbas		noextbas
	nodos		nodos
			tv-type ntsc
	</pre>		</pre>

AllenHuffman: Created page with "{{NavEmulators}} 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 run..."

2014-12-29T14:27:30Z

Created page with "{{NavEmulators}} 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 run..."

New page

{{NavEmulators}}
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 - [[User:AllenHuffman|OS-9 Al]] ([[User talk:AllenHuffman|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:
<pre>
default-machine coco4k
machine coco4k
machine-desc Tandy CoCo 4K
machine-arch coco
ram 4
bas bas10
noextbas
nodos
</pre>

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...