README
------
Andre Beckedorf < evilJazz AT katastrophos DOT net >


DISCLAIMER
----------
Everything in this directory is provided AS IS without any WARRANTY or
LIABILITIY of any kind implicitly or explicitly whatsoever.
In other words: IF SOMETHING GOES WRONG, IT'S YOUR FAULT, NOT MINE!


PREREQUISITES
-------------
In order to build the Quasar Media Player, you'll need a working
Qtopia, Qt3 or Qt4 SDK, a working cross-compiler setup and the usual build tools
(make, binutils etc).
For Qtopia and Zaurus development, Sharp's cross-compiler environment (see
below) will work okay.
You'll also need ccache (http://ccache.samba.org) for accelerated consecutive 
compilations. Most project files rely on ccache. If you don't want to use it, 
just modify the project file and remove the ccache calls.


Here are the cross-compiler environments I've used to build Quasar:

Qtopia / SharpROM:
------------------

My mirror:
http://www.katastrophos.net/zaurus/mirrors/externe.net/zaurus/sdk/Embedix.tgz
http://www.katastrophos.net/zaurus/mirrors/externe.net/zaurus/sdk/Qtopia.tgz

Externe.net
http://www.externe.net/zaurus/sdk/Embedix.tgz
http://www.externe.net/zaurus/sdk/Qtopia.tgz


Qt3 / pdaXrom:
--------------

ibiblio.org:
http://distro.ibiblio.org/pub/linux/distributions/pdaxrom/download/1.1.0beta1/Zaurus-7x0-860/cross-sdk-armv5tel-cacko-linux-3.4.5-2.2.5-softfloat.tar.bz2

My mirror:
http://www.katastrophos.net/zaurus/mirrors/pdaxrom/download/1.1.0beta1/Zaurus-7x0-860/cross-sdk-armv5tel-cacko-linux-3.4.5-2.2.5-softfloat.tar.bz2


The "distro/tools" directory contains two example scripts
"devenv-arm-sharp-qtopia.sh" and "devenv-arm-pdaxrom.sh" that will setup the 
environment variables for both cross-compilers.


Qt3 / MinGW / Windows:
----------------------

You may use any MinGW toolchain that is capable of compiling the 
Q... Windows Edition (GPLed Qt 3.x code for Windows).
Although the project is closed, the source code is still available and has
been used to create the Windows binaries of Quasar.

Check out:
http://qtwin.sourceforge.net

Detailed instructions on how to set up the build environment are here:
http://qtwin.sourceforge.net/qt3-win32/compile-mingw.php


Qt4 / Qt SDK / Maemo 5:
-----------------------

Install the latest version of Nokia's Qt SDK to /opt/QtSDK. Make sure
to select the Maemo MADDE environment during installation.
Check "distro/makedistro-maemo5-qt4.sh" for details on how to compile
Quasar without using Qt Creator.


MANUAL BUILD
------------

For Qtopia use the following command to create a Makefile:

tmake quasar-common.pri addons/addons-qscrobbler.pri \
 addons/addons-coverartdownloader.pri addons/backends-mplayer.pri \
 quasar-sharp-qtopia.pro > Makefile

For pdaXrom use this command to create the Makefile:

qmake quasar-pdaxrom.pro

To compile with the MinGW toolchain please use:

qmake quasar-mingw.pro

For native compilation use this:

qmake quasar-qt3.pro
or
qmake quasar-qt4.pro

If the Makefile was created successfully, do a simple

make

to create the "quasar" or "quasar.exe" binary.


AUTOMATIC BUILD via makedistro-* scripts
----------------------------------------

The included scripts in the "distro" subdirectory will take care of
automatically building the software:

  makedistro-maemo5-qt4.sh
  makedistro-osx.sh
  makedistro-pdaxrom.sh
  makedistro-sharp-qtopia.sh
  makedistro-windows-qt4.sh
  makedistro-windows.sh

Make sure to setup your cross-compiler environment correctly before proceeding. 
Included are three scripts in distro/tools that set the necessary environment 
variables:

  devenv-arm-maemo5-qtsdk-qt4.sh
  devenv-x86-osx-qt4.sh
  devenv-x86-ppc-osx.sh
  devenv-arm-pdaxrom.sh
  devenv-arm-sharp-qtopia.sh
  devenv-x86-mingw.sh
  devenv-win32-wine-qtsdk-qt4.sh

You'll probably need to adjust them and the "makedistro-*.sh" script to work on
your machine.

The Qt4 Windows build script requires the Qt SDK being installed in Wine as setting up
a Windows cross-compiler for Qt on Linux can be a PITA.

For Windows builds you will need to setup Inno Setup in Wine. Here is how to
do that:
http://katastrophos.net/andre/blog/2009/03/16/setting-up-the-inno-setup-compiler-on-debian/

If everything works as expected, you should have the distribution files waiting
for you in the distro/output directory.