INSTALL

   1 A number of binary packages of KPhotoAlbum is available from the home page at
   2 http://www.kphotoalbum.org. You may want to have a look there before
   3 proceeding compiling the sources yourself.
   4
   5 ========== prerequisites ==========
   6
   7 KPhotoAlbum supports different features which are realized using
   8 external packages. All those packages are not strictly needed -
   9 KPhotoAlbum can be build and will run without them, but the
  10 corresponding features depend on them.
  11
  12 = "kipi" Plug-ins Support
  13 You may among other things find plug-ins for:
  14 - Writing images to cds or dvd's
  15 - Adjusting timestamps on your images
  16 - Making a calendar with your images in it
  17 - Uploading your images to flickr
  18 The plug-in library is called KIPI, and may be downloaded from the
  19 KIPI Home page (http://extragear.kde.org/apps/kipi)
  20
  21 = EXIF support
  22 Images store information like date image was shot, angle it was shot
  23 with, focal length, and shutter time in what is know as EXIF
  24 information.
  25
  26 KPhotoAlbum uses the EXIV2 library (http://freshmeat.net/projects/exiv2)
  27 for reading EXIF information from images.
  28
  29 = SQL Database Support
  30 KPhotoAlbum allows you to search using a certain number of EXIF
  31 tags. For this KPhotoAlbum needs a Sqlite database. Unfortunately, for
  32 this to work, you need to run Sqlite version 2.8.16, so please make
  33 sure that the right version is installed on your system.
  34 (you can get it from  http://www.sqlite.org/sqlite-2.8.16.tar.gz)
  35 You can use CPPFLAGS and LDFLAGS to direct configure to an alternative
  36 place for this version of sqlite
  37 e.g.
  38 > export CPPFLAGS="-I/.../sqlite2.8.16/include"
  39 > export LDFLAGS="-L/.../sqlite/2.8.16/lib"
  40 > ./configure ....
  41
  42 In addition the qt package for sqlite (e.g.qt-sql-sqlite) must be
  43 installed.
  44
  45 ========== Installation: ==========
  46
  47 To install KPhotoAlbum into your normal KDE setup, simply run
  48 ./configure
  49 make
  50 make install
  51
  52 If you want KPhotoAlbum placed in a different directories take the following
  53 steps. Below I assume /opt/KPhotoAlbum for your instalation direction, replace
  54 with your preference.
  55
  56 ./configure --prefix=/opt/KPhotoAlbum
  57 make
  58 make install
  59
  60 Next modify your ~/.bashrc, ~/.zshrc, or whatever to include this line:
  61 export KDEDIRS=/opt/KPhotoAlbum:$KDEDIRS
  62
  63 You can check the status of the different features using
  64 KPhotoAlbum Feature Status from the Help menu when running KPhotoAlbum.
  65
  66
  67 In case of problems, please refer to the README file for further instructions.
  68
  69 Kind Regards
  70 Jesper Pedersen <blackie@kde.org>