Pictures: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
m (Updated for v19)
(Updated for v20)
 
Line 10: Line 10:


= Supported Formats =
= Supported Formats =
The following '''standard''' image file formats are supported: <ref>https://github.com/xbmc/xbmc/blob/0910789aa02300119f5ffd45ae0316620be1715f/xbmc/settings/AdvancedSettings.cpp#L387-L391</ref>
The following '''standard''' image file formats are supported: <ref>https://github.com/xbmc/xbmc/blob/master/xbmc/settings/AdvancedSettings.cpp#L435</ref>
{|
{|}
|-
|-
! style="width:50px;" | || style="width:50px;"| .apng ||  style="width:50px;"| .bmp ||  style="width:50px;"| .cbr || style="width:50px;"| .cbz || style="width:50px;"| .gif || style="width:50px;"| .ico || style="width:50px;"| .jp2 || style="width:50px;"| .jpg || style="width:50px;"| .jpeg || style="width:50px;"| .pcx || style="width:50px;"| .png || style="width:50px;"| .rss || style="width:50px;"| .tga || style="width:50px;"| .tif || style="width:50px;"| .tiff || style="width:50px;"| .webp || style="width:50px;"| .zip
! style="width:50px;" | || style="width:50px;"| .apng ||  style="width:50px;"| .bmp || style="width:50px;"| .cbz || style="width:50px;"| .gif || style="width:50px;"| .ico || style="width:50px;"| .jp2 || style="width:50px;"| .jpg || style="width:50px;"| .jpeg || style="width:50px;"| .pcx || style="width:50px;"| .png || style="width:50px;"| .rss || style="width:50px;"| .tga || style="width:50px;"| .tif || style="width:50px;"| .tiff || style="width:50px;"| .webp || style="width:50px;"| .zip
|}
|}


The following '''RAW''' image files are supported: <ref>https://github.com/notspiff/imagedecoder.raw/blob/master/imagedecoder.raw/addon.xml.in#L11</ref> <ref>Available RAW formats not yet supported by {{kodi}}: https://github.com/KDE/digikam/blob/master/core/libs/rawengine/rawfiles.h</ref>
The following '''RAW''' image files are supported: <ref>https://github.com/xbmc/imagedecoder.raw/blob/master/imagedecoder.raw/addon.xml.in#L11</ref>
{|
{|
|-
|-
Line 22: Line 22:
|}
|}


The following '''Stereoscopic''' image files are supported: <ref>https://github.com/notspiff/imagedecoder.mpo/blob/master/imagedecoder.mpo/addon.xml.in#L11</ref>
The following '''Stereoscopic''' image files are supported: <ref>https://github.com/xbmc/imagedecoder.mpo/blob/master/imagedecoder.mpo/addon.xml.in#L11</ref>
{|
{|
|-
|-
Line 38: Line 38:


== RAW Formats ==
== RAW Formats ==
Support for RAW image types has been reinstated and improved in v18. If you are adding Sources that contain RAW image types, then you must do the following to display them:
If adding Sources that contain RAW image types, the following steps are required:


# Enable the binary add-on '''libraw image decoder''' located in ''{{highlight|Add-ons→My add-ons→Image decoder}}''
# Enable the binary add-on '''[[Add-on:Libraw_image_decoder | libraw image decoder]]''' located in ''{{highlight|Add-ons→Install from repository→Image decoder}}''
# If the first step still does not display your RAW pictures, then make an entry in the advancedsettings.xml file to include the RAW file types you want {{kodi}} to display. If unsure, add the following code which will enable display of all four supported RAW formats. If you already have an advancedsettings.xml file, do not duplicate the ''<advancedsettings>'' tags.
# In the off chance the previous step still does not display your RAW pictures, add the following code to the advancedsettings.xml file. If you already have an advancedsettings.xml file, do not duplicate the ''<advancedsettings>'' tags.


:<syntaxhighlight lang="xml" enclose="div">
<syntaxhighlight lang="xml" enclose="div">
    <advancedsettings>
<advancedsettings>
    <pictureextensions>
<pictureextensions>
<add>.arw|.cr2|.dng|.nef</add>
<add>.arw|.cr2|.dng|.nef</add>
    </pictureextensions>     
<pictureextensions>     
    </advancedsettings>
</advancedsettings>
</syntaxhighlight>
</syntaxhighlight>


: '''''See: [[Advancedsettings.xml]]'''''
: '''''See: [[Advancedsettings.xml#Photos_settings | Advancedsettings.xml]]'''''




Line 59: Line 59:


# Enable the binary add-on '''MPO image decoder''' located in ''{{highlight|Add-ons→My add-ons→Image decoder}}''
# Enable the binary add-on '''MPO image decoder''' located in ''{{highlight|Add-ons→My add-ons→Image decoder}}''
# If the first step still does not display your RAW pictures, then make an entry in the advancedsettings.xml file to include the Stereoscopic file types you want {{kodi}} to display. If unsure, add the following code. If you already have an advancedsettings.xml file, do not duplicate the ''<advancedsettings>'' tags.
# In the off chance the previous step still does not display your steroscopic pictures, add the following code to the advancedsettings.xml file. If you already have an advancedsettings.xml file, do not duplicate the ''<advancedsettings>'' tags.


:<syntaxhighlight lang="xml" enclose="div">
<syntaxhighlight lang="xml" enclose="div">
    <advancedsettings>
<advancedsettings>
    <pictureextensions>
<pictureextensions>
<add>.mpo</add>
<add>.mpo</add>
    </pictureextensions>     
</pictureextensions>     
    </advancedsettings>
</advancedsettings>
</syntaxhighlight>
</syntaxhighlight>


: '''''See: [[Advancedsettings.xml]]'''''
: '''''See: [[Advancedsettings.xml#Photos_settings | Advancedsettings.xml]]'''''




Line 163: Line 163:


== Slideshow ==
== Slideshow ==
<gallery mode="packed" widths="500px" heights="283px">
<gallery mode="packed" widths="700px" heights="394px">
File:Mypictures.jpg|
File:Mypictures.jpg|
</gallery>
</gallery>
Line 180: Line 180:




From the Player Settings page for Pictures, you have the ability to set the following options:
From {{highlight|Settings►Player►Pictures}}, the following settings options are available:
*Display time of images during slideshow. The default setting is 5 seconds
* ''Amount of time to display each image'' - Display time of images during slideshow. The default setting is 5 seconds
*Enable or Disable slideshow Pan & Zoom effects. The default setting is ''Enabled''
* ''Use pan and zoom effects'' - Enable or Disable slideshow Pan & Zoom effects. The default setting is ''Enabled''
*Randomise slideshows by default. The default setting is disabled, and can be temporarily enabled for the current slideshow from the left sideblade menu
* ''Randomise'' - Randomise slideshows. The default setting is disabled, and can be temporarily enabled for the current slideshow from the left sideblade menu
* ''High quality downscaling'' - Enables high quality downscaling of images larger than the display resolution. May impact performance on low powered devices
:'''''See: [[Settings/Player/Pictures]]'''''
:'''''See: [[Settings/Player/Pictures]]'''''




From the Media Settings page for Pictures, you have the ability to set the following options:
From {{highlight|Settings►Media►Pictures}}, the following settings options are available:
*Show EXIF picture information
* ''Show EXIF picture information'' - Display data embedded in the image
*Automatically generate thumbnails
* ''Automatically generate thumbnails'' - Create thumbnails when in folder views
*Show video files in listings.
* ''Show video files in listings'' - If video files are mixed in with image files, these video files will also be displayed in listings
:'''''See: [[Settings/Media/Pictures]]'''''
:'''''See: [[Settings/Media/Pictures]]'''''
It is also possible to zoom images during a slideshow. When an image is zoomed, the slideshow will pause and will not continue until the zoom is cancelled.




Line 204: Line 202:
# Back out of the Music section to the main menu using the appropriate key on your remote or {{keypress|backspace}} on a keyboard
# Back out of the Music section to the main menu using the appropriate key on your remote or {{keypress|backspace}} on a keyboard
# Navigate to Pictures and commence the Slideshow
# Navigate to Pictures and commence the Slideshow
== Maps ==
If the pictures in the current listing contain valid Geo-Tagging information, it is possible to view the location of the image on a map. On first attempt to use this feature, you will be asked to install an add-on.
:'''''See: [[Add-on:Maps_Browser]]'''''




Line 227: Line 218:
== Pictures ==
== Pictures ==
<dpl>
<dpl>
category = Picture_add-ons
category = Nexus_add-on_repository
notcategory = Outdated
category = Picture_add-ons
format  =
notcategory = Outdated
</dpl>
</dpl>


Line 236: Line 227:
== Screensavers ==
== Screensavers ==
<dpl>
<dpl>
category = Screensaver_add-ons
category = Nexus_add-on_repository
notcategory = Outdated
category = Screensaver_add-ons
format  =
notcategory = Outdated
</dpl>
</dpl>


Line 251: Line 242:


{{Top}}
{{Top}}
{{updated|19}}
{{updated|20}}


[[Category:Pictures]]
[[Category:Pictures]]
[[Category:Karellen]]
[[Category:Karellen]]

Latest revision as of 01:49, 15 January 2023

Home icon grey.png   ▶ Pictures


Introduction

Pictures provides the ability to view your photos within Kodi. It has has the benefit of bringing togethar all your media- Video, Music, Photos - and making them accessible within the one location. View slideshows while playing music or read your comics on the big screen.

Pictures is a simple File Browser and viewer. Pictures does not use a database to store information, so currently lacks the feature set and versatility of the Video and Music Libraries, but it is on the Must-Do list for a future release.


Supported Formats

The following standard image file formats are supported: [1]

.apng .bmp .cbz .gif .ico .jp2 .jpg .jpeg .pcx .png .rss .tga .tif .tiff .webp .zip

The following RAW image files are supported: [2]

.arw .cr2 .dng .nef

The following Stereoscopic image files are supported: [3]

.mpo


Adding Pictures

Adding Sources for images is done in the exact same way as adding Sources for Video and Music.

If you need a reminder how to do this, see the guide Adding Video Sources. The only difference will be that you start in the Pictures menu and all mentions of Video will be replaced by Pictures.


RAW Formats

If adding Sources that contain RAW image types, the following steps are required:

  1. Enable the binary add-on libraw image decoder located in Add-ons→Install from repository→Image decoder
  2. In the off chance the previous step still does not display your RAW pictures, add the following code to the advancedsettings.xml file. If you already have an advancedsettings.xml file, do not duplicate the <advancedsettings> tags.
<advancedsettings>
	<pictureextensions>
		<add>.arw|.cr2|.dng|.nef</add>
	<pictureextensions>    
</advancedsettings>
See: Advancedsettings.xml


Stereoscopic Format

This requires the same procedure as per RAW formats above.

  1. Enable the binary add-on MPO image decoder located in Add-ons→My add-ons→Image decoder
  2. In the off chance the previous step still does not display your steroscopic pictures, add the following code to the advancedsettings.xml file. If you already have an advancedsettings.xml file, do not duplicate the <advancedsettings> tags.
<advancedsettings>
	<pictureextensions>
		<add>.mpo</add>
	</pictureextensions>    
</advancedsettings>
See: Advancedsettings.xml


Viewing Pictures

Once the Source(s) for Pictures are added, Kodi will cache the thumbnails the first time the picture list is viewed. This will make future loading of picture lists faster.

Select any picture to display it. Use left and right arrows to move back and forwards through the pictures. A list of keystrokes is listed below which will also reveal other functions.

Keypress Action on displayed image Action on View Listing
0 (zero) Cancel zoom
1-9 Zoom levels. 1= lowest zoom, 9= highest zoom
c Context Menu
I Image Information Image Information + Image display
m Left Sideblade Menu
p Start slideshow from currently displayed image Start slideshow from currently focused image
r Rotate image clockwise
s Kodi Power Options menu Kodi Power Options menu
x Exit Viewer or Exit Slideshow
. Next image
, Previous image
→ Next image. If zoomed, then scrolls zoomed image right Move to next image
← Previous image. If zoomed, then scrolls zoomed image left Move to previous image
↑ If zoomed, then scrolls zoomed image up Move up a row of images
↓ If zoomed, then scrolls zoomed image down Move down a row of images
home Jump to beginning of list
end Jump to end of list
Page Up Jump to next page of images
Page Down Jump to previous page of images



Slideshow

  • Mypictures.jpg

The slideshow can be activated using the keystroke detailed in the above table or from the Left Sideblade Menu.

Options available in the Left Sideblade menu are as follows:

View Slideshow
The slideshow will use the images displayed in the current listing
Recursive Slideshow
The slideshow will use the images displayed in the current listing and images in any sub-directories. This option becomes active only when sub-directories with valid images are detected.
Randomise
Will mix the order of the images in the slideshow. Can also be set for permanent randomize in the settings page detailed next.


From Settings►Player►Pictures, the following settings options are available:

  • Amount of time to display each image - Display time of images during slideshow. The default setting is 5 seconds
  • Use pan and zoom effects - Enable or Disable slideshow Pan & Zoom effects. The default setting is Enabled
  • Randomise - Randomise slideshows. The default setting is disabled, and can be temporarily enabled for the current slideshow from the left sideblade menu
  • High quality downscaling - Enables high quality downscaling of images larger than the display resolution. May impact performance on low powered devices
See: Settings/Player/Pictures


From Settings►Media►Pictures, the following settings options are available:

  • Show EXIF picture information - Display data embedded in the image
  • Automatically generate thumbnails - Create thumbnails when in folder views
  • Show video files in listings - If video files are mixed in with image files, these video files will also be displayed in listings
See: Settings/Media/Pictures


Background Music

To create a slideshow with background music follow these steps:

  1. Navigate to Music, select and commence playing the required music.
  2. Back out of the Music section to the main menu using the appropriate key on your remote or ← Backspace on a keyboard
  3. Navigate to Pictures and commence the Slideshow


Comics

CBZ and CBR are comic book archive files. They are pictures stored in CBZ (a renamed ZIP-archive) or CBR (a renamed RAR-archive) format. CBZ and CBR comic book archives are automatically parsed by Kodi (as long as the image-format is supported) so they can be read.

Comic book archives are easily created. Use a compressed image format such as JPEG or PNG. Rename images sequentially and copy all images into a new folder. ZIP/RAR the folder and change the extension to *.cbz or *.cbr respectively. To speed up access by Kodi, do not compress the ZIP/RAR file.


Add-ons

The following are lists for Picture and Screensaver add-ons available from the Official Kodi Repository.


Pictures


Screensavers


References

  1. ↑ https://github.com/xbmc/xbmc/blob/master/xbmc/settings/AdvancedSettings.cpp#L435
  2. ↑ https://github.com/xbmc/imagedecoder.raw/blob/master/imagedecoder.raw/addon.xml.in#L11
  3. ↑ https://github.com/xbmc/imagedecoder.mpo/blob/master/imagedecoder.mpo/addon.xml.in#L11



Return to top
Retrieved from "https://kodi.wiki/index.php?title=Pictures&oldid=243548"