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

0001 .. meta::
0002    :description: digiKam Advanced Settings to Import From Digital Camera
0003    :keywords: digiKam, documentation, user manual, photo management, open source, free, learn, easy, import, camera, advanced, convert, rename, scripting
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 .. _advanced_import:
0012 
0013 Advanced Import Settings
0014 ========================
0015 
0016 .. contents::
0017 
0018 The **Settings** tab of the Right Sidebar in the Import Tool interface opens five sections with advanced options for the import processing.
0019 
0020 File Renaming Options
0021 ---------------------
0022 
0023 Cameras often do not use very meaningful filenames for photographs. The filenames are usually reused once the photographs have been deleted from the camera. This can lead to filename clashes if you download photographs from many shootings into the same Album. It can also be useful to include the date and time that an image was taken into the filename.
0024 
0025 .. figure:: images/camera_settings_files_rename.webp
0026     :alt:
0027     :align: center
0028 
0029     The Import Tool File Renames Advanced Settings
0030 
0031 If you select **Camera filenames** the image filenames will not be altered. But you have the option to change their case to **upper** or **lower** case with the **Change case to** drop down field. If you select **Customize** you will be able to put together a renaming pattern from the **Options** drop down menu. The **Modifier** drop down menu allows to customize each option appended to the renaming pattern.
0032 
0033 The file customize **Renaming Options** and **Modifier** possibilities are mostly the same than **Advanced Rename** tool available in **Main Window**. See the full description in :ref:`this section <renaming_photograph>` of this manual.
0034 
0035 .. important::
0036 
0037     With USB Mass Storage driver, the usage of **file metadata** setting during camera contents parsing influences the rules of file renaming operations. If :ref:`this option <camera_behavior>` is disabled, the file renaming features will be limited. Take a care that enabling this option will slow down the camera connection stage.
0038 
0039 The new filename that digiKam will use for the photographs when they are downloaded can be shown underneath the **Customize** settings. Changing item selection from the icon-view will update these information. The renaming settings will be remembered the next time you use the camera interface.
0040 
0041 .. caution::
0042 
0043     With gPhoto2 drivers, at the moment digiKam cannot read metadata of RAW files during the import. You might want to import the files while preserving camera filenames first and then rename them after the import using the rename function (:kbd:`F2`).
0044 
0045     Another solution will be to use instead a memory cards reader and the USB Mass Storage driver.
0046 
0047 .. _camera_autoalbums:
0048 
0049 Auto-Creation of Albums
0050 -----------------------
0051 
0052 .. figure:: images/camera_settings_auto_albums.webp
0053     :alt:
0054     :align: center
0055 
0056     The Import Tool Albums Auto-Creation Advanced Settings
0057 
0058 Check **Extension-based sub-albums** and digiKam will create subalbums based on the file extensions of the imported images in the target album. At stage to :ref:`download from your camera to your computer <camera_download>`, digiKam will open a dialog where you can choose the target album once you click one of the download options either from the toolbar or from the **Item** menu. If you want to create a new Album, into which you could download the photographs, click the **New Album** button. The new Album will be created as a sub-folder of the Album that is currently selected in the existing Album list. This means that if you do not want your new Album to be a sub-folder of an existing folder you must first select the collection where you want to create the new album. Collections are indicated on top level of album hierarchies.
0059 
0060 If your camera provides information about the date of the photograph's taking or, if you import from a USB device or a folder, the images contain Exif metadata with date/time information, digiKam can use this to automatically create subalbums in the target album during import. Subalbums names will be based on the image dates. All images which have the same date will be downloaded into the same subalbum if you check **Date-based sub-albums**. Not all cameras include this information. See the :ref:`sidebar Metadata section <camera_import>` for more detail about information your camera may have embedded in your photographs.
0061 
0062 Automatically Albums create **Date format** can be **ISO**, **Full text**, **Local Settings** (taken from your desktop settings), or **Custom**. For this last one, an option modifiers editor is available below with a help dialog to know all date format possibilities. On the bottom of this view, an annotation will warn about the custom Album date format validity.
0063 
0064 .. figure:: images/camera_auto_albums_helper_dialog.webp
0065     :alt:
0066     :align: center
0067 
0068     The Import Tool Albums Auto-Creation Helper Dialog
0069 
0070 .. _camera_onthefly:
0071 
0072 On the Fly Operations
0073 ---------------------
0074 
0075 .. figure:: images/camera_settings_on_the_fly.webp
0076     :alt:
0077     :align: center
0078 
0079     The Import Tool on the Fly Operations Advanced Settings
0080 
0081 This section of the Settings tab offers several options for JPEG images. The **Template** drop-down field lets you choose one of your metadata templates you customized in :ref:`Templates Settings <templates_settings>`. You can access the **Template Manager** also with the edit button to the right of the drop-down field.
0082 
0083 **Write the document name to Exif** and **Fix internal date and time** writes this information into the respective Exif tags and XMP fields.
0084 
0085 If you check the next box digiKam will perform the auto-rotate/flip action described in :ref:`Lossless Image Rotation <lossless_rotation>`.
0086 
0087 **Convert to lossless file format** allows you to convert the images to PNG, TIFF, PGF, HEIF, WEBP, AVIF, or JPEG 2000 during import. To know more about these file formats, see :ref:`this section <image_formats>` from the manual.
0088 
0089 .. _camera_dngconvert:
0090 
0091 DNG Convert Options
0092 -------------------
0093 
0094 .. figure:: images/camera_settings_dng_convert.webp
0095     :alt:
0096     :align: center
0097 
0098     The Import Tool DNG Convert Advanced Settings
0099 
0100 This section allows to enable the DNG conversion of RAW images by checking **Convert RAW images to DNG** container and to select options for that conversion. To learn more about Digital Negative (DNG) use the link `DNG container <https://en.wikipedia.org/wiki/Digital_Negative>`_.
0101 
0102 - **Embed original file**: Embeds the original RAW file into the DNG container.
0103 
0104 - **Lossless Compression**: Enables lossless compression. The difference between lossy and lossless compression is said to be practically indistinguishable with DNG.
0105 
0106 - **JPEG preview**: Choose whether you want a medium or full size JPEG preview to be embedded into the DNG container or none at all.
0107 
0108 .. _camera_scripting:
0109 
0110 Scripting
0111 ---------
0112 
0113 .. figure:: images/camera_settings_scripting.webp
0114     :alt:
0115     :align: center
0116 
0117     The Import Tool Scripting Advanced Settings
0118 
0119 This last section of the Settings tab offers to run scripts to manipulate the images during import. You can type the filename of the script into the input field or search for it using the **Browse** button. Check out the info button for additional expressions to customize the command line.
0120 
0121 .. figure:: images/camera_scripting_helper_dialog.webp
0122     :alt:
0123     :align: center
0124 
0125     The Import Tool Albums Scripting Helper Dialog
0126 
0127 Post-Processing and Metadata
0128 ----------------------------
0129 
0130 An important point to considerate is the post-processing stage after downloading from the camera. Due to limitations of camera drivers to handle items metadata from the devices, all renaming and album creating operations are preceded by a parse of files to get real information and pass all values to the dedicated modules to re-organize files before a database integration.
0131 
0132 So, only the current view of the import tool depends on the camera metadata settings, i.e. metadata viewer of the sidebar, date in the thumbnail, etc. After the download, all metadata operations are post-processed from the downloaded images. Therefore, there can be a difference between the import view information and the real metadata determined later and used to organize the import in your collections.