Jump to content

KPhotoAlbum: Difference between revisions

From KDE UserBase Wiki
← Older editNewer edit →
Textual change
Added/updated the "Explore KPA" sections
Line 42: Line 42:
<!--T:87-->
<!--T:87-->
* ''Neon Developer Edition (unstable branch)'': contains the KPhotoAlbum version the developers are currently working on.<br />Using this version you ''will'' find bugs. Please [https://bugs.kde.org/enter_bug.cgi?product=kphotoalbum report] them.<br />
* ''Neon Developer Edition (unstable branch)'': contains the KPhotoAlbum version the developers are currently working on.<br />Using this version you ''will'' find bugs. Please [https://bugs.kde.org/enter_bug.cgi?product=kphotoalbum report] them.<br />
== Explore KPhotoAlbum == <!--T:69-->
<!--T:3-->
There are several ways to explore KPhotoAlbum.
===== Documentation =====
* the [https://www.kphotoalbum.org/ KPhotoAlbum's Homepage]
* the [https://www.kphotoalbum.org/user-support/3minutetour/ 3 minute tour]
* the [[Special:myLanguage/KPhotoAlbum FAQ| Frequently Asked Questions]]
* the [https://docs.kde.org/development/en/extragear-graphics/kphotoalbum/index.html on-line] handbook
* the [https://docs.kde.org/development/en/extragear-graphics/kphotoalbum/kphotoalbum.pdf PDF] handbook
===== Demo-mode =====
Starting KPhotoAlbum for the first time, it will offer to run in "demo-mode". <br />
Demo-mode loads a number of stock images for you to browse.
Other ways to start the demo-mode:
* In KPhotoAlbum click ''Help'', then ''Run KPhotoAlbum demo''
* Start KPhotoAlbum with the ''--demo'' switch on the commandline.
==== ''Note'' ====
If you choose to explore KPhotoAlbum using your own images, KPhotoAlbum will ask for the folder containing your images. Please note that KPhotoAlbum currently supports '''only one root folder''': it will find the images in this folder and any sub-folders it may contain.<br />
See [[Special:myLanguage/KPhotoAlbum_FAQ#Can_I_organize_my_images_in_multiple_directories?|FAQ]] for more information.


== History == <!--T:64-->
== History == <!--T:64-->
Line 64: Line 89:
<!--T:62-->
<!--T:62-->
[[File:KPhotoAlbum_main_windows.png|500px|center]]
[[File:KPhotoAlbum_main_windows.png|500px|center]]
== Getting started == <!--T:69-->
<!--T:3-->
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].
<!--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-->

Revision as of 07:13, 18 July 2025

Other languages:

Home » Applications » Graphics » KPhotoAlbum

Use KPhotoAlbum to catalogue, select, view and share images and videos.

KPhotoAlbum is software to catalogue images and videos, supporting customizable and extensive annotation.
Within annotated collections KPhotoAlbum helps you to swiftly select individual images or subsets of images to view or share them.

Main features

  • Catalogue: annotate images and videos with any combination of labels, categories, date ranges and tokens
  • Select and view: select images by any combination of labels, categories, date ranges and tokens and view the resulting subset
  • Show and share: show selected images in a slideshow, create HTML pages with them, or export them for others to import them

Get and install KPhotoAlbum

Source packages, binaries for various distributions, and snapshots are available at the project Download page.

Installation Instructions

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


To try out KPhotoAlbum without installing it try one of the live versions of Neon:

  • Neon User Edition: contains KPhotoAlbum's latest end user release.
    This version should not contain any bugs. If, however, you do find bugs, please report them.
  • Neon Developer Edition (stable branch): contains a development version of KPhotoAlbum.
    New features arrive in stable only after possible bugs have been removed.
    Using this version you may find bugs. If so, please report them.
  • Neon Developer Edition (unstable branch): contains the KPhotoAlbum version the developers are currently working on.
    Using this version you will find bugs. Please report them.

Explore KPhotoAlbum

There are several ways to explore KPhotoAlbum.

Documentation
Demo-mode

Starting KPhotoAlbum for the first time, it will offer to run in "demo-mode".
Demo-mode loads a number of stock images for you to browse.

Other ways to start the demo-mode:

  • In KPhotoAlbum click Help, then Run KPhotoAlbum demo
  • Start KPhotoAlbum with the --demo switch on the commandline.

Note

If you choose to explore KPhotoAlbum using your own images, KPhotoAlbum will ask for the folder containing your images. Please note that KPhotoAlbum currently supports only one root folder: it will find the images in this folder and any sub-folders it may contain.
See FAQ for more information.

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 2016, KPhotoAlbum was ported to qt5/kf5[5].

In 2024, KPhotoAlbum was ported to qt6/kf6[6].

Stable releases are always announced on our news page.


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.


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

  1. ↑ First commit
  2. ↑ Commit add KiPi support
  3. ↑ https://www.kphotoalbum.org/2008/09/03/0052/ KDE 4 porting started of KPhotoAlbum
  4. ↑ https://www.kphotoalbum.org/2009/06/12/0062/
  5. ↑ https://www.kphotoalbum.org/2016/11/05/0092/
  6. ↑ https://www.kphotoalbum.org/2024/12/07/kphotoalbum-6.0.0-released/
Retrieved from "https://userbase.kde.org/index.php?title=KPhotoAlbum&oldid=498113"