Warning, /documentation/digikam-doc/export_tools/piwigo_export.rst is written in an unsupported language. File is not indexed.
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