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.