Debian

First, make sure that the required packages for Qt4 development of your distribution are installed, these are

for Debian and Ubuntu <= 11.10 :

apt-get install qt4-qmake libqt4-dev build-essential libboost-dev libboost-system-dev \
    libboost-filesystem-dev libboost-program-options-dev libboost-thread-dev \
    libssl-dev libdb4.8++-dev libminiupnpc-dev

for Ubuntu >= 12.04 (please read the 'Berkely DB version warning' below):

apt-get install qt4-qmake libqt4-dev build-essential libboost-dev libboost-system-dev \
    libboost-filesystem-dev libboost-program-options-dev libboost-thread-dev \
    libssl-dev libdb++-dev libminiupnpc-dev

For Qt 5 you need the following, otherwise you get an error with lrelease when running qmake:

apt-get install qt5-qmake libqt5gui5 libqt5core5 libqt5dbus5 qttools5-dev-tools

then execute the following:

qmake
make

Alternatively, install Qt Creator and open the ecoin-qt.pro file.

An executable named ecoin-qt will be built.

Mac OS X

• Download and install the Qt Mac OS X SDK. It is recommended to also install Apple's Xcode with UNIX tools.
• Download and install either MacPorts or HomeBrew.
• Execute the following commands in a terminal to get the dependencies using MacPorts:

sudo port selfupdate
sudo port install boost db48 miniupnpc

• Execute the following commands in a terminal to get the dependencies using HomeBrew:

brew update
brew install boost miniupnpc openssl berkeley-db4

• If using HomeBrew, edit ecoin-qt.pro to account for library location differences. There's a diff in contrib/homebrew/bitcoin-qt-pro.patch that shows what you need to change, or you can just patch by doing

  patch -p1 < contrib/homebrew/bitcoin.qt.pro.patch

• Open the ecoin-qt.pro file in Qt Creator and build as normal (cmd-B)

UPnP port forwarding

To use UPnP for port forwarding behind a NAT router (recommended, as more connections overall allow for a faster and more stable ecoin experience), pass the following argument to qmake:

qmake "USE_UPNP=1"

(in Qt Creator, you can find the setting for additional qmake arguments under "Projects" -> "Build Settings" -> "Build Steps", then click "Details" next to qmake)

This requires miniupnpc for UPnP port mapping. It can be downloaded from http://miniupnp.tuxfamily.org/files/. UPnP support is not compiled in by default.

Set USE_UPNP to a different value to control this:

Notification support for recent (k)ubuntu versions

To see desktop notifications on (k)ubuntu versions starting from 10.04, enable usage of the FreeDesktop notification interface through DBUS using the following qmake option:

qmake "USE_DBUS=1"

Generation of QR codes

libqrencode may be used to generate QRCode images for payment requests. It can be downloaded from http://fukuchi.org/works/qrencode/index.html.en, or installed via your package manager. Pass the USE_QRCODE flag to qmake to control this: