Installation Instructions for the Dream Software

Windows installation
For information about how to download the latest version of source code from the anonymous CVS repository read this page.

Necessary software: or For information about how to compile Dream with MinGW instructions will be available again soon.

The following libraries are needed:
  • FFTW: Download the sources from http://www.fftw.org and create a static library libfftw.lib with the fftw and rfftw sources (FFTW version 2.x has to be used!). Copy this library together with the header files dfftw.h and drfftw.h in the drm/libs directory (We prepared Microsoft Visual C++ 6.0 project files for building this library and the compiled library with all necessary header files in WinFFTWInst.zip).
  • QWT: Download the sources from http://qwt.sourceforge.net (QWT version 4.2.0 has to be used) and create a static library libqwt.lib with the sources. Copy this library together with all header files from the include directory in the drm/libs directory (We prepared Microsoft Visual C++ 6.0 project files for building this library and the compiled library with all necessary header files in WinQWTInst.zip). Note: for Dream versions 1.7.11cvs and later the header files should be in drm/libs/qwt.
  • FhG IIS Journaline Decoder: Download WinFhGJourLib.zip and create a static library libfhgjournaline.lib with the sources. Copy this library together with all required header files in the drm/libs directory (The file WinFhGJourLib.zip contains the Microsoft Visual C++ 6.0 project files for building this library and the compiled library with all necessary header files).
  • FreeImage: Download the sources from http://freeimage.sourceforge.net and create a static library FreeImage.lib with the sources (Make sure to change the code generation to multithreaded DLL!). Copy this library together with the header file FreeImage.h in the drm/libs directory (We prepared the compiled library with all necessary header files in WinFreeImageInst.zip).
    With Qt3 or Q../Free for Windows Freeimage is not needed, but in this case is required the zlib library (a compiled version for Windows is available from here: zlib123-dll.zip).
  • FAAD2: Download the sources from http://www.audiocoding.com and create a static library libfaad.lib with the sources. IMPORTANT: Make sure to define the macros DRM and DRM_PS! Copy this library together with the header file neaacdec.h in the drm/libs directory.
    A version of FAAD2 that works with the Dream software can be downloaded here (WinFAAD2Inst.zip). Use the project file faad2/libfaad/libfaad.dsw to compile the sources and copy the library together with the header file (which is located in faad2/include) in the drm/libs directory.
  • FAAC: Download the sources from http://www.audiocoding.com and create a static library libfaac.lib with the sources. IMPORTANT: Make sure to define the macro DRM! Copy this library together with the header files faac.h and faaccfg.h in the drm/libs directory.
    A version of FAAC that works with the Dream software can be downloaded here (WinFAACInst.zip). Use the project file faac/libfaad/libfaac.dsw to compile the sources and copy the library together with the header files (which are located in faac/include) in the drm/libs directory.
    An experimental version of FAAC implementing the 960 transform length is available here (WinFAAC960Inst.zip)
  • Hamlib: Download the latest release from hamlib project file list and unzip the files. Copy all .dll-files from hamlib/bin either in the drm/windows or your Windows system folder. Copy the directory hamlib containing the header files from hamlib/include in the drm/libs directory. Copy the .lib-file from hamlib/lib/msvc in the drm/libs directory and rename it to libhamlib.lib (We prepared a zip-file containing all necessary files in WinHamlibInst.zip).
  • WinPcap: WinPcap is optional and allows reading of tcpdump and wireshark captures of MDI and RSCI streams. Use the filename as the parameter to the --rsiin argument. Enable the HAVE_LIBPCAP option in GlobalDefinitions.h. Download the installation and Developers Pack from the WinPcap site. Install WinPcap and place the .h and .lib files from the Developers pack in the dream libs directory. Alternatively use the file here: zipped headers, libs and dlls for WinPcap.

Dream installation:

  1. Before compiling the Dream sources call the batch file MocGUI.bat in the drm/windows directory to create the QT moc-files.
  2. Load the project file drm/windows/fdrm.dsw in your Visual C++ and compile the sources.
Linux Installation
Install devel packages of Trolltech QT 2.x or 3.x.

The following additional libraries are needed (if you recompile from the Dream source RPM, the package manager will complain about missing packages automatically):

  • FFTW: most modern Linux distributions ship versions of fftw. You need version 2 of the libraries, version 3 is not yet supported. Remember to install the devel packages.
  • QWT: Download the sources from http://qwt.sourceforge.net. You need to download qwt-4.2.0.tar.bz2.
    To recompile, do
    rpmbuild -ta qwt-4.2.0.tar.bz2
    
    Install qwt-4.2.0-1.i586.rpm and qwt-devel-4.2.0-1.i586.rpm. (Alternatively we provide a ready made source RPM below, compile with
    rpmbuild --rebuild qwt-4.2.0-1.src.rpm
    
  • FhG IIS Journaline Decoder: Download libjournaline_0.20040318_2.src.rpm and recompile with
    rpmbuild --rebuild libjournaline_0.20040318_2.src.rpm
    
    Install libjournaline-0.20040318_2.i586.rpm.
  • FAAD2: The sources from http://www.audiocoding.com are seriously outdated, Dream only works with the code from CVS. To make the recompile more convenient, we provide a suitable source RPM faad2_2.0.1cvs2006124_1.src.rpm which is based on the CVS code with this patch faad2-patch_20060124.txt applied. To recompile, do
    rpmbuild --rebuild faad2_2.0.1cvs2006124_1.src.rpm
    
    The rebuild needs a lot of development libraries to be installed, which are mainly needed to compile the xmms plugin. If you are only interested to use faad2 together with Dream, then you can build a smaller version of the faad2 library:
    rpmbuild --rebuild faad2_2.0.1cvs2006124_1.src.rpm --define without_xmms=1
    
    Install the resulting binary RPMs (for Dream you need at least the faad2 and the faad2-devel package). For compatibility with older versions of Dream we also have older 2.0 faad2 source packages here, but they do not work with Dream versions >=1.1!
Source RPM for fftw fftw-2.1.3-8.src.rpm
Source RPM for QWT qwt-4.2.0-1.src.rpm
Source RPM for faad2 (complete) faad2_2.0.1cvs2006124_1.src.rpm
Source RPM for Journaline decoder libjournaline_0.20040318_2.src.rpm

Dream installation from CVS code:

  1. Type sh ./bootstrap from the drm directory. That script will prepare system configuration detection's scripts. An Autoconf version 2.50 or higher is required for this script. If the bootstrap file is missing, skip this step.
  2. Type ./configure from the drm directory. That script will determine how your system is set up, and figure out how to compile Dream.
    At this point you can choose the type of sound interface you intend use. The standard setting is ALSA. To activate the OSS sound interface, type
    ./configure --disable-alsa
    For more help type
    ./configure --help
  3. Type make from the drm or drm/linux directory.

Dream installation from a released tar-ball:

Basically the same way to install, for newer tar-balls, step 1 is not needed.

Dream installation from Source RPM:

This is the easiest way to install, just recompile the source RPM. The SRPM provided on the download page assumes, that all packages above (Journaline, Hamlib and faad2) are installed.

Last modified: 13 May 2007