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

0001 .. meta::
0002    :description: The digiKam Video Slideshow
0003    :keywords: digiKam, documentation, user manual, photo management, open source, free, learn, easy, video, slideshow
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 .. _video_slideshow:
0012 
0013 Video Slideshow
0014 ===============
0015 
0016 The Video Slideshow tool allows creation a movie from a list of photos. The generated file can be played on a video player or a TV screen. Images are presented one by one with visual effects if you need them. This tool can also be used to create a time-lapse animation from shots taken with an intervalometer.
0017 
0018 Select the images that you want to encode as video and go to :menuselection:`Tools --> Create video slideshow` a wizard dialog will open up as below.
0019 
0020 .. figure:: images/video_slideshow_01.webp
0021     :alt:
0022     :align: center
0023 
0024     The Video Slideshow Wizard Welcome Page
0025 
0026 This page allows to select the contents to export: from current items selection, or from a list of albums. With the **Albums** selection mode you can generate a video slideshow from Albums contents. Just check the respective Albums displayed with hierarchical nesting. On the next three tabs **Tags**, **Searches**, and **Labels** you can refine your selection using tags, labels, or previous search results in digiKam.
0027 
0028 If you use the **Images** selection mode only the previous selection of items from Icon-View will be processed and listed on this page as a flat list.
0029 
0030 .. figure:: images/video_slideshow_02.webp
0031     :alt:
0032     :align: center
0033 
0034     The Video Slideshow Wizard Images Selection Page
0035 
0036 Pressing on **Next** button will display all the video settings to encode the slideshow. The parameters are listed below:
0037 
0038     - **Number of Frames by Image**: The number of frames generated of one image to encode in the video stream. This defined the time of one image will be present statically on screen. If you set an **Effect While Displaying Images**, this one will be rendered with this number of frames.
0039 
0040     - **Video Standard**: This is the video norm to use while encoding media, as **PAL - 25 FPS** or **NTSC - 29 FPS** (FPS: Frame Per Seconds).
0041 
0042     - **Video Type**: This is the video resolution to use while encoding media. Images are resized accordingly. Take care that high resolution will need more resources to encode and use more space on your disk.
0043 
0044     - **Video bit Rate**: This is the bandwidth used to encode video. A low value means poor quality, and a high value means good quality. Take care that high rate will needs more space on your disk.
0045 
0046     - **Video Codec**: This is the standard video encoding method to make the media.
0047 
0048     - **Effect While Displaying Image**: Select here the visual effects to apply on an image while **Number of Frames by Image**.
0049 
0050     - **Transition Between Images**: Select here the visual effect to apply as a transition outside the **Number of Frames by Image**.
0051 
0052 On the bottom of this view, the tool calculates the delay for each image on the screen including applied visual effects, and the total duration of the slideshow.
0053 
0054 .. figure:: images/video_slideshow_03.webp
0055     :alt:
0056     :align: center
0057 
0058     The Video Slideshow Wizard Video Settings Page
0059 
0060 Pressing on the **Next** button will display all the media container settings to host the encoded contents. The parameters are listed below:
0061 
0062     - **Media Container Format**: The file format container to host video media.
0063 
0064     - **Destination folder**: The directory on disk to store the video file.
0065 
0066     - **If Target File Exists**: Allows to overwrite or not video file if it already exists in the directory.
0067 
0068     - **Open in Player**: Allows to render video slideshow and end to encoding, with the digiKam internal player or the default desktop application.
0069 
0070 .. figure:: images/video_slideshow_04.webp
0071     :alt:
0072     :align: center
0073 
0074     The Video Slideshow Wizard Output Settings Page
0075 
0076 Pressing on the **Next** button will start the video encoding. This stage can take a while depending on the number of items to process and the delay to use for each image to generate as a video.
0077 
0078 .. figure:: images/video_slideshow_05.webp
0079     :alt:
0080     :align: center
0081 
0082     The Video Slideshow Wizard Generating Output File
0083 
0084 Finally, when encoding is done, a preview of the video file is displayed.
0085 
0086 .. figure:: images/video_slideshow_preview.webp
0087     :alt:
0088     :align: center
0089 
0090     The Video Slideshow Preview Displayed in digiKam Internal Player