Revision as of 19:59, 5 September 2009 by Claus chr (talk | contribs) (Added language navigation bar)(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff) Template:I18n/Language Navigation Bar Contents 1 General Description 2 Installation 3 Upgrade 4 Installation on Debian 5 Scripts coming with Image::Kimdaba 6 Synchronize comments between Kimdaba and Digikam 7 JAlbum gallery export 8 Auto-assign categoryimages 9 Really rotate your pictures 10 Export a hierarchy of symbolic links 11 Write your own General Description Image::Kimdaba is a Perl module available on CPAN for parsing the KPhotoAlbum database Installation Here we will assume that you want to install the module as a user, say in ''$HOME/local'' $ mkdir -p ~/local/bin $ perl -MCPAN -e shell Answer a bunch of question the first time. At some point, you have to enter: PREFIX=~/local Then, in the CPAN shell, type > install Image::Kimdaba You need to modify two environment variables: export PERL5LIB=~/local/lib/perl5/site_perl/5.8.3:~/local/lib/perl5/5.8.3 export PATH="$HOME/local/bin:$PATH" If everything is OK, it's now time to test if it works. Launch Kimdaba's demo (in the help menu) and run: $ kim_example.pl /tmp/kimdaba-demo-$USER Upgrade Thanks to the CPAN infrastructure, you only need to type: $ perl -MCPAN -e 'install Image::Kimdaba' Installation on Debian On Debian it's possible to automagically install Image::Kimdaba . Install first dh-make-perl, and then (as root) : # dh-make-perl --build --install --cpan Image::Kimdaba Scripts coming with Image::Kimdaba Note: The README file on CPAN may be moreup to date. Here we describe scripts already made that you may find useful. Synchronize comments between Kimdaba and Digikam The first time, do: $ ./kim_2_digikam <rootfolder> it will create the digikam.db database used by digikam (>= 0.7 and < 0.8 ) Launch kimdaba, do some changes, relaunch the script $ ./kim_2_digikam <rootfolder> it will update the digikam.db database (you have to restart digikam to see the changes, though) Add some categories in Digikam to some pictures and relaunch the script $ ./kim_2_digikam <rootfolder> Then you can import the modifications you made with Digikam by doing in Kimdaba: File -> import: /tmp/digikam_export.kim The good thing with synchronizing with digikam.db is that you can then use the "''digikamtags:/''" KIOSlave to browse by Persons/Keywords/Locations in every KDE app. (And add a tab "Kimdaba" => url=digikamtags:/ in Konqueror sidebar for example). JAlbum gallery export If you really like the many beautiful ways that JAlbum will let you display the images, but you are not willing to abandon KPhotoAlbum, use this script to duct tape your Kimdaba's comments to JAlbum. Download kim_jalbum.pl from http://thread.gmane.org/gmane.comp.kde.kimdaba/919 here] , and do: $ ./kim_jalbum.pl <rootfolder> Then download JAlbum and install it (Java required). You need to do some setup first: Tab main: Image directory: Kimdaba's root folder Output directory: Your album folder Tab advanced: Ignore pattern: \..*|ThumbNails|CategoryImages|index.xml Menu File -> Save as default JAlbum only allows you to make a gallery from one folder (and his subfolders) while KPhotoAlbum has nowhere this restriction. Here is a solution: In Kimdaba Eventually delete the 'jalbum' keyword to restart from scratch. Set the 'jalbum' keyword for each pictures you want to export. Save your changes In Konsole Create a directory with symlinks to your tagged pictures : $ kim_jalbum.pl ~/Images --exportdir ~/Syms/patou/ That's it, now use ~/Syms/patou/ as Image Directory Auto-assign categoryimages In Kimdaba's browser, you can see the list of the persons on your pictures by name, or by icons. In the viewer, you can assign an icon for a person of the pictures by Right click -> Show category editor, but it's a bit long if you have 500 persons. So this script will choose it for you. $ mkdir -p <rootfolder>/CategoryImages $ ./kim_category_images <rootfolder> It's faster than to set the 500 pictures by hand, isn't it? You can still use the category editor to choose a better picture for this person or that keyword, the script will not overwrite it. Really rotate your pictures In KPhotoAlbum, you can rotate pictures, but the pictures will not be really rotated, the rotation will only be stores in the index.xml database. To improve interoperability with other software, it's useful to really rotate. Quit Kimdaba and use this script (you need the jpegtran tool) $ ./kim_rotate.pl <rootfolder> Export a hierarchy of symbolic links (a bit proof-of-concept for Kimdaba.pm, but could be useful when using non kde apps (see kim_2_digikam )) Edit the first line of the script, then $ ./kim_2_filesystem <rootfolder> Write your own If you need to export your comments in another format, or you want to do some fun thing not available with Kimdaba and you know a bit of Perl, you can Write your own extension , it's very easy. If you feel the need, you can share your script with other people by editing this page and sending an email to the KPhotoAlbum's mailing-list. Retrieved from "https://userbase.kde.org/index.php?title=Image_Kimdaba&oldid=5161" Content is available under Creative Commons License SA 4.0 unless otherwise noted.