
 Dianara - A pump.io client
 Copyright 2012-2014  JanKusanagi <jancoding@gmx.com>

==============================================================================


These are some basic instructions on how to build Dianara from source, in case
you don't have precompiled packages available for your operating system.
See http://jancoding.wordpress.com/dianara for info on package availability.



===== General runtime dependencies (check carefully!) =====

 - Qt 4.8.x  (You _can_ build with Qt 5.x, but it will probably crash)
 - QJSON 0.7.x or 0.8.x
 - QOAuth 1.0.x
 - Libmagic
 - QCA and its openSSL plugin (qca2-plugin-openssl, libqca2-plugin-ossl, or similar)
   (Dianara will _crash_ if you don't have this!)


===== Dependencies for building =====

You'll need qmake and the qt-devel (>= 4.7, including QtNetwork and QtDBUS
modules, if they are separate), and qjson-devel, qoauth-devel and libmagic-devel packages.
Qmake might be included in the Qt development packages, or it might be a separate package.


These are the names of the packages for the build dependencies
in some GNU/Linux distributions:

  - Debian (and probably in its derivatives too):
      libqt4-dev, libqjson-dev, libqoauth-dev and libmagic-dev.

  - Mageia (probably in Mandriva, ROSA and Fedora too):
      i586: libqt4-devel, libqjson-devel, libqoauth-devel and libmagic-devel.
      x86_64: lib64qt4-devel, lib64qjson-devel, lib64qoauth-devel and lib64magic-devel.

  - openSuse:
      libqt4-devel, libqjson-devel, qoauth-devel and file-devel (has libmagic).

  - Archlinux (runtime dependencies include build-time dependencies):
      qt, qjson, qoauth, file (yes, this one includes libmagic).


You might also need to install qt4-qmake, if your distribution does not include
it with the Qt development package.



===== Build process =====

From Dianara main directory, where Dianara.pro is located, execute:

        mkdir build			# Create a clean directory for the build
        cd build			# Go into it
        qmake ..			# Ask Qmake to generate a Makefile*
        make				# Run Make to compile the project

(*if you have the command 'qmake-qt4' available, use that instead of 'qmake'!)

That should do it!


There is an installation target, but you can just run the resulting "dianara" binary.
The language files will be embedded into the binary upon compilation,
so there's no need to keep them afterwards.



Dianara is built on and for GNU/linux, but it will probably work under other systems,
as long as they are supported by Qt, and have ports of the necessary dependencies.

Building with Qt 5.x should work, but it's unsupported at the moment.




Visit http://jancoding.wordpress.com/dianara for more information.

Get the latest development source from http://gitorious.org/dianara
