digikam-doc/export_tools/piwigo_export.rst

0001 .. meta::
0002    :description: digiKam Export to Piwigo Web-Service
0003    :keywords: digiKam, documentation, user manual, photo management, open source, free, learn, easy, piwigo, export
0004
0005 .. metadata-placeholder
0006
0007    :authors: - digiKam Team
0008
0009    :license: see Credits and License page for details (https://docs.digikam.org/en/credits_license.html)
0010
0011 .. _piwigo_export:
0012
0013 Export To Piwigo
0014 ====================
0015
0016 .. contents::
0017
0018 This tool allows the user to upload photos to the Piwigo web-service.
0019
0020 `Piwigo <https://en.wikipedia.org/wiki/Piwigo>`_ is a subscription-based image hosting website. The company also facilitates the sale of digital and print media for amateur and professional photographers.
0021
0022 The tool can be used to upload a selections of images from your collection to the remote Piwigo server using the Internet.
0023
0024 .. figure:: images/export_piwigo_selection.webp
0025     :alt:
0026     :align: center
0027
0028     The Selection of Item to Upload to Piwigo Web-Service
0029
0030 When accessing the tool by the :menuselection:`Export --> Export to Piwigo` menu entry or the icon from the **Tools** tab from Right Sidebar, the main tool dialog will appears:
0031
0032
0033 .. figure:: images/export_piwigo_dialog.webp
0034     :alt:
0035     :align: center
0036
0037     The Piwigo Export Tool Dialog
0038
0039 The first stage to export content is to obtaining a token which is used for authentication purposes. Press **Change Account** button and the following dialog will popup to log in to Piwigo:
0040
0041 .. figure:: images/export_piwigo_login.webp
0042     :alt:
0043     :align: center
0044
0045     The Piwigo Login Dialog
0046
0047 .. note::
0048
0049     If you have been already logged to a Piwigo web-service in a previous session, the tool will remember the settings and use it automatically.
0050
0051 After successful sign-up digiKam will be allowed to send photos to the Piwigo website. With the **Remote Album** view, you must select the online folder to store files to upload. You can **Reload** the list if online contents have been changed in Piwigo web interface.
0052
0053 By default, the tool proposes to export the currently selected items from the icon-view. The **+** Photos button can be used to append more items on the list.
0054
0055 If the **Resize photos before uploading** option is selected, the photos will be resized before transferring to Piwigo. The values will be read from the **JPEG quality**, **Maximum width** and **Maximum height** settings, which can be used to adjust the maximum sizes and the compression. The size calculation will be done so as to have the aspect ratio conserved.
0056
0057 .. figure:: images/export_piwigo_progress.webp
0058     :alt:
0059     :align: center
0060
0061     The Piwigo Export Uploading in Progress
0062
0063 Press **Start Upload** button to transfer items. You can click on the **Cancel** button from the progress dialog to abort the uploading of photos.
0064
0065 Finally, you can view the uploaded photos by visiting the Piwigo website.
0066
0067 .. figure:: images/export_piwigo_stream.webp
0068     :alt:
0069     :align: center
0070
0071     The Piwigo Online Account Displaying the Uploaded Contents