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

0001 .. meta::
0002    :description: digiKam Main Window Albums View
0003    :keywords: digiKam, documentation, user manual, photo management, open source, free, learn, easy, album, properties, creating, moving
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 .. _albums_view:
0012 
0013 Albums View
0014 ===========
0015 
0016 .. contents::
0017 
0018 Overview
0019 --------
0020 
0021 .. |icon_collection| image:: images/mainwindow_icon_collection.webp
0022 
0023 .. figure:: images/mainwindow_albumsview.webp
0024     :alt:
0025     :align: center
0026 
0027     The digiKam Main Window Album-View
0028 
0029 By clicking the **Albums** button on the left side bar you toggle the Albums tree which provides an organized view of your photograph albums. The top item Albums just shows the **Welcome to digiKam** screen in the view area. The next level of the Albums tree shows your different Collections (marked by the icon |icon_collection|) or at least one if you haven't added one or more yet in the :menuselection:`Settings --> Configure digiKam...` and **Collections** section. Each Collection represents a folder branch on your hard disk, on removable media or on network shares and the next levels in the tree show the structure of those folders, here called **Albums**. The albums can be sorted by their folder layout on the hard disk, by the Category that has been set in the :ref:`Album Properties <managing_albums>` or by the Date of that Albums (this date can also be changed in the Properties of each Album). You can invert the sort order (ascending/descending) by clicking on the title bar of the album tree.
0030 
0031 You can switch between these sort orders using **Sort Albums** from the **View** menu. 
0032 
0033 .. _creating_album:
0034 
0035 Creating a New Album
0036 --------------------
0037 
0038 There are a number of ways to create a new Album. You can create a new Album when you upload new photographs from the Camera using :menuselection:`Import --> Cameras`. You can also create a new empty Album with :menuselection:`Album --> New...` :kbd:`Ctrl+N` in the Albums view. As an additional option, you can create a new Album by importing an existing folder of photographs from your computer; just select :menuselection:`Import --> Add Folders...` from the menu bar and select the folder that you want to import. An Album will be created with the same name as the hard disk folder. You can use drag and drop to import a folder. Drag a folder icon, for example from your preferred files-manager. Then drop it on the album list on the left. A menu will appear that gives you the option to move or copy the folder into digiKam.
0039 
0040 .. note::
0041 
0042     A album is hosted in a collection root path registered in the database. If a settings about collections has changed or if the collection no longer exists (for example with a removable media), no new albums can be created. You needs to check the collection properties in :ref:`the digiKam setup dialog <collections_settings>`.
0043 
0044 .. important::
0045 
0046     Under Windows, file locking used by the system can introduce time latencies or dysfunctions. digiKam uses a low level file management with Qt framework that cannot handle locked files. The following conditions must be met so that there are no problems with digiKam:
0047 
0048         - Album monitoring in digiKam must be deactivated. See the :ref:`Collection Settings <collections_settings>` for details.
0049         - Folders must not be part of a Windows file or network share.
0050         - Folders or pictures must not be open in other programs such as Explorer or similar.
0051 
0052 .. _deleting_album:
0053 
0054 Deleting an Album
0055 -----------------
0056 
0057 When you delete an Album from digiKam it will be moved into the internal Trash Can. As an option you could change this behavior, so that delete really will remove the Album and all of the photographs in it. This can be changed by selecting :menuselection:`Settings --> Configure digiKam...` and selecting the **Miscellaneous** page. At the top of this page are the settings that control what happens when a photograph is deleted. To delete an Album, click with the right mouse button over the Album in the Albums tree and select **Delete Album** from the context menu.
0058 
0059 .. _adding_photograph:
0060 
0061 Adding a Photograph to an Album
0062 -------------------------------
0063 
0064 Most of the time you will create new Albums and populate them with photographs directly from your camera using the Camera Tool. However, sometimes you may want to add a photograph that you already have on your computer to an existing Album. To add a photograph to an Album select :menuselection:`Import --> Add Images...` :kbd:`Alt+Shift+I` from the menu bar. Select a source folder from the dialog and click OK. An import window will open. Select the photographs that you want to add and choose **Download Selected** from the **Download** drop down menu. A dialog will open where you can choose the destination album. The photographs will be copied into the Album. **Download New** :kbd:`Ctrl+N` from the same menu will copy only those images which are not in the destination folder yet.
0065 
0066 Additionally, you can use drag and drop to import photographs. Drag the photographs icons, for example from your preferred file manager. Then drop it on the image list on the right hand side.
0067 
0068 If you have a scanner configured, you can also scan a photograph straight into an Album. Select menu entry :menuselection:`Import --> Import from Scanner...`.
0069 
0070 .. _moving_copying:
0071 
0072 Moving or Copying Photographs
0073 -----------------------------
0074 
0075 Between Albums
0076 ~~~~~~~~~~~~~~
0077 
0078 Simply drag the photograph and drop it on the destination Album to move or copy it from one Album to another. A menu will appear that gives you the option to **Move** or **Copy** the photograph. You can move or copy multiple photographs the same way, just select all the photographs that you want to move and drag them on to the destination Album. 
0079 
0080 With Other Applications
0081 ~~~~~~~~~~~~~~~~~~~~~~~
0082 
0083 The behavior will be the same as copying between albums, but the difference will depend on the target application where you paste items and on what information the target program takes from the clipboard. With a text editor, pasting input fields will host the path. A word processor that can also use images may take the URL and insert the image.
0084 
0085 .. _managing_albums:
0086 
0087 Managing Albums
0088 ---------------
0089 
0090 Album Properties can help you remember which kind of photographs are in an Album and can also help you to organize the Albums tree. To access the Album Properties, click with the right mouse button on an Album and select **Properties** :kbd:`Alt+Enter` from the context menu.
0091 
0092 .. figure:: images/mainwindow_albumproperties.webp
0093     :alt:
0094     :align: center
0095 
0096     The digiKam Album Properties Dialog
0097 
0098 The Album Properties dialog allows you to set:
0099 
0100     - The Album **Title**: Name of the Album, identical with the name of the folder on your hard disk. If you edit it here, the folder will also be renamed.
0101 
0102     - The Album **Category**: this is a way of grouping your Albums together by a common label. The Category you set will be used to order your albums when you select **By Category** from the drop down box in the tool bar or using :menuselection:`View --> Sort Albums --> By Category`. If you want to add and delete Category labels, choose from the menu entry :menuselection:`Settings --> Configure digiKam... --> Views page --> Categories tab`.
0103 
0104     - The **Caption** for the Album: Usually a short description of the content, but of course you are free to abuse it in any conceivable way. But beware: this will be shown in the banner at the top of the main Image Window ;-)
0105 
0106     - The Album **Date**: this will be used when you order your Albums by date using :menuselection:`View --> Sort Albums --> By Date`.
0107 
0108     - **Oldest**, **Average**, and **Newest** buttons: these will set the **Date** to the oldest, average or latest date of the images in that album. It will first try to calculate the average date of the images in the album based on the Exif-headers. If that fails it will fall back to the modification date of the files in that folder.
0109 
0110 .. _album_icon:
0111 
0112 Setting the Album Icon
0113 ----------------------
0114 
0115 digiKam displays the usual folder icon in the Albums list. You can choose one of your photographs instead. This may help you to remember what kind of photographs are contained in an Album.
0116 
0117 To select a photograph as the Album icon, click with the right mouse button on the photograph that you want to use as the Album icon and select **Set as Album Thumbnail** from the context menu. Additionally you can use drag and drop to set the Album icon. Drag the photographs icon from the thumbnail area and drop it on the currently selected Album in the Album list.
0118 
0119 .. note::
0120 
0121       An Album can only be in one Album Collection and Album Collections cannot be nested.
0122 
0123       digiKam also supports tagging individual photographs. Album Categories are different from photograph tagging because the Album Category applies to all the photographs in an Album rather than to individual photographs. You can use both Album Category and tagging to organize your photographs.