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

0001 .. meta::
0002    :description: The digiKam Tool to Send Images By Mail
0003    :keywords: digiKam, documentation, user manual, photo management, open source, free, learn, easy, email, sharing
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 .. _send_images:
0012 
0013 Send Images
0014 ===========
0015 
0016 .. contents::
0017 
0018 This tool can be used to send images directly by e-mail.
0019 
0020 With this tool you can e-mail the selected images with your favorite e-mail agent. Resizing images is possible. You can use drag and drop to add more images to the list of images to send.
0021 
0022 When opening the tool from the application, the **Email Images Options** dialog will appear with the e-mail agent applications detected on your system. You can also select the items to send by **Images** list or **albums** collection.
0023 
0024 .. figure:: images/send_images_agents.webp
0025     :alt:
0026     :align: center
0027 
0028     The Send Images E-mail Client Detection and Contents Selection
0029 
0030 With the Images list mode, you will show your pre-selected items from digiKam already in the list of the dialog.
0031 
0032 .. figure:: images/send_images_list.webp
0033     :alt:
0034     :align: center
0035 
0036     The Send Images Tool and Selected List of Items
0037 
0038 Below the image list there are five buttons. The two left buttons are used to move a selected image in the list up or down. The middle button opens a file browser to add more files as needed in the usual file selection manner.
0039 
0040 When clicking on the other buttons the selected images will be removed from the list or the list will be cleared. 
0041 
0042 .. tip::
0043 
0044     You can drag and drop images between the host application window and the image file list to add new items to e-mail.
0045 
0046 .. warning::
0047 
0048     Be sure not to overload your own or your addressees e-mail transmission limit; most providers limit the e-mail size to some megabytes of data. Use several e-mails if you want to send a lot of data. 
0049 
0050 The next page is used to change the settings of the images to be sent. These settings will be remembered when you close the tool until you change them.
0051 
0052 Select your favorite **Mail Program** from the drop-down menu.
0053 
0054 If you select **Attach a file with image properties from Application** the comments, rating, or tags included with the images will be merged to a text file and attached in the mail.
0055 
0056 The next three items allow you to set-up the image properties to be sent. To enable these options check **Adjust image properties**. First select an **Image size** suitable for your Internet connection speed and the target mailbox size.
0057 
0058 The **PNG** file format in the **Image format** drop-down menu is not well adapted to reduce photographic images file size, but is best suited for compressing lossless items like the TIFF file format. **PNG** must be used if you use dial-up speed Internet and you want to preserve the photo quality. Otherwise, **JPEG** is the recommended format.
0059 
0060 The **Image quality** can be chosen with the input box. 75% is the standard compression ratio for **JPEG** files. Setting compression to 100% will result in lossless compression at the cost of the largest file size. The difference in file size between 90% and 100% can be quite dramatic, whereas the gain in quality is minor. Very good quality is already obtained with 85% compression.
0061 
0062 .. note::
0063 
0064     If you choose JPEG as the Image file format and the original files were in JPEG format, the original Exif data included is preserved in e-mailed images.
0065 
0066 If you want to drop metadata, turn on **Remove all metadata** option.
0067 
0068 .. figure:: images/send_images_email.webp
0069     :alt:
0070     :align: center
0071 
0072     The Send Images Tool Mail Program Selection and Attachment Properties
0073 
0074 The next page will show a progress dialog given a feedback on the progress of your operation to prepare item before e-mailing. Press the **Cancel** button during this stage if you want to abort the process.
0075 
0076 When all jobs are completed, this dialog will not close automatically and you can consult the progress messages if any errors occurred during this stage. The mail agent will be started automatically at the end.
0077 
0078 .. figure:: images/send_images_progress.webp
0079     :alt:
0080     :align: center
0081 
0082     The Send Images Tool Post Processing Items to Send By Mail
0083 
0084 The composer window will be open with your favorite e-mail client. You just need to add the addressee and the subject. The selected images will be already be listed as attachments.
0085 
0086 .. figure:: images/send_images_thunderbird.webp
0087     :alt:
0088     :align: center
0089 
0090     The Items Post Processed and Ready to Send with Thunderbird Mail Agent
0091 
0092 When email is sent, you can **Close** the progress dialog to purge all temporary files.
0093