1![](https://c1.staticflickr.com/1/822/26082076957_5ff0796a99_o.png) digiKam - Professional Photo Management with the Power of Open Source
2
3| CI Job        | Status                                                                                                                                                                                                  |
4|---------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
5| Linux Build   | [![Linux Build Status](https://build.kde.org/job/Extragear/job/digikam/job/kf5-qt5%20SUSEQt5.15/badge/icon)](https://build.kde.org/job/Extragear/job/digikam/job/kf5-qt5%20SUSEQt5.15/)                 |
6| FreeBSD Build | [![FreeBSD Build Status](https://build.kde.org/job/Extragear/job/digikam/job/kf5-qt5%20FreeBSDQt5.15/badge/icon)](https://build.kde.org/job/Extragear/job/digikam/job/kf5-qt5%20FreeBSDQt5.15/)         |
7| Windows Build | [![Windows build Status](https://build.kde.org/job/Extragear/job/digikam/job/kf5-qt5%20WindowsMSVCQt5.15/badge/icon)](https://build.kde.org/job/Extragear/job/digikam/job/kf5-qt5%20WindowsMSVCQt5.15/) |
8| Flatpak Build | [![FlatPak Build Status](https://binary-factory.kde.org/view/Flatpak/job/Digikam_x86_64_flatpak/badge/icon)](https://binary-factory.kde.org/view/Flatpak/job/Digikam_x86_64_flatpak/)                                 |
9| Coverity Scan | [![Coverity Scan Status](https://scan.coverity.com/projects/285/badge.svg)](https://scan.coverity.com/projects/digikam)                                                                                 |
10
11If you are reading this on Github, be aware that this is just a mirror. Our real code repository [is located here](https://invent.kde.org/graphics/digikam)
12
13Developers, if you want to contribute, see the online [API documentation here](https://www.digikam.org/api)
14
15# About
16
17digiKam is an advanced open-source digital photo management application that runs on Linux, Windows, and MacOS.
18The application provides a comprehensive set of tools for importing, managing, editing, and sharing photos and RAW files.
19
20[![](https://c1.staticflickr.com/5/4216/35354951072_a034561b5e_c.jpg "Albums View and Image Editor")](https://www.flickr.com/photos/digikam/35354951072/)
21
22You can use digiKam's import capabilities to easily transfer photos, RAW files, and videos directly from your camera
23and external storage devices (SD cards, USB disks, etc.). The application allows you to configure import settings
24and rules that process and organize imported items on-the-fly.
25
26[![](https://c1.staticflickr.com/1/703/32558229094_3d7ec01d3a_c.jpg "Map View displaying rated items and Batch Queue Manager in action")](https://www.flickr.com/photos/digikam/32558229094)
27
28digiKam organizes photos, RAW files, and videos into albums. But the application also features powerful tagging
29tools that allow you to assign tags, ratings, and labels to photos and raw files. You can then use filtering
30functionality to quickly find items that match specific criteria.
31
32[![](https://c2.staticflickr.com/4/3726/32557269024_ae870b0466_c.jpg "Search items by date rage and Geolocation editor")](https://www.flickr.com/photos/digikam/32557269024)
33
34In addition to filtering functionality, digiKam features powerful searching capabilities that let you search
35the photo library by a wide range of criteria. You can search photos by tags, labels, rating, data, location,
36and even specific EXIF, IPTC, or XMP metadata.
37
38[![](https://c1.staticflickr.com/1/306/32217007615_db6f9d116a_c.jpg "Search by Tags with preview mode and Metadata Editor in action")](https://www.flickr.com/photos/digikam/32217007615)
39
40You can also combine several criteria for more advanced searches. digiKam rely on Exiv2 library to handle metadata
41tag contents from files to populate the photo library.
42
43[![](https://c1.staticflickr.com/5/4795/40743725771_0b69dca743_c.jpg "Advanced search tool and video file result played as preview")](https://www.flickr.com/photos/digikam/40743725771)
44
45digiKam can handle RAW files, and the application uses the excellent LibRaw library for decoding raw files.
46The library is actively maintained and regularly updated to include support for the latest camera models.
47
48[![](https://c1.staticflickr.com/1/300/31407487553_a14abd0418_c.jpg "Find by items similarity and Light Table in cation to compare side by side")](https://www.flickr.com/photos/digikam/31407487553)
49
50The application provides a comprehensive set of editing tools. This includes basic tools for adjusting colors,
51cropping, and sharpening as well as advanced tools for, curves adjustment, panorama stitching, and much more.
52A special tool based on Lensfun library permit to apply lens corrections automatically on images.
53
54[![](https://c1.staticflickr.com/5/4649/40430534662_097b46a270_c.jpg "Panorama tool stiching photo")](https://www.flickr.com/photos/digikam/40474079731)
55
56Extended functionality in digiKam is implemented via a set of tools, dedicated especially to import and export
57contents to remote web-services.
58
59digiKam is based in part on the work of the Independent JPEG Group.
60
61# Authors
62
63See [AUTHORS](AUTHORS) file for details.
64
65# Related URLs
66
67https://www.digikam.org
68
69# Contact
70
71If you have questions, comments, and suggestions, write an email to:
72
73digikam-users@kde.org
74
75If you want contribute to digiKam developments write an email to:
76
77digikam-devel@kde.org
78
79IRC channel from irc.libera.chat server: #digikam (or use [web chat](https://web.libera.chat/))
80
81# Bug reports
82
83IMPORTANT : the bug reports and wishlist entries are hosted by the Bugzilla
84system which can be reached from the standard Help menu of digiKam.
85A mail will automatically be sent to the digiKam development mailing list.
86There is no need to contact directly the digiKam mailing list for a bug report
87or a devel wish.
88
89The current bugs and devel wishes reported to the bugzilla servers can be seen at this url:
90
91* [digiKam](https://bugs.kde.org/buglist.cgi?product=digikam&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED)
92
93Extra Bugzilla servers for shared libs used by digiKam :
94
95* [LibRaw library](https://github.com/LibRaw/LibRaw/issues)
96* [Lensfun library](https://github.com/lensfun/lensfun/issues)
97* [GPhoto2 library](http://gphoto.org/bugs)
98* [Exiv2 library](https://github.com/Exiv2/exiv2/issues)
99* [QtAV library](https://github.com/wang-bin/QtAV/issues)
100
101# External Dependencies
102
103See the [online Dependencies list](https://www.digikam.org/api/index.html#externaldeps) for details.
104
105# Cmake Configuration
106
107See the [online Configuration rules](https://www.digikam.org/api/index.html#cmakeoptions) for details.
108
109# Installation
110
111In order to compile, just use something like that:
112
113    export VERBOSE=1
114    export QTDIR=/usr/lib/qt5
115    export PATH=$QTDIR/bin:$PATH
116    cmake .
117    make -j4
118    sudo make install
119
120Usual CMake options :
121
122* `-DCMAKE_INSTALL_PREFIX`     : decide where the program will be install on your computer.
123* `-DCMAKE_BUILD_TYPE`         : decide which type of build you want. You can chose between:
124  * `debugfull`.               : for hacking. Include all debug information.
125  * `relwithdebinfo`           : default. use gcc `-O2` `-g` options.
126  * `release`                  : generate stripped and optimized bin files. For packaging.
127* `-DCMAKE_INSTALL_PREFIX=/usr`: install program in /usr.
128
129More details can be found [at this url](https://community.kde.org/Guidelines_and_HOWTOs/CMake)
130
131Note: To know KDE install path on your computer, use `kf5-config --prefix` command line like this (with full debug object enabled):
132
133* `cmake . -DCMAKE_BUILD_TYPE=debugfull -DCMAKE_INSTALL_PREFIX=$(kf5-config --prefix)`
134
135# Donate Money
136
137If you love digiKam, you can help developers to buy new photo devices to test
138and implement new features. Thanks in advance for your generous donations.
139
140For more information, look [at this url](https://www.digikam.org/donate/)
141