Warning, /documentation/digikam-doc/export_tools/twitter_export.rst is written in an unsupported language. File is not indexed.
0001 .. meta:: 0002 :description: digiKam Export to Twitter Web-Service 0003 :keywords: digiKam, documentation, user manual, photo management, open source, free, learn, easy, twitter, 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 .. _twitter_export: 0012 0013 Export To Twitter 0014 ================= 0015 0016 .. contents:: 0017 0018 This tool allows the user to upload photos to the Twitter social network. 0019 0020 `Twitter <https://en.wikipedia.org/wiki/Twitter>`_ is an online social media and social networking service. Users can send and respond publicly or privately texts, images and videos known as *tweets*. Publication are publicly visible by default, but senders can restrict message delivery to only their followers. Twitter supports photo-sharing service that enables users to upload a photo and attach it to a tweet. 0021 0022 The tool can be used to upload and tweet a selection of images from your collections to the remote Twitter server using the Internet. 0023 0024 When accessing the tool for the first time by the :menuselection:`Export --> Export to Twitter` 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 Twitter: 0025 0026 .. figure:: images/export_twitter_authorize.webp 0027 :alt: 0028 :align: center 0029 0030 The Twitter Authorize Dialog 0031 0032 After successful sign-up digiKam will be allowed to send photos to the Twitter website. You will be presented with the following page: 0033 0034 .. figure:: images/export_twitter_login.webp 0035 :alt: 0036 :align: center 0037 0038 The Twitter Login 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 Twitter. 0041 0042 .. figure:: images/export_twitter_dialog.webp 0043 :alt: 0044 :align: center 0045 0046 The Twitter 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 If the **Resize photos before uploading** option is selected, the photos will be resized before transferring to Twitter. 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_twitter_progress.webp 0053 :alt: 0054 :align: center 0055 0056 The Twitter 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 Twitter website. 0061 0062 .. figure:: images/export_twitter_stream.webp 0063 :alt: 0064 :align: center 0065 0066 The Twitter Online Account Displaying the Uploaded Contents