Warning, /documentation/digikam-doc/export_tools/box_export.rst is written in an unsupported language. File is not indexed.
0001 .. meta:: 0002 :description: digiKam Export to Box Web-Service 0003 :keywords: digiKam, documentation, user manual, photo management, open source, free, learn, easy, box, 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 .. _box_export: 0012 0013 Export To Box 0014 ============= 0015 0016 .. contents:: 0017 0018 This tool allows the user to upload photos to the Box web-service. 0019 0020 `Box <https://en.wikipedia.org/wiki/Box_(company)>`_ is a cloud-based content management, collaboration, and file sharing tools. The application allows users to store and manage files in an online folder system accessible from any device. Users can then comment on the files, share them, apply workflows, and implement security and governance policies. 0021 0022 The tool can be used to upload a selection of images from your collections to the remote Box server using the Internet. 0023 0024 When accessing the tool for the first time by the :menuselection:`Export --> Export to Box` :kbd:`Ctrl+Alt+Shift+B` 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 Box: 0025 0026 .. figure:: images/export_box_login.webp 0027 :alt: 0028 :align: center 0029 0030 The Box Login Dialog 0031 0032 After successful sign-up digiKam will be allowed to send photos to the Box website. You will be presented with the following page: 0033 0034 0035 .. figure:: images/export_box_authorize.webp 0036 :alt: 0037 :align: center 0038 0039 The Box Authorize Dialog 0040 0041 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 Box. 0042 0043 .. figure:: images/export_box_dialog.webp 0044 :alt: 0045 :align: center 0046 0047 The Box Export Tool Dialog 0048 0049 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. 0050 0051 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 Box web interface. 0052 0053 If the **Resize photos before uploading** option is selected, the photos will be resized before transferring to Box. 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. 0054 0055 .. figure:: images/export_box_progress.webp 0056 :alt: 0057 :align: center 0058 0059 The Box Export Uploading in Progress 0060 0061 Press **Start Upload** button to transfer items. You can click on the **Close** button to abort the uploading of photos. 0062 0063 Finally, you can view the uploaded photos by visiting the Box website. 0064 0065 .. figure:: images/export_box_stream.webp 0066 :alt: 0067 :align: center 0068 0069 The Box Online Account Displaying the Uploaded Contents