Jump to content

KPhotoAlbum: Difference between revisions

From KDE UserBase Wiki
No edit summary
mNo edit summary
(36 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>
== Main features == <!--T:77-->
== Main features == <!--T:77-->


<!--T:62-->
[[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 23: 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}}
Line 43: Line 57:
* ''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 />


</translate>
<translate>
== Explore == <!--T:69-->
== Explore == <!--T:69-->


<!--T:3-->
<!--T:3-->
Explore KPhotoAlbum by the documentation or the 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:
* [https://www.kphotoalbum.org/ KPhotoAlbum's Homepage]
 
<!--T:90-->
* [https://www.kphotoalbum.org/user-support/3minutetour/ 3 minute tour]
* [https://www.kphotoalbum.org/user-support/3minutetour/ 3 minute tour]
* [[Special:myLanguage/KPhotoAlbum FAQ| Frequently Asked Questions]]
 
<!--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


===== Demo-mode =====
<!--T:93-->
''Demo-mode'' loads a number of already annotated stock images for you to browse and view, or to annotate yourself. All KPhotoAlbum functionalities are working.
* [[Special:myLanguage/KPhotoAlbum FAQ| Frequently Asked Questions]]
When in ''demo-mode'' shutting down KPhotoAlbum will allow you to retain or discard any changes you've made.
 
</translate>
 
<translate>
===== Demo-mode ===== <!--T:94-->


Starting KPhotoAlbum for the first time, it will offer to run in ''demo-mode''. <br />
<!--T:95-->
Other ways to start the ''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'':
<!--T:97-->
* 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>


==== ''Note'' ====
<translate>
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 />
==== ''Note'' ==== <!--T:100-->
 
<!--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 />
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:
KPhotoAlbum will run conveniently on most computers:
* will run conveniently on most 64-bit Linux distributions on most computers:
** PC's from 2015 or newer
** 8 Gb of RAM
* is built for KDE Plasma running on QT6, but will also run on other desktop environments, like
** XFCE
** Gnome


<!--T:104-->
* PC's from 2015 or newer, with
<!--T:105-->
* 8 Gb of RAM
<!--T:106-->
KPhotoAlbum will run on most 64-bit Linux distributions and desktop environments, like:
<!--T:107-->
* KDE Plasma (on QT6)
<!--T:108-->
* XFCE
<!--T:109-->
* 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 87: Line 146:
* perl
* perl
* ktextwidgets
* ktextwidgets
</translate>
<translate>


== Backstory == <!--T:64-->
== News about releases, fixes, improvements == <!--T:111-->


<!--T:65-->
<!--T:112-->
In 2003 Jesper PedersenJes<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. KimDaBa was renamed to KPhotoAlbum.
The team publish news about development at the KPhotoAlbum [https://www.kphotoalbum.org/news/ news blog].
</translate>


KPhotoAlbum version 2 in 2004 added the KDE Image Plugin Interface (KiPi<ref>https://en.wikipedia.org/wiki/KDE_Image_Plugin_Interface</ref>)<ref>[https://commits.kde.org/kphotoalbum/ef47dac30088a0a4485af7a33189948d699caf85 Commit add KiPi support]</ref>.
<translate>
In 2006, Tuomas Suutari a sponsored [google summer of code student], implemented a new sql based database.
<!--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>


<!--T:66-->
<!--T:130-->
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>
'''General info'''<br />
Please have a look at KDE's [https://community.kde.org/Get_Involved general information] about getting involved first.


<!--T:68-->
</translate>
In 2016, '''KPhotoAlbum''' was ported to qt5/kf5<ref>https://www.kphotoalbum.org/2016/11/05/0092/</ref>.
<translate>
<!--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>


<!--T:76-->
<!--T:132-->
In 2024, '''KPhotoAlbum''' was ported to qt6/kf6<ref>
'''Maintain documentation'''<br />
https://www.kphotoalbum.org/2024/12/07/kphotoalbum-6.0.0-released/</ref>.
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:2-->
<!--T:133-->
Stable releases are always announced on our [https://www.kphotoalbum.org/news/ news page].
Start [https://l10n.kde.org/docs/doc-primer/index.html here] to learn about maintaining manuals and other documents.
</translate>
<translate>


<!--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:62-->
<!--T:135-->
[[File:KPhotoAlbum_main_windows.png|500px|center]]
'''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:4-->
<translate>
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.
<!--T:71-->
 
== Directions ==
== Extending KPhotoAlbum == <!--T:11-->
Sources with more info on KPhotoAlbum, its license, KDE and much more:
</translate>
<translate>


<!--T:30-->
<!--T:136-->
* Patches and features awaiting approval or implementation - Please use [https://bugs.kde.org/ bugs.kde.org] for that.
* [https://kde.org/ KDE Community]
* Some useful scripts are shipped with KPhotoAlbum in the contrib directory.
 
=== Help develop KPhotoAlbum === <!--T:15-->
 
<!--T:16-->
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.
 
== Known Bugs and feature requests == <!--T:17-->
 
<!--T:18-->
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-->
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-->
 
<!--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 ==


== 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 introduced 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>

Revision as of 09:36, 24 July 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 one of the live versions of Neon to try out KPhotoAlbum without installing it:

  • 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

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 introduced new features, improvements and bug fixes.
Find more details on KPhotoAlbum's backstory on the KPhotoAlbum news page.