KPhotoAlbum: Difference between revisions

From KDE UserBase Wiki
(→‎GIT Branches: add jenkins link)
(Marked this version for translation)
 
(40 intermediate revisions by 10 users not shown)
Line 1: Line 1:
<languages />
<languages />
<translate>
<!--T:73-->
{{GrafBreadCrumbs|1=KPhotoAlbum}}
</translate>


{|class="tablecenter vertical-centered"
{|class="tablecenter vertical-centered"
|[[Image:Kphotoalbum_splash.png]] ||<translate> <!--T:1-->
|[[Image:Kphotoalbum_splash.png]] ||<translate> <!--T:1-->
'''KPhotoAlbum is a tool which you can use to easily sort your images. It provides many capabilities to make sorting and viewing images easy'''.<br /> </translate>
'''KPhotoAlbum is a image and video manager with focus on sorting your images and videos.'''<br /> </translate>
|}
|}
<translate>
<translate>
== History == <!--T:64-->
<!--T:65-->
The development of '''KPhotoAlbum''' started in 2003 with the name '''KimDaBa''' (for '''K''' '''im'''age '''Da'''ta '''Ba'''se) by Jesper Pedersen<ref>[https://commits.kde.org/kphotoalbum/d42ff3603a292741758024f58774585caef12e27 First commit]</ref>. '''KiPi''' support was added in 2004<ref>[https://commits.kde.org/kphotoalbum/ef47dac30088a0a4485af7a33189948d699caf85 Commit add KiPi support]</ref>. In 2006, Tuomas Suutari a sponsored [google summer of code student], implemented a new sql based database.
<!--T:66-->
In July 2007, '''KPhotoAlbum''' started to being ported to KDE 4<ref>https://www.kphotoalbum.org/2008/09/03/0052/ KDE 4 porting started of KPhotoAlbum</ref>. The porting finished in May 2009<ref>https://www.kphotoalbum.org/2009/06/12/0062/</ref>
<!--T:67-->
In 2014, an android version was released<ref>https://www.kphotoalbum.org/2015/03/18/0087/</ref>. A video of the android version is available in [https://www.youtube.com/watch?v=TxtD7BG61Ro youtube].
<!--T:68-->
In 2016, '''KPhotoAlbum''' was ported to qt5/kf5<ref>https://www.kphotoalbum.org/2016/11/05/0092/</ref>.
<!--T:2-->
<!--T:2-->
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.
Stable releases are always announced on our [https://www.kphotoalbum.org/news/ news page].
 
 
<!--T:62-->
[[File:KPhotoAlbum_main_windows.png|500px|center]]
 
== Getting started == <!--T:69-->


<!--T:3-->
<!--T:3-->
__TOC__
For an introduction, take the [https://www.kphotoalbum.org/user-support/3minutetour/ 3 minute KPhotoAlbum tour] or see the [https://www.kphotoalbum.org/documentation/videos/ Videos] at [https://www.kphotoalbum.org/ KPhotoAlbum's Homepage]. [[Special:myLanguage/KPhotoAlbum FAQ|FAQ]] have their own page. A KPhotoAlbum handbook is available as a [https://docs.kde.org/development/en/extragear-graphics/kphotoalbum/kphotoalbum.pdf PDF] and [https://docs.kde.org/development/en/extragear-graphics/kphotoalbum/index.html on-line version].
For an introduction, take the [http://kphotoalbum.org/index.php?page=3-minute-tour 3 minute KPhotoAlbum tour] or see the [http://kphotoalbum.org/index.php?page=videos Videos] at [http://kphotoalbum.org/ KPhotoAlbum's Homepage]. To learn more and view some screenshots read the [[Special:myLanguage/KPhotoAlbum FAQ|FAQ]].
 
<!--T:74-->
On first start select one and only one root folder of your files. See [[Special:myLanguage/KPhotoAlbum_FAQ#Can_I_organize_my_images_in_multiple_directories?|FAQ]] for more about root folder.  KPhotoAlbum saves its own files into this same folder. Config file might be in ''~.config/kphotoalbumrc''.


<!--T:4-->
<!--T:4-->
'''KPhotoAlbum''' supports all the normal image formats including raw
KPhotoAlbum supports all the normal image and video 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.
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 == <!--T:5-->
 
<!--T:6-->
There is a [http://www.kphotoalbum.org/index.php?page=3-minute-tour 3-minute Tour] and a set of [http://www.kphotoalbum.org/index.php?page=videos How-To videos] on the project site. A '''KPhotoAlbum''' handbook is also available as a [http://docs.kde.org/development/en/extragear-graphics/kphotoalbum/kphotoalbum.pdf PDF] and [http://docs.kde.org/development/en/extragear-graphics/kphotoalbum/index.html on-line version].


== Getting KPhotoAlbum == <!--T:7-->
== Getting KPhotoAlbum == <!--T:7-->


<!--T:8-->
<!--T:8-->
Source packages, binaries for various distros, and snapshots are available from [http://www.kphotoalbum.org/index.php?page=download the project Download page].
Source packages, binaries for various distros, and snapshots are available from [https://www.kphotoalbum.org/download/ the project Download page].


=== KPhotoAlbum on Live systems like Knoppix === <!--T:9-->
<!--T:63-->
{{Install|KPhotoAlbum}}


<!--T:10-->
<!--T:75-->
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 [[Special:myLanguage/KPhotoAlbum on Knoppix|KPhotoAlbum on Knoppix]].
There is a [https://www.kphotoalbum.org/2014/07/15/0085/ Android client of KPhotoAlbum]. It is not "a stand alone application, but rather a viewer for your existing database running on the desktop".


=== Building KPhotoAlbum === <!--T:31-->
=== KPhotoAlbum on Live systems === <!--T:9-->


<!--T:32-->
<!--T:10-->
Step-by-step guide to build KPhotoAlbum from source code on Debian or Ubuntu are available on page [[Special:myLanguage/Building KPhotoAlbum|Building KPhotoAlbum]].
KPhotoAlbum is available in [https://neon.kde.org/download Neon]:
* User Edition has the latest release
* Developer Edition (stable branch) has the ''5.x'' branch.<br/>Most of the time, this should be the same as unstable, but when new features are developed they only arrive in stable after the roughest edges have been smoothed out.
* Developer Edition (unstable branch) has the ''master'' branch of kphotoalbum.


== Extending KPhotoAlbum == <!--T:11-->
== Extending KPhotoAlbum == <!--T:11-->
<!--T:12-->
* '''Image::Kimdaba''' is a perl module available on [http://cpan.org CPAN] which parses the ''index.xml'' database.
**  [http://search.cpan.org/~jmfayard/Image-Kimdaba/lib/Image/Kimdaba.pm Write your own extensions] to '''KPhotoAlbum'''
** Read [[Special:myLanguage/Image_Kimdaba|Image::Kimdaba]] to download it and to see available scripts
* Another way to extend '''KPhotoAlbum''' is to write [[Special:myLanguage/KIPI|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 [http://www.hardakers.net/kphotoalbum/#sec-5 Wes Hardaker's site]
* With [http://wersdoerfer.com/wicked/Kimdaba2Mysql 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 [http://wersdoerfer.com/bilder here]<br />


<!--T:30-->
<!--T:30-->
* Patches and features awaiting approval or implementation - Please use [https://bugs.kde.org/ bugs.kde.org] for that.
* Patches and features awaiting approval or implementation - Please use [https://bugs.kde.org/ bugs.kde.org] for that.
 
* Some useful scripts are shipped with KPhotoAlbum in the contrib directory.
 
 
<!--T:13-->
With [http://www.gowdy.us/pse3/ 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.
 
<!--T:14-->
[http://d200.vmrt.homelinux.com/|djKPA djKPA] is a [http://www.djangoproject.org Django] web site designed to be the web interface of your [http://www.kphotoalbum.org 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 === <!--T:15-->
=== Help develop KPhotoAlbum === <!--T:15-->


<!--T:16-->
<!--T:16-->
If you are interested in helping the '''KPhotoAlbum''' development or related projects, please look at  [http://www.kphotoalbum.org/index.php?page=getting-involved this project page]. Or, if you have an idea for a feature, please see the Feature Requests section, below.
If you are interested in helping the '''KPhotoAlbum''' development or related projects, please look at  [https://www.kphotoalbum.org/gettinginvolved/ this project page]. Or, if you have an idea for a feature, please see the Feature Requests section, below.
 
== Developer documentation == <!--T:33-->
=== KPA Release Steps ===
 
<!--T:45-->
* Update CMakeLists.txt with the new version number you are just about to tag (alas, our automatic versionning doesn't work anymore ;-)
* Update the ChangeLog to mark the new release and add the key improvements to the list of changes, if they are not already mentioned in the ChangeLog
* Update doc/index.docbook to reflect the new release (if the documentation has been updated)<br/>{{Input|1=<nowiki><releaseinfo>4.5</releaseinfo></nowiki>}}
* Commit the last changes<br/>{{Input|1=<nowiki>git commit -v -a</nowiki>}}
* Tag the new release and push it out<br/>{{Input|1=<nowiki>git tag -a -m "kpa 4.5 released" v4.5
git push
git push --tags</nowiki>}}
* Create a tar ball of the released sources using the instructions on the following section (''kphotoalbum.rb --version 4.5'')
* Upload the created tar ball to the <tt>incoming</tt> directory of upload.kde.org using an FTP client. The current instructions of notifying administrators of the upload are shown when logging in to the FTP server. You create a ticket and provide SHA sums and some other information of the upload.
* Add a new version to Bugzilla (bugs.kde.org, you have to have administrator rights to do this): ''Edit Products → KPhotoAlbum → Add version''
* Update the KPA web pages to point to proper source file, you get a link to the mirroring system as when the uploaded tar to KDE FTP server has been processed. The sources of the web page can be checked out from <tt>svn+ssh://[email protected]/home/kde/trunk/www/sites/kphotoalbum</tt> via svn.
* Publish the release information (KPA's web site, mailing lists, distributor's bugtracking system, social media etc.).
** Don't forget to post on the kde-distro-packagers mailing list, and make sure to mention any changes in dependencies.
** Update the latest version on top of this page.
* Create a video of the cool new features and publish it on Youtube. A nice tool for doing so is [http://recordmydesktop.sourceforge.net/ recordmydesktop]. If you uploaded such a video, don't forget to add it to the Videos page on the homepage (cf. the <tt>README_new_video.txt</tt> file).
* Notify people building the binary packages for different distributions
 
=== Building a Release === <!--T:26-->
 
<!--T:27-->
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.
 
<!--T:28-->
{{Input|1=<nowiki>git clone git://anongit.kde.org/releaseme
cd releaseme
git checkout kdelibs4</nowiki>}}
To create the source package, run e. g.:
{{Input|1=<nowiki>./kphotoalbum.rb --version `date +%Y%m%d`</nowiki>}}
If a source package for a specific tagged version should be built, use that version number instead, e. g.:
{{Input|1=<nowiki>./kphotoalbum.rb --version 4.6.2</nowiki>}}
 
=== GIT Branches ===
 
* ''master'' ([https://build.kde.org/job/kphotoalbum%20master%20kf5-qt5/PLATFORM=Linux,compiler=gcc build status])<br/>Current development branch
* ''4.7''<br/>Old stable (Qt4/Plasma4) branch. Only gets fixes for serious bugs on a case-by-case basis.
* ''5.x''<br/>Branch tracked by [https://community.kde.org/Neon/Builder#The_Packaging Neon/stable].<br/>When ''master'' is in stable condition, it should be synced to ''5.x'': {{Input|1=<nowiki>git checkout 5.x ; git merge master</nowiki>}}
* Feature branches are used in a very ad-hoc manner. If you are not a developer, don't bother with them.<br/>If you are a developer, try using descriptive names that are not likely to interfere with future branches.


== Known Bugs and feature requests == <!--T:17-->
== Known Bugs and feature requests == <!--T:17-->


<!--T:18-->
<!--T:18-->
See the list of [https://bugs.kde.org/enter_bug.cgi?product=kphotoalbum|Known Bugs] and workarounds in KPhotoAlbum.
See the list of [https://bugs.kde.org/buglist.cgi?bug_status=__open__&content=kphotoalbum&list_id=2567999&order=Importance&query_format=specific Known Bugs] and workarounds in KPhotoAlbum.


<!--T:20-->
<!--T:20-->
Please use [https://bugs.kde.org/enter_bug.cgi?product=kphotoalbum|bugs.kde.org] marking the report as a "Wish".
Please use [https://bugs.kde.org/enter_bug.cgi?product=kphotoalbum bugs.kde.org] marking the report as a "Wish".


=== New Ideas for Future Versions === <!--T:23-->
=== New Ideas for Future Versions === <!--T:23-->


<!--T:24-->
<!--T:24-->
If you have a new idea for KPhotoAlbum and think that [https://bugs.kde.org/ bugs.kde.org] is not the right place for it, use one of the [http://www.kphotoalbum.org/index.php?page=communication-media communication channels] listed on the pages.
If you have a new idea for KPhotoAlbum and think that [https://bugs.kde.org/ bugs.kde.org] is not the right place for it, use one of the [https://www.kphotoalbum.org/user-support/communication/ communication channels] listed on the pages.
 
== More Information == <!--T:70-->
 
<!--T:71-->
* [https://docs.kde.org/trunk5/en/extragear-graphics/kphotoalbum/index.html KDE official documentation]
* [https://www.kphotoalbum.org/ KPhotoAlbum homepage]
** [https://www.kphotoalbum.org/news KPhotoAlbum news]
* [https://apps.kde.org/kphotoalbum/ KPhotoAlbum on apps.kde.org]
* [https://en.wikipedia.org/wiki/KPhotoAlbum Wikipedia article]
* [https://phabricator.kde.org/project/view/255/ KPhotoAlbum phabricator project]
** [https://phabricator.kde.org/source/kphotoalbum/ KPhotoAlbum git repository]
 
== References == <!--T:72-->


<!--T:25-->
<!--T:25-->
[[Category:Graphics]]
[[Category:Graphics]]
</translate>
</translate>

Latest revision as of 09:29, 6 March 2024

Home » Applications » Graphics » KPhotoAlbum

KPhotoAlbum is a image and video manager with focus on sorting your images and videos.

History

The development of KPhotoAlbum started in 2003 with the name KimDaBa (for K image Data Base) by Jesper Pedersen[1]. KiPi support was added in 2004[2]. In 2006, Tuomas Suutari a sponsored [google summer of code student], implemented a new sql based database.

In July 2007, KPhotoAlbum started to being ported to KDE 4[3]. The porting finished in May 2009[4]

In 2014, an android version was released[5]. A video of the android version is available in youtube.

In 2016, KPhotoAlbum was ported to qt5/kf5[6].

Stable releases are always announced on our news page.


Getting started

For an introduction, take the 3 minute KPhotoAlbum tour or see the Videos at KPhotoAlbum's Homepage. FAQ have their own page. A KPhotoAlbum handbook is available as a PDF and on-line version.

On first start select one and only one root folder of your files. See FAQ for more about root folder. KPhotoAlbum saves its own files into this same folder. Config file might be in ~.config/kphotoalbumrc.

KPhotoAlbum supports all the normal image and video 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.

Getting KPhotoAlbum

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

Installation Instructions

If you need help to install KPhotoAlbum, look at this tutorial about how to install KDE software.


There is a Android client of KPhotoAlbum. It is not "a stand alone application, but rather a viewer for your existing database running on the desktop".

KPhotoAlbum on Live systems

KPhotoAlbum is available in Neon:

  • User Edition has the latest release
  • Developer Edition (stable branch) has the 5.x branch.
    Most of the time, this should be the same as unstable, but when new features are developed they only arrive in stable after the roughest edges have been smoothed out.
  • Developer Edition (unstable branch) has the master branch of kphotoalbum.

Extending KPhotoAlbum

  • Patches and features awaiting approval or implementation - Please use bugs.kde.org for that.
  • Some useful scripts are shipped with KPhotoAlbum in the contrib directory.

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.

Known Bugs and feature requests

See the list of Known Bugs and workarounds in KPhotoAlbum.

Please use bugs.kde.org 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.

More Information

References