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
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 .. _advanced_import:
0013 Advanced Import Settings
0014 ========================
0016 .. contents::
0018 The **Settings** tab of the Right Sidebar in the Import Tool interface opens five sections with advanced options for the import processing.
0020 File Renaming Options
0021 ---------------------
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.
0025 .. figure:: images/camera_settings_files_rename.webp
0026     :alt:
0027     :align: center
0029     The Import Tool File Renames Advanced Settings
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.
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.
0035 .. important::
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.
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.
0041 .. caution::
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`).
0045     Another solution will be to use instead a memory cards reader and the USB Mass Storage driver.
0047 .. _camera_autoalbums:
0049 Auto-Creation of Albums
0050 -----------------------
0052 .. figure:: images/camera_settings_auto_albums.webp
0053     :alt:
0054     :align: center
0056     The Import Tool Albums Auto-Creation Advanced Settings
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.
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.
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.
0064 .. figure:: images/camera_auto_albums_helper_dialog.webp
0065     :alt:
0066     :align: center
0068     The Import Tool Albums Auto-Creation Helper Dialog
0070 .. _camera_onthefly:
0072 On the Fly Operations
0073 ---------------------
0075 .. figure:: images/camera_settings_on_the_fly.webp
0076     :alt:
0077     :align: center
0079     The Import Tool on the Fly Operations Advanced Settings
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.
0083 **Write the document name to Exif** and **Fix internal date and time** writes this information into the respective Exif tags and XMP fields.
0085 If you check the next box digiKam will perform the auto-rotate/flip action described in :ref:`Lossless Image Rotation <lossless_rotation>`.
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.
0089 .. _camera_dngconvert:
0091 DNG Convert Options
0092 -------------------
0094 .. figure:: images/camera_settings_dng_convert.webp
0095     :alt:
0096     :align: center
0098     The Import Tool DNG Convert Advanced Settings
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>`_.
0102 - **Embed original file**: Embeds the original RAW file into the DNG container.
0104 - **Lossless Compression**: Enables lossless compression. The difference between lossy and lossless compression is said to be practically indistinguishable with DNG.
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.
0108 .. _camera_scripting:
0110 Scripting
0111 ---------
0113 .. figure:: images/camera_settings_scripting.webp
0114     :alt:
0115     :align: center
0117     The Import Tool Scripting Advanced Settings
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.
0121 .. figure:: images/camera_scripting_helper_dialog.webp
0122     :alt:
0123     :align: center
0125     The Import Tool Albums Scripting Helper Dialog
0127 Post-Processing and Metadata
0128 ----------------------------
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.
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.