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

0001 .. meta::
0002    :description: digiKam Export to OneDrive Web-Service
0003    :keywords: digiKam, documentation, user manual, photo management, open source, free, learn, easy, onedrive, 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 .. _one_drive:
0012 
0013 Export To OneDrive
0014 ==================
0015 
0016 .. contents::
0017 
0018 This tool allows the user to upload photos to the OneDrive web-service.
0019 
0020 `OneDrive <https://en.wikipedia.org/wiki/OneDrive>`_ is a file hosting service. It enables registered users to share and synchronize their files.
0021 
0022 The tool can be used to upload a selection of images from your collections to the remote OneDrive server using the Internet.
0023 
0024 .. important::
0025 
0026     OneDrive file storage is currently limited to host only files with a size lower than 4Mb.
0027 
0028 When accessing the tool for the first time by the :menuselection:`Export --> Export to OneDrive` :kbd:`Ctrl+Alt+Shift+O` 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 OneDrive:
0029 
0030 .. figure:: images/export_onedrive_login.webp
0031     :alt:
0032     :align: center
0033 
0034     The OneDrive Login Dialog
0035 
0036 After successful sign-up digiKam will be allowed to send photos to the OneDrive website.
0037 
0038 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 OneDrive.
0039 
0040 .. figure:: images/export_onedrive_dialog.webp
0041     :alt:
0042     :align: center
0043 
0044     The OneDrive Export Tool Dialog
0045 
0046 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.
0047 
0048 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 OneDrive web interface.
0049 
0050 If the **Resize photos before uploading** option is selected, the photos will be resized before transferring to OneDrive. 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.
0051 
0052 .. figure:: images/export_onedrive_progress.webp
0053     :alt:
0054     :align: center
0055 
0056     The OneDrive Export Uploading in Progress
0057 
0058 Press **Start Upload** button to transfer items. You can click on the **Close** button to abort the uploading of photos.
0059 
0060 Finally, you can view the uploaded photos by visiting the OneDrive website.
0061 
0062 .. figure:: images/export_onedrive_stream.webp
0063     :alt:
0064     :align: center
0065 
0066     The OneDrive Online Account Displaying the Uploaded Contents