Difference between revisions of "Pictures"

From Official Kodi Wiki
Jump to: navigation, search
(Made it more generic in stead off Xbox specific)
(Updated for v18)
 
(44 intermediate revisions by 8 users not shown)
Line 1: Line 1:
{{XBMC wiki toc Inline}}
+
{{mininav}}
__NOEDITSECTION__
+
 
__TOC__
+
 
==About Pictures==
+
= Introduction =
:Pictures is an easy way to view your pictures. It allows you to view them as a slideshow with nice transition effects and even allows you to listen to your music while viewing your slideshow.
+
<section begin="intro" />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.<section end="intro" />
 +
 +
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: <ref>https://github.com/xbmc/xbmc/blob/0910789aa02300119f5ffd45ae0316620be1715f/xbmc/settings/AdvancedSettings.cpp#L387-L391</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
 +
|}
 +
 
 +
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>
 +
{|
 +
|-
 +
! style="width:50px;" | || style="width:50px;"| .arw ||  style="width:50px;"| .cr2 ||  style="width:50px;"| .dng || style="width:50px;"| .nef
 +
|}
 +
 
 +
The following '''Stereoscopic''' image files are supported: <ref>https://github.com/notspiff/imagedecoder.mpo/blob/master/imagedecoder.mpo/addon.xml.in#L11</ref>
 
{|
 
{|
| valign="top" |
+
|-
:For a list of features available for pictures see:
+
! style="width:50px;" | || style="width:50px;"| .mpo
*[[XBMC_Features_and_Supported_Formats/Codecs#Features_available_for_picture.2Fimage_viewing:|Features Available for Pictures]]
+
|}
:For a complete list of supported picture/image formats see:
+
 
*[[XBMC Features and Supported Formats/Codecs#Supported picture/image formats:|Supported File Formats]]
+
 
 +
 
 +
= 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|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 ==
 +
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:
 +
 
 +
# Enable the binary add-on '''libraw 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 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.
 +
 
 +
:<syntaxhighlight lang="xml" enclose="div">
 +
    <advancedsettings>
 +
    <pictureextensions>
 +
<add>.arw|.cr2|.dng|.nef</add>
 +
    </pictureextensions>   
 +
    </advancedsettings>
 +
</syntaxhighlight>
 +
 
 +
: '''''See: [[Advancedsettings.xml]]'''''
 +
 
 +
 
 +
 
 +
== Stereoscopic Format ==
 +
This requires the same procedure as per RAW formats above.
 +
 
 +
# 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.
 +
 
 +
:<syntaxhighlight lang="xml" enclose="div">
 +
    <advancedsettings>
 +
    <pictureextensions>
 +
<add>.mpo</add>
 +
    </pictureextensions>   
 +
    </advancedsettings>
 +
</syntaxhighlight>
 +
 
 +
: '''''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.
  
==Picture Control==
+
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.
*Once a Picture is selected / displayed, you can rotate it with the [[image:Btn_y.png]]-button on the Xbox-controller ('''Select''' on the ''XBOX DVD-Kit Remote Control'' or the '''R-key''' on a keyboard).<br>
+
<section begin="PictureKeyboard" />
*The ''' Black'''-button on the Xbox Controller ('''Info''' on the ''XBOX DVD-Kit Remote Control'' or '''O-key''' on the keyboard) will toggle ''Picture information'' on the picture being displayed (dimensions in pixels, filename and order in slideshow and more).<br>
+
{| class="mw-collapsible mw-collapsed wikitable"
*The '''right and left triggers''' on the Xbox-Controller ('''Skip+/-''' on the ''XBOX DVD-Kit Remote Control'' or '''left/right keys''' on the keyboard) will go to the next / previous picture in the Slideshow.<br><br>
+
! width="100px"| Keypress
 +
! width="400px"| Action on displayed image
 +
! width="400px"| Action on View Listing
 +
|-
 +
! {{keypress|0}} (zero)
 +
| Cancel zoom
 +
|
 +
|-
 +
! {{keypress|1}}-{{keypress|9}}
 +
| Zoom levels. 1= lowest zoom, 9= highest zoom
 +
|
 +
|-
 +
! {{keypress|c}}
 +
|
 +
| Context Menu
 +
|-
 +
! {{keypress|I}}
 +
| Image Information
 +
| Image Information + Image display
 +
|-
 +
! {{keypress|m}}
 +
|
 +
| Left Sideblade Menu
 +
|-
 +
! {{keypress|p}}
 +
| Start slideshow from currently displayed image
 +
| Start slideshow from currently focused image
 +
|-
 +
! {{keypress|r}}
 +
| Rotate image clockwise
 +
|
 +
|-
 +
! {{keypress|s}}
 +
| {{kodi}} Power Options menu
 +
| {{kodi}} Power Options menu
 +
|-
 +
! {{keypress|x}}
 +
| Exit Viewer or Exit Slideshow
 +
|
 +
|-
 +
! {{keypress|.}}
 +
| Next image
 +
|
 +
|-
 +
! {{keypress|,}}
 +
| Previous image
 
|
 
|
[[image:mypictures.jpg|right|360px]]
+
|-
 +
! {{keypress|right}}
 +
| Next image. If zoomed, then scrolls zoomed image right
 +
| Move to next image
 +
|-
 +
! {{keypress|left}}
 +
| Previous image. If zoomed, then scrolls zoomed image left
 +
| Move to previous image
 +
|-
 +
! {{keypress|up}}
 +
| If zoomed, then scrolls zoomed image up
 +
| Move up a row of images
 +
|-
 +
! {{keypress|down}}
 +
| If zoomed, then scrolls zoomed image down
 +
| Move down a row of images
 +
|-
 +
! {{keypress|home}}
 +
|
 +
| Jump to beginning of list
 +
|-
 +
! {{keypress|end}}
 +
|
 +
| Jump to end of list
 +
|-
 +
! {{keypress|Page Up}}
 +
|
 +
| Jump to next page of images
 +
|-
 +
! {{keypress|Page Down}}
 +
|
 +
| Jump to previous page of images
 
|}
 
|}
===Zooming in/out on Pictures===
+
<section end="PictureKeyboard" />
:This can be performed while viewing individual pictures or in a slideshow. While viewing press [[image:Btn_a.png]]-button on Xbox-controller to zoom in ('''0–9''' on remote or keyboard). To zoom out press [[image:Btn_x.png]]-button on Xbox-controller ('''0–9''' on ''XBOX DVD-Kit Remote Control'' or keyboard). Each successive press will zoom you in or out further by 1x (from 1x to 10x). While zoomed you can use the '''left thumbstick''' on Xbox-controller ('''arrow buttons''' on ''XBOX DVD-Kit Remote Control'' or keyboard) to scroll the edges of the picture.<br>
+
 
 +
 
 +
 
 +
== Slideshow ==
 +
<gallery mode="packed" widths="500px" heights="283px">
 +
File:Mypictures.jpg|
 +
</gallery>
 +
The slideshow can be activated using the keystroke detailed in the above table or from the '''''[[Basic_controls#Sideblade_Menu|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 the Player Settings page for Pictures, you have the ability to set the following options:
 +
*Display time of images during slideshow. The default setting is 5 seconds
 +
*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
 +
:'''''See: [[Settings/Player/Pictures]]'''''
 +
 
 +
 
 +
From the Media Settings page for Pictures, you have the ability to set the following options:
 +
*Show EXIF picture information
 +
*Automatically generate thumbnails
 +
*Show video files in listings.
 +
:'''''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.
 +
 
 +
 
 +
 
 +
== Background Music ==
 +
To create a slideshow with background music follow these steps:
 +
 
 +
# Navigate to Music, select and commence playing the required music.
 +
# 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
 +
 
 +
 
 +
 
 +
== 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]]'''''
 +
 
 +
 
 +
 
 +
= Comics =
 +
CBZ and CBR are comic book archive files. They are pictures stored in CBZ (a renamed ZIP-archive) or [[w:CBR|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 ==
 +
<dpl>
 +
category = Picture_add-ons
 +
notcategory = Outdated
 +
format  =
 +
</dpl>
  
:'''NOTE:''' If done during a slideshow, it will pause it until you stop pressing a button. If you are zoomed in during a slideshow and the picture changes it will not keep those setting from one picture to another.
 
  
==SlideShow==
 
:The SlideShow function will start a sequential slideshow of all the pictures in the current folder with some nice transition effects. You can enable/disable the transition effects in [[My Pictures Settings|Settings/Pictures/Slideshow]].
 
  
===Recursive SlideShow (R. SlideShow)===
+
== Screensavers ==
:This option will display a slideshow using all images in the current folder and all of its subfolders.
+
<dpl>
 +
category = Screensaver_add-ons
 +
notcategory = Outdated
 +
format  =  
 +
</dpl>
  
===Randomize===
 
:When selected, XBMC will display the slideshow in a random order.
 
  
===Playing Music with your SlideShow===
 
:In order to play music with your slideshow, simply start a music source (playlist, song, etc} and then start the slideshow. The music will play in the background.
 
  
==Sources for Pictures==
+
= References =
:Sources are an important aspect of Pictures. Setting sources allows you to easily access your picture collection.<br>
+
<references />
:XBMC gives you the ability to link to sources that are for example:
 
*On your computer (in a local network) or a [[NAS (Network Attached Storage)]] device/system, which supports [[Windows File Sharing (SMB/SAMBA/CIFS)|SMB]] file sharing;
 
*Stored directly on the hard drive of your Xbox, PC or Mac;
 
*On CDs/DVDs in the CD/DVD drive.
 
  
:'''Note:''' See main article [[Media Sources]] for a complete list of available sources.<br>
 
  
  
==Comics==
 
:CBZ and CBR are comic book archive files, they are pictures/image stored in CBZ (a renamed [http://en.wikipedia.org/wiki/ZIP_%28file_format%29 ZIP]-archive) or [http://en.wikipedia.org/wiki/CDisplay_RAR_Archived_Comic_Book_File CBR] (a renamed [http://en.wikipedia.org/wiki/Rar RAR]-archive) format. CBZ and CBR comic book archives are automatically parsed by XBMC (as long as the image-format is supported) so that you can view/read, browse and zoom the pictures it contains.
 
  
:You can create comic book archives yourself on your computer: Your images should use a compressed format such as JPEG or PNG. Then the easiest way is to copy all images into a new folder, name them properly, [http://en.wikipedia.org/wiki/ZIP_%28file_format%29 ZIP]/[http://en.wikipedia.org/wiki/Rar RAR] the folder, and rename it to *.cbz respectively *.cbr extension. Though not required, you should configure your ZIP/RAR tool to not compress the files, instead only use the "store" option, (this hardly increases the size of the final archive, but speeds up opening the archive a lot). Note that the preferred comic book archive is CBZ (ie. [http://en.wikipedia.org/wiki/ZIP_%28file_format%29 ZIP]) simple because ZIP tools (and libraries for those who which to create comic book archive readers themself) are more readily available.
 
  
==Thumbnails==
+
{{Top}}
:''See main article'': [[Thumbnails#Picture Thumbnails|Thumbnails]]
 
:A thumbnail will automatically be created for each picture when you enter a share or folder containing pictures under My Pictures. This process runs in the background and does not affect normal usage.
 
  
[[Category:User Interface]]
+
{{updated|18}}
[[category:Thumbnails]]
+
[[Category:FAQ]]
 +
[[Category:Index]]
 +
[[Category:Guides]]
 +
[[Category:Manual]]
 +
[[Category:Pictures]]
 +
[[Category:Karellen]]
 +
[[Category:General topics]]
 +
[[Category:First time user]]
 +
[[Category:Advanced topics]]
 +
[[Category:Troubleshooting]]
 +
[[Category:Quick Start Guide]]

Latest revision as of 03:33, 18 April 2019

Home icon grey.png   ▶ Pictures


1 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.


2 Supported Formats

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

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

The following RAW image files are supported: [2] [3]

.arw .cr2 .dng .nef

The following Stereoscopic image files are supported: [4]

.mpo


3 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.


3.1 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:

  1. Enable the binary add-on libraw image decoder located in Add-ons→My add-ons→Image decoder
  2. 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.
    <advancedsettings>
    	<pictureextensions>
			<add>.arw|.cr2|.dng|.nef</add>
	    </pictureextensions>    
    </advancedsettings>
See: Advancedsettings.xml


3.2 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. 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.
    <advancedsettings>
    	<pictureextensions>
			<add>.mpo</add>
	    </pictureextensions>    
    </advancedsettings>
See: Advancedsettings.xml


4 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



4.1 Slideshow

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 the Player Settings page for Pictures, you have the ability to set the following options:

  • Display time of images during slideshow. The default setting is 5 seconds
  • 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
See: Settings/Player/Pictures


From the Media Settings page for Pictures, you have the ability to set the following options:

  • Show EXIF picture information
  • Automatically generate thumbnails
  • Show video files in listings.
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.


4.2 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


4.3 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


5 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.


6 Add-ons

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


6.1 Pictures


6.2 Screensavers


7 References



Return to top