KPhotoAlbum

KPhotoAlbum is a tool which you can use to easily sort your images. It provides many capabilities to make sorting and viewing images easy.

Earlier versions of KPhotoAlbum were released under the name "KimDaBa". The current stable release is KPhotoAlbum version 4.7.2 (as of December 2016), and the current beta version is 5.0.1.

For an introduction, take the 3 minute KPhotoAlbum tour or see the Videos at KPhotoAlbum's Homepage. To learn more and view some screenshots read the FAQ.

KPhotoAlbum supports all the normal image formats including raw formats produced by most digital cameras and scanners (using dcraw to do the decoding). It is also possible to use the thumbnails embedded in raw images (that are usually of decent size and quality) for fast viewing so there is no need to decode the whole raw image.

Using KPhotoAlbum

There is a 3-minute Tour and a set of How-To videos on the project site. A KPhotoAlbum handbook is also available as a PDF and on-line version.

Getting KPhotoAlbum

Source packages, binaries for various distros, and snapshots are available from the project Download page.

KPhotoAlbum on Live systems like Knoppix

You can use an image file (or create your own) which integrates KPhotoAlbum in a Knoppix CD/DVD if KPhotoAlbum is missing there. The details can be found on the page KPhotoAlbum on Knoppix.

Building KPhotoAlbum

Step-by-step guide to build KPhotoAlbum from source code on Debian or Ubuntu are available on page Building KPhotoAlbum.

Extending KPhotoAlbum

• Image::Kimdaba is a perl module available on CPAN which parses the index.xml database.
  • Write your own extensions to KPhotoAlbum
  • Read Image::Kimdaba to download it and to see available scripts
• Another way to extend KPhotoAlbum is to write KIPI plugins (that are used also by other KDE photo applications). These plugins provide functions like exporting images to websites like Flickr, Picasa, Facebook, ... correcting exif date stamps or doing some other image manipulations. (KPhotoAlbum by itself does not touch the original files at all but preserves them intact).
• Other useful scripts are available from Wes Hardaker's site
• With Kimdaba2Mysql it's possible to:
  • insert your index.xml metadata into a mysql-database
  • generate a search-formular on your website with your kimdaba-keywords, example here
    

• Patches and features awaiting approval or implementation - Please use bugs.kde.org for that.

With pse3tokimdaba.pl it's possible to extract information from your Photoshop Elements 3 database to create an index.xml file. There are quite a few limitations, see the above page for more details.

djKPA is a Django web site designed to be the web interface of your KPhotoAlbum photo repository. The philosophy of djKPA is be as far as possible fully automatic: labels, tags, descriptions, ... of photo come from KPhotoAlbum. Nevertheless, djKPA is a real interactive application that allows your visitors to vote, post comments, show exif, ... and visit your photos by browsing the your Tags.

Help develop KPhotoAlbum

If you are interested in helping the KPhotoAlbum development or related projects, please look at this project page. Or, if you have an idea for a feature, please see the Feature Requests section, below.

Developer documentation

KPA Release Steps

• Update CMakeLists.txt with the new version number you are just about to tag (alas, our automatic versionning doesn't work anymore ;-)

Building a Release

Building a snapshot tar ball is rather straight forward. Install the releaseme building tool and run a command to generate the source package. As long as KPhotoAlbum is based on KDE 4, it's necessary to use the kdelibs4 branch.

git clone git://anongit.kde.org/releaseme
cd releaseme
git checkout kdelibs4

To create the source package, run e. g.:

./kphotoalbum.rb --version `date +%Y%m%d`

If a source package for a specific tagged version should be built, use that version number instead, e. g.:

./kphotoalbum.rb --version 4.6.2

GIT Branches

• master (build status)
  Current development branch
• 4.7
  Old stable (Qt4/Plasma4) branch. Only gets fixes for serious bugs on a case-by-case basis.
• 5.x
  Branch tracked by Neon/stable.
  When master is in stable condition, it should be synced to 5.x:

  git checkout 5.x ; git merge master

• Feature branches are used in a very ad-hoc manner. If you are not a developer, don't bother with them.
  If you are a developer, try using descriptive names that are not likely to interfere with future branches.

Known Bugs and feature requests

See the list of Bugs and workarounds in KPhotoAlbum.

Please use [1] marking the report as a "Wish".

New Ideas for Future Versions

If you have a new idea for KPhotoAlbum and think that bugs.kde.org is not the right place for it, use one of the communication channels listed on the pages.