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
0005 .. metadata-placeholder
0007    :authors: - digiKam Team
0009    :license: see Credits and License page for details (https://docs.digikam.org/en/credits_license.html)
0011 .. _send_images:
0013 Send Images
0014 ===========
0016 .. contents::
0018 This tool can be used to send images directly by e-mail.
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.
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.
0024 .. figure:: images/send_images_agents.webp
0025     :alt:
0026     :align: center
0028     The Send Images E-mail Client Detection and Contents Selection
0030 With the Images list mode, you will show your pre-selected items from digiKam already in the list of the dialog.
0032 .. figure:: images/send_images_list.webp
0033     :alt:
0034     :align: center
0036     The Send Images Tool and Selected List of Items
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.
0040 When clicking on the other buttons the selected images will be removed from the list or the list will be cleared. 
0042 .. tip::
0044     You can drag and drop images between the host application window and the image file list to add new items to e-mail.
0046 .. warning::
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. 
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.
0052 Select your favorite **Mail Program** from the drop-down menu.
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.
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.
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.
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.
0062 .. note::
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.
0066 If you want to drop metadata, turn on **Remove all metadata** option.
0068 .. figure:: images/send_images_email.webp
0069     :alt:
0070     :align: center
0072     The Send Images Tool Mail Program Selection and Attachment Properties
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.
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.
0078 .. figure:: images/send_images_progress.webp
0079     :alt:
0080     :align: center
0082     The Send Images Tool Post Processing Items to Send By Mail
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.
0086 .. figure:: images/send_images_thunderbird.webp
0087     :alt:
0088     :align: center
0090     The Items Post Processed and Ready to Send with Thunderbird Mail Agent
0092 When email is sent, you can **Close** the progress dialog to purge all temporary files.