lxdream.org :: Download
lxdream 0.9.1
released Jun 29
Download Now

Available releases

lxdream 0.9.1   Jun 29 2009   Release Notes
  Source lxdream-0.9.1.tar.gz [2497K]   40147  
  Debian i386 binary lxdream_0.9.1_i386.deb [315K]   27560  
  Debian amd64 binary lxdream_0.9.1_amd64.deb [341K]   24558  
  Mac OS X 10.4 i386 binary lxdream-0.9.1-i386.dmg.zip [1885K]   60123  
lxdream 0.9   Oct 25 2008   Release Notes
  Source lxdream-0.9.tar.gz [2421K]   9662  
  Debian i386 binary lxdream_0.9_i386.deb [233K]   6846  
  Debian amd64 binary lxdream_0.9_amd64.deb [269K]   4345  
  Mac OS X 10.4 i386 binary lxdream-0.9-i386.dmg.zip [1811K]   9857  
lxdream 0.8.4   Jul 30 2008   Release Notes
  Source lxdream-0.8.4.tar.gz [1467K]   3521  
  Debian i386 binary lxdream_0.8.4_i386.deb [530K]   3845  
  Debian amd64 binary lxdream_0.8.4_amd64.deb [564K]   3017  
  Mac OS X 10.4 i386 binary lxdream-0.8.4-i386-2.dmg.zip [1918K]   5994  
  Mac OS X 10.4 i386 binary lxdream-0.8.4-i386.dmg.zip [1600K]   14244 [Superceded]
lxdream 0.8.3 lxdream-0.8.3.tar.gz [1074K] Jan 31 2008 8806 Release Notes
lxdream 0.8.2 lxdream-0.8.2.tar.gz [1051K] Dec 20 2007 3082 Release Notes
lxdream 0.8.1 lxdream-0.8.1.tar.gz [998K] Nov 8 2007 3450 Release Notes
lxdream 0.8 lxdream-0.8.tar.gz [968K] Oct 31 2007 3031 Release Notes
Milestone 3 lxdream-m3.tar.gz [959K] Sep 20 2007 1950 Release Notes
Milestone 2 lxdream-m2.tar.gz [819K] Feb 11 2007 1621 Release Notes
Milestone 1 lxdream-m1.tar.gz [244K] Jun 30 2006 2058 Release Notes

Mercurial Access

The brave and/or foolish can checkout the current development version from mercurial with (eg)

hg clone http://www.lxdream.org/hg/lxdream
. To later update your working copy to the latest version, the usual command is
hg pull -uv

Configuration

The configuration is loaded from the .lxdreamrc file in your home directory (if present), otherwise it is also checked for in the sysconf path and the current directory (as lxdreamrc). The file is used to supply file paths and controller configuration.

If you have a copy of the dreamcast BIOS, by default lxdream looks for it under bios/dcboot.rom. Similarly, it expects to find your flash partition under bios/dcflash.rom. Both are optional for demos, but some will probably need them. Also, lxdream is able to boot directly from the BIOS if it is provided.

Running

From the base directory, run src/lxdream. Alternatively to run a demo from the command line, run src/lxdream <demo-filename>, where <demo-filename> is an SH4 ELF binary (unscrambled).

If you have an IP.BIN bootstrap file and put it in the bios/ directory, lxdream will execute the bootstrap first before jumping to the demo. (Note that some demos will need the bootstrap to setup the environment correctly).

Other command line options

-A <audio-driver>Select an audio driver. Current options are esd or null
-V <video-driver>Select a video driver. Current options are gtk or null
-aAICA-only - starts lxdream with only the SPU chip and nothing else. Useful for running test ARM programs
-c <config-file>Specifies the location of the configuration file
-d <disc-image-file>Specifies a disc (CDI or NRG) to mount at startup
-HRun in headless mode (ie with no gui or video driver)
-pStart playing immediately (by default lxdream waits for the run button to be clicked)
-xDisable the SH4 translator (run in emulation-only mode)
-DDisplay the debugger window on startup
.