Warning, /documentation/digikam-doc/export_tools/flickr_export.rst is written in an unsupported language. File is not indexed.

0001 .. meta::
0002    :description: digiKam Export to Flickr Web-Service
0003    :keywords: digiKam, documentation, user manual, photo management, open source, free, learn, easy, flickr, 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 .. _flickr_export:
0012 
0013 Export To Flickr
0014 ================
0015 
0016 .. contents::
0017 
0018 This tool allows the user to upload photos to the Flickr web service.
0019 
0020 `Flickr <https://en.wikipedia.org/wiki/Flickr>`_  is an online photo management application. Flickr is a way to get your photos to the people who matter to you. With Flickr you can show off your favorite photos to the world, blog the photos you take with a smartphone, and securely and privately show photos to your friends and family around the world.
0021 
0022 The tool can be used to upload a selection of images from your collections to the remote Flickr server using the Internet.
0023 
0024 When accessing the tool for the first time by the :menuselection:`Export --> Export to Flickr` :kbd:`Ctrl+Alt+Shift+R` menu entry, you are taken through the process of obtaining a token which is used for authentication purposes. The following dialog will popup and a browser window will be launched you will log in to Flickr:
0025 
0026 .. figure:: images/export_flickr_login.webp
0027     :alt:
0028     :align: center
0029 
0030     The Flickr Export Login Dialog
0031 
0032 After successful sign-up digiKam will be allowed to send photos to the Flickr website. You will be presented with the following page:
0033 
0034 .. figure:: images/export_flickr_authorize.webp
0035     :alt:
0036     :align: center
0037 
0038     The Flickr Export Authorize Dialog
0039 
0040 Then, simply authorize application and close the web browser. Return to the host application dialog, you will see the interface used to upload photos to Flickr.
0041 
0042 When the tool is invoked for second time or later you are greeted with the following dialog, which shows the current account already used previously. Just select one from the list to be connected.
0043 
0044 .. figure:: images/export_flickr_account.webp
0045     :alt:
0046     :align: center
0047 
0048     The Flickr Export Dialog to Select the Previously Registered Account
0049 
0050 The main upload dialog is shown below:
0051 
0052 .. figure:: images/export_flickr_dialog.webp
0053     :alt:
0054     :align: center
0055 
0056     The Flickr Export Tool Dialog
0057 
0058 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.
0059 
0060 With the **Album** options, you can select the online folder to store files to upload. You can **Create** new one and **Reload** the list on the combo-box if online contents have been changed in Flickr web interface.
0061 
0062 The **Tag options** section can be used to apply digiKam keywords to the flickr upload. More keywords can be assigned with a series of words (comma separated).
0063 
0064 The **Public**, **Friends**, and **Family** check-boxes can be turned on to assign appropriate access permissions to the images you upload. By default the images uploaded are private.
0065 
0066 If the **Resize photos before uploading** option is selected, the photos will be resized before transferring to Flickr. The values will be read from the **JPEG quality** and **Maximum Dimension** settings, which can be used to adjust the maximum height and the compression. The width calculation will be done so as to have the aspect ratio conserved.
0067 
0068 .. figure:: images/export_flickr_progress.webp
0069     :alt:
0070     :align: center
0071 
0072     The Flickr Export Uploading in Progress
0073 
0074 Press **Start Uploading** button to transfer items. You can click on the **Cancel** button to abort the uploading of photos.
0075 
0076 Finally, you can view the uploaded photos by visiting the Flickr website.
0077 
0078 .. figure:: images/export_flickr_stream.webp
0079     :alt:
0080     :align: center
0081 
0082     The Flickr Online Account Displaying the Uploaded Contents