Jump to content

KPhotoAlbum: Difference between revisions

From KDE UserBase Wiki
mNo edit summary
Remove mentions of different Neon versions - kphotoalbum is delivered as snap to Neon, which is always built from the git master branch
 
(31 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<languages />
<languages />
<translate>
<translate>
<!--T:73-->
<!--T:73-->
{{GrafBreadCrumbs|1=KPhotoAlbum}}
{{GrafBreadCrumbs|1=KPhotoAlbum}}
</translate>
</translate>
[[File:Kphotoalbum_splash.png|500px|center]]<br />
<translate>


{|class="tablecenter vertical-centered"
<!--T:1-->
|[[Image:Kphotoalbum_splash.png]] ||<translate> <!--T:1-->
'''Use KPhotoAlbum to catalogue, select, view and share images and videos.'''<br /><br />
'''Use KPhotoAlbum to catalogue, select, view and share images and videos.'''<br /><br />
'''KPhotoAlbum''' is software to catalogue images and videos, supporting customizable and extensive annotation.<br /> Within annotated collections '''KPhotoAlbum''' helps you to swiftly select individual images or subsets of images to view or share them.<br /> </translate>
'''KPhotoAlbum''' is software to catalogue images and videos, supporting customizable and extensive annotation.<br /> Within annotated collections '''KPhotoAlbum''' helps you to swiftly select individual images or subsets of images to view or share them.<br />
|}
</translate>


<translate>
<translate>
Line 16: Line 19:
<!--T:62-->
<!--T:62-->
[[File:KPhotoAlbum_main_windows.png|500px|center]]
[[File:KPhotoAlbum_main_windows.png|500px|center]]
</translate>


<translate>
<!--T:78-->
<!--T:78-->
* ''Catalogue'': annotate images and videos with any combination of labels, categories, date ranges and tokens
* ''Catalogue'': annotate images and videos with any combination of labels, categories, date ranges and tokens
Line 26: Line 31:
* ''Show and share'': show selected images in a slideshow, create HTML pages with them, or export them for others to import them
* ''Show and share'': show selected images in a slideshow, create HTML pages with them, or export them for others to import them


<!--T:4-->
KPhotoAlbum supports all the normal image and video formats including raw formats produced by most digital cameras and scanners. It is also possible to use the thumbnails embedded in raw images.
</translate>
<translate>
== Get and install == <!--T:81-->
== Get and install == <!--T:81-->


<!--T:82-->
<!--T:82-->
Source packages, binaries for various distributions, and snapshots are available at [https://www.kphotoalbum.org/download/ the project Download page].
Source packages, binaries for various distributions, and snapshots are available at [https://www.kphotoalbum.org/download/ the project Download page].
</translate>


<translate>
<!--T:83-->
<!--T:83-->
{{Install|KPhotoAlbum}}
{{Install|KPhotoAlbum}}


<!--T:84-->
<!--T:84-->
Use one of the live versions of [https://neon.kde.org/download Neon] to try out KPhotoAlbum without installing it:
Use [https://neon.kde.org/download KDE Neon] to try out the newest version of KPhotoAlbum. Neon contains the latest development version of KPhotoAlbum, built fresh from the source.


<!--T:85-->
</translate>
* ''Neon User Edition'': contains KPhotoAlbum's latest end user release.<br />This version should not contain any bugs. If, however, you do find bugs, please [https://bugs.kde.org/enter_bug.cgi?product=kphotoalbum report] them.<br />


<!--T:86-->
<translate>
* ''Neon Developer Edition (stable branch)'': contains a development version of KPhotoAlbum.<br />New features arrive in stable only after possible bugs have been removed.<br />Using this version you ''may'' find bugs. If so, please [https://bugs.kde.org/enter_bug.cgi?product=kphotoalbum report] them.<br />
 
<!--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 />


== Explore == <!--T:69-->
== Explore == <!--T:69-->
Line 51: Line 57:
Explore KPhotoAlbum by reading the ''documentation'' or by starting KPhotoAlbum in ''demo-mode''.
Explore KPhotoAlbum by reading the ''documentation'' or by starting KPhotoAlbum in ''demo-mode''.


===== Documentation =====
===== Documentation ===== <!--T:88-->
 
<!--T:89-->
Several types of documentation exist:
Several types of documentation exist:
<!--T:90-->
* [https://www.kphotoalbum.org/user-support/3minutetour/ 3 minute tour]
* [https://www.kphotoalbum.org/user-support/3minutetour/ 3 minute tour]
<!--T:91-->
* [https://docs.kde.org/development/en/extragear-graphics/kphotoalbum/index.html on-line] handbook
* [https://docs.kde.org/development/en/extragear-graphics/kphotoalbum/index.html on-line] handbook
<!--T:92-->
* [https://docs.kde.org/development/en/extragear-graphics/kphotoalbum/kphotoalbum.pdf PDF] handbook
* [https://docs.kde.org/development/en/extragear-graphics/kphotoalbum/kphotoalbum.pdf PDF] handbook
<!--T:93-->
* [[Special:myLanguage/KPhotoAlbum FAQ| Frequently Asked Questions]]
* [[Special:myLanguage/KPhotoAlbum FAQ| Frequently Asked Questions]]


===== Demo-mode =====
</translate>
 
<translate>
===== Demo-mode ===== <!--T:94-->
 
<!--T:95-->
''Demo-mode'' loads a number of already annotated stock images for you to browse and view, and to annotate yourself. All KPhotoAlbum functionalities are working. Shutting down KPhotoAlbum you may retain or discard any changes you've made during ''demo-mode''.
''Demo-mode'' loads a number of already annotated stock images for you to browse and view, and to annotate yourself. All KPhotoAlbum functionalities are working. Shutting down KPhotoAlbum you may retain or discard any changes you've made during ''demo-mode''.


<!--T:96-->
Start ''demo-mode'':
Start ''demo-mode'':
<!--T:97-->
* At first start accept KPhotoAlbum's offer to run in ''demo-mode''.
* At first start accept KPhotoAlbum's offer to run in ''demo-mode''.
<!--T:98-->
* In KPhotoAlbum click ''Help'', then ''Run KPhotoAlbum demo''
* In KPhotoAlbum click ''Help'', then ''Run KPhotoAlbum demo''
<!--T:99-->
* Start KPhotoAlbum with the ''--demo'' switch on the commandline.
* Start KPhotoAlbum with the ''--demo'' switch on the commandline.
</translate>
<translate>
==== ''Note'' ==== <!--T:100-->


==== ''Note'' ====
<!--T:101-->
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 />
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.
See [[Special:myLanguage/KPhotoAlbum_FAQ#Can_I_organize_my_images_in_multiple_directories?|FAQ]] for more information.
</translate>
<translate>
== Requirements == <!--T:102-->


== Requirements ==
<!--T:103-->
KPhotoAlbum will run conveniently on most computers:
KPhotoAlbum will run conveniently on most computers:
<!--T:104-->
* PC's from 2015 or newer, with
* PC's from 2015 or newer, with
<!--T:105-->
* 8 Gb of RAM
* 8 Gb of RAM


<!--T:106-->
KPhotoAlbum will run on most 64-bit Linux distributions and desktop environments, like:
KPhotoAlbum will run on most 64-bit Linux distributions and desktop environments, like:
<!--T:107-->
* KDE Plasma (on QT6)
* KDE Plasma (on QT6)
<!--T:108-->
* XFCE
* XFCE
<!--T:109-->
* Gnome
* Gnome


<!--T:110-->
<br />
<br />
Required dependencies will normally be installed by the package manager during installation:
Required dependencies will normally be installed by the package manager during installation:
<!--T:128-->
* libkdcraw
* libkdcraw
* marble-common
* marble-common
Line 88: Line 138:
* perl
* perl
* ktextwidgets
* ktextwidgets
</translate>
<translate>


== Backstory<ref>This overview is based on the KPhotoAlbum News-pages: https://www.kphotoalbum.org/news/</ref> == <!--T:64-->
== News about releases, fixes, improvements == <!--T:111-->


In 2003 Jesper Pedersen<ref>[https://commits.kde.org/kphotoalbum/d42ff3603a292741758024f58774585caef12e27 First commit]</ref> started working on KimDaBa ('''K''' '''im'''age '''Da'''ta '''Ba'''se) as a personal project. By version 2 KimDaBa was renamed to KPhotoAlbum.<br />
<!--T:112-->
In 2004 a KPhotoAlbum wiki was introduced, and Marc Cramdal helped improve the KPhotoAlbum website. <br />
The team publish news about development at the KPhotoAlbum [https://www.kphotoalbum.org/news/ news blog].
Also in 2004 Jesper incorporated  the very handy date-bar into KPhotoAlbum.<br />
</translate>
Another handy functionality was introduced in 2005: search for EXIF attributes.<br />
In 2006 the domain https://www.kphotoalbum.org/ was launched, containing the KPhotoAlbum home-page. That same year the all-important annotation dialogue got many valuable improvements.<br />
By 2007 KPhotoAlbum (Version 3.0) had been translated into 13 languages.<br />
In 2008 Jesper had gained the help of three other developers.<br />
As of 2008 KPhotoAlbum had evolved into a modern photo-management application, and a steady series of releases introduced new features, improvements and bug fixes.<br />
By 2015 git activity showed that 11<ref>Andreas Neustifter, David Faure, Jesper K. Pedersen, Johannes Zarl-Zierl, Miika Turkia, Pino Toscano, Reimar Imhof, Robert Krawitz, Tobias Leupold, Yuri Chornoivan</ref> developers had been involved with the project. And throughout the following years many others helped out as well.<br />
In 2020 KPhotoAlbum got integrated better in the greater KDE community. The developers also worked on better Geolocation mapping.
In 2024 KPhotoAlbum's 6.0.0 was released.


<!--T:2-->
<translate>
Find more details on KPhotoAlbum's backstory on [https://www.kphotoalbum.org/news/ news page].
<!--T:129-->
== Contribute ==
KPhotoAlbum is a KDE-project run by volunteers. A lot of diverse skills are needed to run a software project like this. If you would like to help out, you are very welcome.  
</translate>
<translate>


== Extending KPhotoAlbum == <!--T:11-->
<!--T:130-->
'''General info'''<br />
Please have a look at KDE's [https://community.kde.org/Get_Involved general information] about getting involved first.


<!--T:30-->
</translate>
* Patches and features awaiting approval or implementation - Please use [https://bugs.kde.org/ bugs.kde.org] for that.
<translate>
* Some useful scripts are shipped with KPhotoAlbum in the contrib directory.
<!--T:131-->
'''Coding'''<br />
If you'd like to help coding have a look at our [https://www.kphotoalbum.org/get-involved/get-started/ "Get involved"] site, and our [https://phabricator.kde.org/project/view/255/ our phabricator site] to get started.  
</translate>
<translate>


=== Help develop KPhotoAlbum === <!--T:15-->
<!--T:132-->
'''Maintain documentation'''<br />
If you'd like to help maintain our webpages the [https://wiki.kde.org/ KDE Wiki site] is a good place to start.<br />


<!--T:16-->
<!--T:133-->
If you are interested in helping the '''KPhotoAlbum''' development or related projects, please look at  [https://www.kphotoalbum.org/get-involved/get-started/ this project page]. Or, if you have an idea for a feature, please see the Feature Requests section, below.
Start [https://l10n.kde.org/docs/doc-primer/index.html here] to learn about maintaining manuals and other documents.
</translate>
<translate>


== Known Bugs and feature requests == <!--T:17-->
<!--T:134-->
If you feel uncertain about getting involved, please [https://www.kphotoalbum.org/user-support/communication/ ask] any questions you may have.
</translate>
<translate>


<!--T:18-->
<!--T:135-->
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.
'''Suggest improvements and ideas'''<br />
Please [https://bugs.kde.org report] your suggestions.<br />
You're also welcome to discuss your ideas with the team on one of the [https://www.kphotoalbum.org/user-support/communication/ communication channels].
</translate>


<!--T:20-->
<translate>
Please use [https://bugs.kde.org/enter_bug.cgi?product=kphotoalbum bugs.kde.org] marking the report as a "Wish".
<!--T:71-->
== Directions ==
Sources with more info on KPhotoAlbum, its license, KDE and much more:
</translate>
<translate>


=== New Ideas for Future Versions === <!--T:23-->
<!--T:136-->
 
* [https://kde.org/ KDE Community]
<!--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 [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://docs.kde.org/trunk5/en/extragear-graphics/kphotoalbum/index.html KDE official documentation]
* [https://www.kphotoalbum.org/ KPhotoAlbum homepage]
* [https://www.kphotoalbum.org/ KPhotoAlbum homepage]
** [https://www.kphotoalbum.org/news KPhotoAlbum news]
* [https://www.kphotoalbum.org/news KPhotoAlbum news]
* [https://apps.kde.org/kphotoalbum/ KPhotoAlbum on apps.kde.org]
* [https://apps.kde.org/kphotoalbum/ KPhotoAlbum on apps.kde.org]
* [https://en.wikipedia.org/wiki/KPhotoAlbum Wikipedia article]
* [https://en.wikipedia.org/wiki/KPhotoAlbum Wikipedia article]
* [https://phabricator.kde.org/project/view/255/ KPhotoAlbum phabricator project]
* [https://phabricator.kde.org/project/view/255/ KPhotoAlbum phabricator project]
** [https://phabricator.kde.org/source/kphotoalbum/ KPhotoAlbum git repository]
* [https://phabricator.kde.org/source/kphotoalbum/ KPhotoAlbum git repository]
</translate>
<translate>
 
== How it started == <!--T:137-->


== References == <!--T:72-->
<!--T:113-->
In 2003 Jesper Pedersen entered the [https://commits.kde.org/kphotoalbum/d42ff3603a292741758024f58774585caef12e27 first commit] of KimDaBa ('''K''' '''im'''age '''Da'''ta '''Ba'''se) which he had started as a personal project.<br />
By version 2 KimDaBa was renamed to KPhotoAlbum.<br />
Throughout the years KPhotoAlbum has evolved into a modern photo-management application, through a steady series of releases introducing new features, improvements and bug fixes.<br />
Find more details on KPhotoAlbum's backstory on the KPhotoAlbum [https://www.kphotoalbum.org/news/ news page].


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

Latest revision as of 17:29, 26 August 2025


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

KPhotoAlbum supports all the normal image and video formats including raw formats produced by most digital cameras and scanners. It is also possible to use the thumbnails embedded in raw images.

Get and install

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.


Use KDE Neon to try out the newest version of KPhotoAlbum. Neon contains the latest development version of KPhotoAlbum, built fresh from the source.


Explore

Explore KPhotoAlbum by reading the documentation or by starting KPhotoAlbum in demo-mode.

Documentation

Several types of documentation exist:


Demo-mode

Demo-mode loads a number of already annotated stock images for you to browse and view, and to annotate yourself. All KPhotoAlbum functionalities are working. Shutting down KPhotoAlbum you may retain or discard any changes you've made during demo-mode.

Start demo-mode:

  • At first start accept KPhotoAlbum's offer to run in 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.

Requirements

KPhotoAlbum will run conveniently on most computers:

  • PC's from 2015 or newer, with
  • 8 Gb of RAM

KPhotoAlbum will run on most 64-bit Linux distributions and desktop environments, like:

  • KDE Plasma (on QT6)
  • XFCE
  • Gnome


Required dependencies will normally be installed by the package manager during installation:

  • libkdcraw
  • marble-common
  • exiv2
  • purpose
  • perl
  • ktextwidgets

News about releases, fixes, improvements

The team publish news about development at the KPhotoAlbum news blog.

Contribute

KPhotoAlbum is a KDE-project run by volunteers. A lot of diverse skills are needed to run a software project like this. If you would like to help out, you are very welcome.

General info
Please have a look at KDE's general information about getting involved first.

Coding
If you'd like to help coding have a look at our "Get involved" site, and our our phabricator site to get started.

Maintain documentation
If you'd like to help maintain our webpages the KDE Wiki site is a good place to start.

Start here to learn about maintaining manuals and other documents.

If you feel uncertain about getting involved, please ask any questions you may have.

Suggest improvements and ideas
Please report your suggestions.
You're also welcome to discuss your ideas with the team on one of the communication channels.

Directions

Sources with more info on KPhotoAlbum, its license, KDE and much more:

How it started

In 2003 Jesper Pedersen entered the first commit of KimDaBa (K image Data Base) which he had started as a personal project.
By version 2 KimDaBa was renamed to KPhotoAlbum.
Throughout the years KPhotoAlbum has evolved into a modern photo-management application, through a steady series of releases introducing new features, improvements and bug fixes.
Find more details on KPhotoAlbum's backstory on the KPhotoAlbum news page.