DIGIKAM - MANAGE YOUR PHOTOGRAPHS LIKE A PROFESSIONAL WITH THE POWER OF OPEN SOURCE

-- ABOUT -------------------------------------------------------------

 digiKam is an easy to use and powerful digital photo management
 application, which makes importing, organizing and manipulating
 digital photos a "snap".  An easy to use interface is provided
 to connect to your digital camera, preview the images and download
 and/or delete them.

 The digiKam built-in image editor makes the common photo correction
 a simple task. The image editor is extensible via plugins and,
 since the digikamimageplugins project has been merged to digiKam core
 since release 0.9.2, all useful image editor plugins are available
 in the base installation.

 digiKam can also make use of the KIPI image handling plugins to
 extend its capabilities even further for photo manipulations,
 import and export, etc. The kipi-plugins package contains many
 very useful extensions.

 digiKam is based in part on the work of the Independent JPEG Group.


-- AUTHORS ------------------------------------------------------------

See AUTHORS file for details.


-- RELATED URLS -------------------------------------------------------

http://www.digikam.org

-- CONTACT ------------------------------------------------------------

If you have questions, comments, suggestions to make do email at :

digikam-users@kde.org

If you want contribute to digiKam developments do email at :

digikam-devel@kde.org

IRC channel from irc.freenode.org server: #digikam

-- BUG REPORTS --------------------------------------------------------

IMPORTANT : the bug reports and wishlist entries are hosted by the KDE bug report
system which can be reached from the standard KDE help menu of digiKam.
A mail will automatically be sent to the digiKam development mailing list.
There is no need to contact directly the digiKam mailing list for a bug report
or a devel wish.

The current bugs and devel wishes reported to the bugzilla servers can be seen at these urls :

* digiKam (KDE bugzilla):

http://bugs.kde.org/buglist.cgi?product=digikam&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED

* Image Editor plugins (KDE bugzilla):

http://bugs.kde.org/buglist.cgi?product=digikamimageplugins&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED

* Showfoto (KDE bugzilla):

http://bugs.kde.org/buglist.cgi?product=showfoto&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED

* Kipi-plugins (KDE bugzilla):

http://bugs.kde.org/buglist.cgi?product=kipiplugins&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED

Extra Bugzilla servers for shared libs used by digiKam :

* GPhoto2 library (sourceforge bugzilla):

http://gphoto.org/bugs

* Exiv2 library (robotbattle bugzilla):

http://dev.robotbattle.com/bugs/main_page.php


-- DEPENDENCIES -------------------------------------------------------

Name              Version                       URL                                                               Remarks

Required:

CMake             >= 3.0.0                      http://www.cmake.org
libqt             >= 5.1.0                      http://www.qtsoftware.com                                         Including run-time SQLite3 and Mysql database plugin.
kdelibs           >= 5.1.0                      http://www.kde.org
libexiv2          >= 0.24                       http://www.exiv2.org                                              Exiv2 0.25 recommend
libjpeg           >= 6b                         http://www.ijg.org
libtiff           >= 3.8.2                      http://www.remotesensing.org/libtiff
libpng            >= 1.2.0                      http://www.libpng.org/pub/png/libpng.html
liblcms           >= 2.x                        http://www.littlecms.com
libboostgraph     >= 1.43.0                     http://www.boost.org/doc/libs
libpgf            >= 6.11.24                    http://www.libpgf.org
libexpat          >= 2.0.0                      http://expat.sourceforge.net
libopencv         >= 2.4.9                      http://opencv.willowgarage.com
Optional:

libkipi           >= 5.0.0                      https://projects.kde.org/projects/kde/kdegraphics/libs/libkipi    To support Kipi-plugins.
libkface          >= 5.0.0                      https://projects.kde.org/projects/extragear/libs/libkface         To support faces detection and recognition.
libmarble         >= 0.22.0                     https://projects.kde.org/projects/kde/kdeedu/marble               To support geolocation maps.
libakonadicontact >= 5.x                        https://projects.kde.org/projects/kde/kdepimlibs                  To support KDE Address Book entries.
libkfilemetadata  >= 5.x                        https://projects.kde.org/projects/kde/kdelibs/baloo               To support KDE files indexing support.
libjasper         >= 1.7.0                      http://www.ece.uvic.ca/~mdadams/jasper                            To support JPEG2000.
liblensfun        >= 0.2.6                      http://lensfun.sourceforge.net                                    To support LensCorrection tool.
liblqr-1          >= 0.4.1                      http://liblqr.wikidot.com                                         To support Liquid Rescale tool.
libeigen3         >= 3.0.0                      http://eigen.tuxfamily.org                                        To support Refocus tool.
libgphoto2        >= 2.4.0                      http://www.gphoto.org                                             To support Gphoto2 Cameras drivers.
libusb            >= 1.0.0                      http://www.libusb.org                                             Required by Gphoto2 as linking dependency. See details in bug #268267.
doxygen           >= 1.8.0                      http://www.doxygen.org                                            To support API documentation building (This does not affect building digiKam in any way).

Note: all library dependencies require development and binary packages installed on your computer to compile digiKam.

CMake compilation options to custom digiKam:

Use CMake "-DENABLE_KINOTIFY=on"              flag to compile digiKam with embeded Inotify wrapper for Linux                         (disabled by default).
Use CMake "-DENABLE_BALOOSUPPORT=on"          flag to compile digiKam with Baloo support                                             (disabled by default).
Use CMake "-DENABLE_AKONADICONTACTSUPPORT=on" flag to compile digiKam with KdePimLibs support                                        (disabled by default).
Use CMake "-DENABLE_MEDIAPLAYER=on"           flag to compile digiKam with QtMultimedia support                                      (disabled by default).
Use CMake "-DENABLE_OPENCV3=on"               flag to compile digiKam source code using OpenCV3 instead OpenCV2                      (disabled by default).
                                              OpenCV3 support needs extra contrib modules package, especially 'face'
                                              and 'legacy' components.
                                          
Mysql support options (experimental):

Use CMake "-DENABLE_MYSQLSUPPORT=on"          flag to compile digiKam with MysSql support                                            (disabled by default).
Use CMake "-DENABLE_INTERNALMYSQL=on"         flag to compile digiKam with internal MySQL server                                     (disabled by default).

Debug options:

Use CMake "-DBUILD_TESTING=on"                flag to compile digiKam source code unit tests                                         (disabled by default).

digiKam do not have any video thumbnailer. Video support is delegate to KDE. To support Video thumbnails, 
please install "ffmpegthumbs" package, which is the kdemultimedia Video thumbnail generator for KDE4 file managers.

-- INSTALLATION --------------------------------------------------------

In order to compile, just use something like that:

# export VERBOSE=1
# export QTDIR=/usr/lib/qt5
# export PATH=$QTDIR/bin:$PATH
# cmake .
# make
# sudo make install

Usual CMake options :

-DCMAKE_INSTALL_PREFIX : decide where the program will be install on your computer.
-DCMAKE_BUILD_TYPE     : decide which type of build you want. You can chose between:
                         "debugfull".     : for hacking. Include all debug information.
                         "debug".
                         "profile".
                         "relwithdebinfo" : default. use gcc -O2 -g options.
                         "release"        : generate stripped and optimized bin files. For packaging.

Compared to old autoconf options:

"cmake . -DCMAKE_BUILD_TYPE=debugfull" is equivalent to "./configure --enable-debug=full"
"cmake . -DCMAKE_INSTALL_PREFIX=/usr"  is equivalent to "./configure --prefix=/usr"

More details can be found at this url: http://techbase.kde.org/Development/Tutorials/CMake#Environment_Variables

Note: To know KDE install path on your computer, use 'kf5-config --prefix' command line like this (with full debug object enabled):

"cmake . -DCMAKE_BUILD_TYPE=debugfull -DCMAKE_INSTALL_PREFIX=`kf5-config --prefix`"

-- DONATE MONEY --------------------------------------------------------

If you love digiKam, you can help developers to buy new photo devices to test
and implement new features. Thanks in advance for your generous donations.

For more information, look at this url : http://www.digikam.org/?q=donation
