Warning, /graphics/digikam/README.md is written in an unsupported language. File is not indexed.
0001 ![](https://c1.staticflickr.com/1/822/26082076957_5ff0796a99_o.png) digiKam - Professional Photo Management with the Power of Open Source 0002 0003 <!-- 0004 TODO: more badges to plug when available 0005 https://invent.kde.org/graphics/digikam/badges/master/coverage.svg 0006 https://invent.kde.org/graphics/digikam/-/badges/release.svg 0007 --> 0008 0009 | CI Job | Status | 0010 |---------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| 0011 | Gitlab Builds | [![Gitlab Builds Status](https://invent.kde.org/graphics/digikam/badges/master/pipeline.svg)](https://invent.kde.org/graphics/digikam/-/pipelines) | 0012 | 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/) | 0013 | Coverity Scan | [![Coverity Scan Status](https://scan.coverity.com/projects/285/badge.svg)](https://scan.coverity.com/projects/digikam) | 0014 0015 If 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) 0016 0017 Developers, if you want to contribute, see the online [API documentation here](https://www.digikam.org/api) 0018 0019 NOTE: master branch support Qt5 and Qt6 frameworks and is dedicated to 8.x and later release. 0020 0021 # About 0022 0023 digiKam is an advanced open-source digital photo management application that runs on Linux, Windows, and MacOS. 0024 The application provides a comprehensive set of tools for importing, managing, editing, and sharing photos and RAW files. 0025 0026 [![](https://c1.staticflickr.com/5/4216/35354951072_a034561b5e_c.jpg "Albums View and Image Editor")](https://www.flickr.com/photos/digikam/35354951072/) 0027 0028 You can use digiKam's import capabilities to easily transfer photos, RAW files, and videos directly from your camera 0029 and external storage devices (SD cards, USB disks, etc.). The application allows you to configure import settings 0030 and rules that process and organize imported items on-the-fly. 0031 0032 [![](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) 0033 0034 digiKam organizes photos, RAW files, and videos into albums. But the application also features powerful tagging 0035 tools that allow you to assign tags, ratings, and labels to photos and raw files. You can then use filtering 0036 functionality to quickly find items that match specific criteria. 0037 0038 [![](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) 0039 0040 In addition to filtering functionality, digiKam features powerful searching capabilities that let you search 0041 the photo library by a wide range of criteria. You can search photos by tags, labels, rating, data, location, 0042 and even specific EXIF, IPTC, or XMP metadata. 0043 0044 [![](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) 0045 0046 You can also combine several criteria for more advanced searches. digiKam rely on Exiv2 library to handle metadata 0047 tag contents from files to populate the photo library. 0048 0049 [![](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) 0050 0051 digiKam can handle RAW files, and the application uses the excellent LibRaw library for decoding raw files. 0052 The library is actively maintained and regularly updated to include support for the latest camera models. 0053 0054 [![](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) 0055 0056 The application provides a comprehensive set of editing tools. This includes basic tools for adjusting colors, 0057 cropping, and sharpening as well as advanced tools for, curves adjustment, panorama stitching, and much more. 0058 A special tool based on Lensfun library permit to apply lens corrections automatically on images. 0059 0060 [![](https://c1.staticflickr.com/5/4649/40430534662_097b46a270_c.jpg "Panorama tool stiching photo")](https://www.flickr.com/photos/digikam/40474079731) 0061 0062 Extended functionality in digiKam is implemented via a set of tools, dedicated especially to import and export 0063 contents to remote web-services. 0064 0065 digiKam is based in part on the work of the Independent JPEG Group. 0066 0067 # Authors 0068 0069 See [AUTHORS](AUTHORS) file for details. 0070 0071 # Related URLs 0072 0073 * [digiKam project web site](https://www.digikam.org) 0074 * [digiKam handbook git repository](https://invent.kde.org/documentation/digikam-doc) 0075 * [digiKam web site git repository](https://invent.kde.org/websites/digikam-org) 0076 * [digiKam unit-test data git repository](https://invent.kde.org/graphics/digikam-test-data) 0077 0078 # Contact 0079 0080 If you have questions, comments, and suggestions, write an email to: 0081 0082 digikam-users@kde.org 0083 0084 If you want to contribute to digiKam developments write an email to: 0085 0086 digikam-devel@kde.org 0087 0088 IRC channel from irc.libera.chat server: #digikam (or use [web chat](https://web.libera.chat/)) 0089 0090 # Bug reports 0091 0092 IMPORTANT: the bug reports and wishlist entries are hosted by the Bugzilla 0093 system which can be reached from the standard Help menu of digiKam. 0094 A mail will automatically be sent to the digiKam development mailing list. 0095 There is no need to contact directly the digiKam mailing list for a bug report 0096 or a devel wish. 0097 0098 The current bugs and devel wishes reported to the bugzilla servers can be seen at this url: 0099 0100 * [digiKam](https://bugs.kde.org/buglist.cgi?product=digikam&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED) 0101 0102 Extra Bugzilla servers for shared libs used by digiKam : 0103 0104 * [LibRaw library](https://github.com/LibRaw/LibRaw/issues) 0105 * [Lensfun library](https://github.com/lensfun/lensfun/issues) 0106 * [GPhoto2 library](http://gphoto.org/bugs) 0107 * [Exiv2 library](https://github.com/Exiv2/exiv2/issues) 0108 0109 # External Dependencies 0110 0111 See the [online Dependencies list](https://www.digikam.org/api/index.html#externaldeps) for details. 0112 0113 # Cmake Configuration 0114 0115 See the [online Configuration rules](https://www.digikam.org/api/index.html#cmakeoptions) for details. 0116 0117 # Installation 0118 0119 In order to compile for qt5, just use something like that: 0120 0121 export QTDIR=/usr/lib/qt5 0122 export PATH=$QTDIR/bin:$PATH 0123 cmake . 0124 make -j4 0125 sudo make install/fast 0126 0127 Usual CMake options : 0128 0129 * `-DCMAKE_INSTALL_PREFIX` : decide where the program will be install on your computer. 0130 * `-DCMAKE_BUILD_TYPE` : decide which type of build you want. You can chose between: 0131 * `Debug`. : for hacking. Include all debug information. 0132 * `RelWithDebInfo` : default. use gcc `-O2` `-g` options. 0133 * `Release` : generate stripped and optimized bin files. For packaging. 0134 0135 More details can be found [at this url](https://community.kde.org/Guidelines_and_HOWTOs/CMake) 0136 0137 Note: To know KDE install path on your computer, use `kf5-config --prefix` command line like this (with full debug object enabled): 0138 0139 * `cmake . -DCMAKE_BUILD_TYPE=debugfull -DCMAKE_INSTALL_PREFIX=$(kf5-config --prefix)` 0140 0141 # Donate Money 0142 0143 If you love digiKam, you can help developers to buy new photo devices to test 0144 and implement new features. Thanks in advance for your generous donations. 0145 0146 For more information, look [at this url](https://www.digikam.org/donate/)