digikam-doc/export_tools/dropbox_export.rst

0001 .. meta::
0002    :description: digiKam Export to Dropbox Web-Service
0003    :keywords: digiKam, documentation, user manual, photo management, open source, free, learn, easy, dropbox, 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 .. _dropbox_export:
0012
0013 Export To Dropbox
0014 =================
0015
0016 .. contents::
0017
0018 This tool allows the user to upload photos to the Dropbox web-service.
0019
0020 `Dropbox <https://en.wikipedia.org/wiki/Dropbox>`_ is a file hosting service that offers cloud storage, file synchronization, personal cloud, and client software.
0021
0022 The tool can be used to upload a selections of images from your collection to the remote Dropbox server using the Internet.
0023
0024 When accessing the tool for the first time by the :menuselection:`Export --> Export to Dropbox` :kbd:`Ctrl+Alt+Shift+D` 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 Dropbox:
0025
0026 .. figure:: images/export_dropbox_login.webp
0027     :alt:
0028     :align: center
0029
0030     The Dropbox Login Dialog
0031
0032 After successful sign-up digiKam will be allowed to send photos to the Dropbox website. You will be presented with the following page:
0033
0034 .. figure:: images/export_dropbox_authorize.webp
0035     :alt:
0036     :align: center
0037
0038     The Dropbox 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 Dropbox.
0041
0042 .. figure:: images/export_dropbox_dialog.webp
0043     :alt:
0044     :align: center
0045
0046     The Dropbox Export Tool Dialog
0047
0048 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.
0049
0050 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 Dropbox web interface.
0051
0052 If the **Resize photos before uploading** option is selected, the photos will be resized before transferring to Dropbox. 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. With the **Upload original image file** option, the photo are transferred without modification.
0053
0054 .. figure:: images/export_dropbox_progress.webp
0055     :alt:
0056     :align: center
0057
0058     The Dropbox Export Uploading in Progress
0059
0060 Press **Start Upload** button to transfer items. You can click on the **Close** button to abort the uploading of photos.
0061
0062 Finally, you can view the uploaded photos by visiting the Dropbox website.
0063
0064 .. figure:: images/export_dropbox_stream.webp
0065     :alt:
0066     :align: center
0067
0068     The Dropbox Online Account Displaying the Uploaded Contents